I agree with this - it might also be worth mentioning KIAUH as an easy installation option (with a disclaimer about it not being officially supported by Klipper, probably)
Being frontend and Pi image (or even OS) agnostic would be ideal, but you certainly have to pick at least one frontend to use… I think I’d want the installation instructions to be able to work from a completely fresh Pi image too, with no assumptions about level of skill made, although that could be difficult.
I’d also like to add a list of prerequisites at the top of the installation document, and a set of basic troubleshooting instructions for before they go running to Discord or Discourse (or Facebook, I didn’t even know there was a group!) - I’ve seen a lot of people come in without having actually read their
/dev/klippy.log file, which usually explicitly spells out what is wrong.
Some clearer instructions on flashing boards might also be useful, I’ve seen quite a few people that have clearly failed to flash their MCU especially with those that don’t work with the standard
make flash process.
I know rewriting the documentation to be more newbie-friendly isn’t a priority for developers right now, and it probably shouldn’t be, so I’m planning on taking a stab at some of this in a few weeks when I should have some free time.
I’m also very interested in PR #4327 on swapping over to the Just The Docs theme - navigation and structure are certainly issues with the documentation right now, at least from my perspective.
I have some other things I’d like to change about the documentation, but they’d probably be best saved for other threads later down the line…