From f8349d460e998b3c86229e8f5e345fa52cba7f8a Mon Sep 17 00:00:00 2001 From: Juan Cruz Viotti Date: Mon, 31 Oct 2016 01:49:35 -0400 Subject: [PATCH] docs(GUI): explain why some drives are not bootable out of the box (#783) 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 08a7843d..cb0fbedc 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 ----------------------------------------------- @@ -199,3 +213,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