Add FAQ/common issues

README.md

@@ -30,3 +30,8 @@ You can support the development by sending a donation.
 
 - PayPal: https://paypal.me/DavideDepau
 - Monero: `82WTvrLEdTbULrcgcUnpuzevHaTMURHQfi4Sf5dG3WLjXzP8NwrfTL82HNdV8gnSN183TnLLsR5Q2YWcNJRriHvPPoweT1Q`
+
+## FAQ/Common issues
+
+[Link](https://etchdroid.depau.eu/faq)
+

docs/faq.md

@@ -0,0 +1,25 @@
+# EtchDroid FAQ
+
+### When I tap "Write DMG image", an empty file picker is shown
+
+That's because you don't have any DMG files on your phone. Download one and see if it shows up.
+
+### When I tap a USB drive from the list, the app hangs
+
+You tried to use the app but it crashed, then you ran it again without unplugging the USB drive. It hangs because as it crashed, it didn't get the chance to clean up the USB interface, so now it's in an inconsistent state. Reattach the USB drive and restart the app.
+
+### I'm getting this "Socket operation on non socket" error
+
+That happens for a number of reasons:
+
+- You unplugged your USB drive while it was being written to
+- Your USB drive is defective
+- Your USB OTG adapter is defective
+- You're using a USB hub
+- You're on Android 9 and recently changed your phone's language (yep!)
+
+The first 4 can be easily solved by replacing a component or just being careful not to unplug the USB drive while it's being worked on. The last one can be solved by rebooting your phone.
+
+### My issue is not listed here
+
+File it on GitHub: [link](https://github.com/Depau/EtchDroid/issues)

docs/index.md

@@ -32,3 +32,7 @@ You can support the development by sending a donation.
 
 - PayPal: https://paypal.me/DavideDepau
 - Monero: `82WTvrLEdTbULrcgcUnpuzevHaTMURHQfi4Sf5dG3WLjXzP8NwrfTL82HNdV8gnSN183TnLLsR5Q2YWcNJRriHvPPoweT1Q`
+
+## FAQ/Common issues
+
+[Link](https://etchdroid.depau.eu/faq)