documented prerequisites

devices/gt-i9295.md

@@ -1,5 +1,17 @@
 # Steps to flash microG LineageOS on Samsung Galaxy S4 Active
 
+## Prerequisites
+
+- A Samsung Galaxy S4 Active (make sure it says gt-i9295 in the "About Device" settings)
+- A computer (preferably Linux) with:
+  - an USB slot
+  - [adb](https://wiki.ubuntuusers.de/adb/) installed
+  - [heimdall-flash](https://wiki.ubuntuusers.de/Heimdall/) installed (on
+    Windows you can use [Odin](https://www.odinflash.com/))
+- A micro-USB cable which can transfer data
+
+## Preparations
+
 download latest TWRP image from https://eu.dl.twrp.me/jactivelte/
 
 download latest lineageOS from https://download.lineage.microg.org/jactivelte/
@@ -8,22 +20,20 @@ download latest Magisk.zip from https://github.com/topjohnwu/Magisk/releases
 
 ## Enable USB Debugging
 
-Attach phone to PC. Use a good micro USB cable; make sure that you can use it
+First, attach the phone to your PC. Use a good micro USB cable; make sure that you can use it
 to copy data.
 
 enable developer options
 
 enable USB debugging in developer options
 
-Insert a data cable to the device
-
 allow USB debugging access for your PC
 
 ## Flash Recovery
 
 Run `adb reboot bootloader`
 
-`heimdall flash --RECOVERY twrp-3.*jactivelte.img`
+`heimdall flash --RECOVERY twrp-3.*jactivelte.img --no-reboot`
 
 Now we don't want to boot into the system, we want into the new recovery
 directly - so turn off the phone with the power button, and then boot into
@@ -40,8 +50,11 @@ Then go to Wipe + Advanced Wipe to wipe the following partitions:
 * Cache
 * Dalvik
 
-Then go to Advanced/ADB Sideload, swipe to the right, and execute `adb sideload lineage-*jactivelte.zip` on your computer.
+Then go to Advanced/ADB Sideload, swipe to the right, and execute `adb sideload
-* When it shows something like `Total xfer: 1.00x` or `adb: failed to read command: Success` on the PC, and `Exit code: 1.000000` in TWRP, it has suceeded.
+lineage-*jactivelte.zip` on your computer.
+* When it shows something like `Total xfer: 1.00x` or `adb: failed to read
+  command: Success` on the PC, and `Exit code: 1.000000` in TWRP, it has
+  suceeded.
 
 Don't reboot yet, we still want to flash Magisk to root the phone.
 
@@ -127,6 +140,8 @@ Now, go to the Security settings again, and change your PIN to the password you
 want to use for the encryption. Unfortunately you can use maximally 17
 characters.
 
+Now reboot (maybe this step can be skipped, actually).
+
 Finally, you use adb again to restore the backup of the PIN, which changes your
 lockscreen PIN, but not your encryption passphrase:
 

devices/gt-i9505.md

@@ -1,5 +1,17 @@
 # Steps to flash microG LineageOS on Samsung Galaxy S4
 
+## Prerequisites
+
+- A Samsung Galaxy S4 (make sure it says GT-i9505 in the "About Device" settings)
+- A computer (preferably Linux) with:
+  - an USB slot
+  - [adb](https://wiki.ubuntuusers.de/adb/) installed
+  - [heimdall-flash](https://wiki.ubuntuusers.de/Heimdall/) installed (on
+    Windows you can use [Odin](https://www.odinflash.com/))
+- A micro-USB cable which can transfer data
+
+## Preparations
+
 download latest TWRP image from https://eu.dl.twrp.me/jflte/
 
 download latest lineageOS from https://download.lineage.microg.org/jfltexx/

devices/huashan.md

@@ -1,5 +1,17 @@
 # Steps to flash microG LineageOS on Sony Xperia SP
 
+## Prerequisites
+
+- A Sony Xperia SP (make sure it says `huashan` in the "About Device" settings)
+- A computer (preferably Linux) with:
+  - an USB slot
+  - [adb](https://wiki.ubuntuusers.de/adb/) installed
+  - [heimdall-flash](https://wiki.ubuntuusers.de/Heimdall/) installed (on
+    Windows you can use [Odin](https://www.odinflash.com/))
+- A micro-USB cable which can transfer data
+
+## Preparations
+
 download latest TWRP image from https://dl.twrp.me/huashan/
 
 download latest lineageOS from https://download.lineage.microg.org/huashan/

devices/sm-g900f.md

@@ -1,5 +1,17 @@
 # Steps to flash microG LineageOS on Samsung Galaxy S5
 
+## Prerequisites
+
+- A Samsung Galaxy S5 (make sure it says SM-G900F in the "About Device" settings)
+- A computer (preferably Linux) with:
+  - an USB slot
+  - [adb](https://wiki.ubuntuusers.de/adb/) installed
+  - [heimdall-flash](https://wiki.ubuntuusers.de/Heimdall/) installed (on
+    Windows you can use [Odin](https://www.odinflash.com/))
+- A micro-USB cable which can transfer data
+
+## Preparations
+
 download latest TWRP image from https://eu.dl.twrp.me/klte/
 
 download latest lineageOS from https://download.lineage.microg.org/klte/

devices/sm-g901f.md

@@ -1,5 +1,17 @@
 # Steps to flash microG LineageOS on Samsung Galaxy S5 Plus
 
+## Prerequisites
+
+- A Samsung Galaxy S5 Plus (make sure it says SM-G901F in the "About Device" settings)
+- A computer (preferably Linux) with:
+  - an USB slot
+  - [adb](https://wiki.ubuntuusers.de/adb/) installed
+  - [heimdall-flash](https://wiki.ubuntuusers.de/Heimdall/) installed (on
+    Windows you can use [Odin](https://www.odinflash.com/))
+- A micro-USB cable which can transfer data
+
+## Preparations
+
 download latest TWRP image from https://dl.twrp.me/kccat6/
 
 download latest lineageOS from https://download.lineage.microg.org/kccat6/

devices/sm-g903f.md

@@ -1,5 +1,17 @@
 # Steps to flash microG LineageOS on Samsung Galaxy S5 Plus
 
+## Prerequisites
+
+- A Samsung Galaxy S5 Plus (make sure it says SM-G903F in the "About Device" settings)
+- A computer (preferably Linux) with:
+  - an USB slot
+  - [adb](https://wiki.ubuntuusers.de/adb/) installed
+  - [heimdall-flash](https://wiki.ubuntuusers.de/Heimdall/) installed (on
+    Windows you can use [Odin](https://www.odinflash.com/))
+- A micro-USB cable which can transfer data
+
+## Preparations
+
 download latest TWRP image from https://eu.dl.twrp.me/s5neolte/
 
 download latest lineageOS from https://download.lineage.microg.org/s5neolte/

devices/sm-g955f.md

@@ -1,5 +1,17 @@
 # Steps to flash microG LineageOS on Samsung Galaxy S8+
 
+## Prerequisites
+
+- A Samsung Galaxy S8+ (make sure it says SM-G955F in the "About Device" settings)
+- A computer (preferably Linux) with:
+  - an USB slot
+  - [adb](https://wiki.ubuntuusers.de/adb/) installed
+  - [heimdall-flash](https://wiki.ubuntuusers.de/Heimdall/) installed (on
+    Windows you can use [Odin](https://www.odinflash.com/))
+- A micro-USB cable which can transfer data
+
+## Preparations
+
 download latest TWRP image from https://eu.dl.twrp.me/dream2lte/
 
 download latest lineageOS unofficial build from https://mega.nz/folder/NYpgFQCY#VYa2sKGXY83vEjOHZ-rIZg