initially when I was learning linux. I had troubles finding the command I needed. I could have first gone and read everything and then come back to try, which I did. But sometimes the man pages, the ubuntu and arch forums weren't as great of a help as messing up myself.

Could there be a better way to document with slightly more examples: yes. Would it help: tons

But this is just my opinion, and I am just a noob