The comments in Investigate reasons for low SatNOGS coverage in Russia surfaced some documentation issues that I agree with. Some takeaways:
- Main page has a lot of text, some useful links, but doesn’t clearly communicate how to build a station.
- The Build page gets confused with the Build category, and the latter is overwhelming for beginners.
- The Build page doesn’t clearly communicate what the simplest option to build a station is, and presents a lot of options in a table instead.
- Arguably the simplest station possible, No rotator, has an incomplete bill of materials which doesn’t list totals, contains some unexplained jargon (what is a LNA?), and doesn’t feature assembly instructions beyond a couple of pictures.
This is from the perspective of someone that has never attempted to build a Station (but, however, is about to start mentoring someone to do it). Therefore, there are probably many more things to improve. But at the very least, this “first contact” experience is way less than optimal.
I think the “user journey” could be greatly improved with some user personas in mind. Some ideas:
- Turn the Main page into a super simple “red pill / blue pill” with less text that offers the reader the option to build the simplest station possible, presenting the tradeoffs (less flexibility, less powerful satellites out of reach, etc)
- Improve the No rotator page to clear or define the jargon, update the bill of materials, and expand the assembly instructions
Probably lots of things from the LSTN Handbook could be used in the wiki to make it more palatable for beginners.
What do folks think?