ACXgit
commented
9 years ago Good beginning! Some notes:
- I like the suggested idea of including the specific and detailed instructions for downloading and extracting for every OS, so we can take that part off from the quick start guide (https://github.com/Fishstixx/Docs/blob/12ad40172da5281e74b9023ddf4eddf33af37a10/docs/quick-start/quick-start-guide.md#download-and-extract) and split it across the 3 specific SD card setup instructions.
- USB Image Tool allows to write .img.gz files directly, without extracting them previously. You have to choose that from the select in the bottom right corner of the window. As we distribute the images in that format it's worth to mention it, and leave the extracting instructions for the Win32DiskImager case (we have to cover that too)
- check for line spaces between list points
- use custom formatting for warnings and info messages with this convention:
> [WARNING] Warning messagefor warnings,> [INFO] Info messagefor info messages - Common issues: I would move them in the Troubleshooting section as they are not relevant with the first install procedure (for warnings use the above instructions and insert them along the guide)
Fishstixx
First crack at this; feel free to tear it apart, or let me know what needs adding. This was half an exercise to make sure I could both handle the writing/simple Markdown code, and that I understood methodology for forking new material to GitHub. Seems remarkably easy, but let's hope I got it right.