From 18536702575e99d1ffb916ae698a92733e6593d1 Mon Sep 17 00:00:00 2001 From: Juan Cruz Viotti Date: Fri, 28 Oct 2016 11:38:44 -0400 Subject: [PATCH] docs(GUI): explain why some drives are not bootable out of the box The usual case is images requiring special treatment. We recommend the users to use specialised tooling for those cases. Signed-off-by: Juan Cruz Viotti --- docs/USER-DOCUMENTATION.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/USER-DOCUMENTATION.md b/docs/USER-DOCUMENTATION.md index d6fdaadc2a..f15ab133eb 100644 --- a/docs/USER-DOCUMENTATION.md +++ b/docs/USER-DOCUMENTATION.md @@ -3,6 +3,20 @@ Etcher User Documentation This document contains how-tos and FAQs oriented to Etcher users. +Why is my drive not bootable? +----------------------------- + +Etcher copies images to drives byte by byte, without doing any transformation +to the final device, which means images that require special treatment to be +made bootable, like Windows images, will not work out of the box. In these +cases, the general advice is to use software specific to those kind of +images, usually available from the image publishers themselves. + +Images known to require special treatment: + +- Microsoft Windows (use [Windows USB/DVD Download Tool][windows-usb-tool], or + [Rufus][rufus]). + Deactivate desktop shortcut prompt on GNU/Linux ----------------------------------------------- @@ -192,3 +206,5 @@ platforms. [electron]: http://electron.atom.io [electron-supported-platforms]: https://github.com/electron/electron/blob/master/docs/tutorial/supported-platforms.md [etcher-cli]: https://github.com/resin-io/etcher/blob/master/docs/CLI.md +[windows-usb-tool]: https://www.microsoft.com/en-us/download/windows-usb-dvd-download-tool +[rufus]: https://rufus.akeo.ie