Trust me it doesn’t. People don’t read the documentation. Read recent posts here that have less than 3 answers and count how many of these posts are answered with a link to the docs and answered by “Oh, didn’t see this”.
The problem with an open source project that hit’s some kind of threshold as Hugo did around 2 years ago is that the usership changes from a “bunch of nerds” to “everyone reading an article on a famous blog and starting to use it”. This can be proven by just reading the posts on this discourse. These days the posts that want a “dynamic” website which has nothing to do with a static website generator are daily and basically overpower the resources of UNPAID workers that try to help.
I myself regularly receice messages that would want me to stop answering anything here, but I kind of still try to filter the normal people from “them”. I also like to be abused. Obviously.
FACT: “Open as in Open Source” does not mean you (the user) have the right to abuse anybody who tries to help. It also does not mean you have a paid callcenter at your disposal to help with anything from unread documentation to feature requests that do not exist in this universe.
You wouldn’t buy a Mercedes to listen to a cassette tape.
50% of the people who write here on the discourse have NOT read the docs and expect people to answer their request, because Hugo is FREE. They DO NOT understand open source.
Having said that: If you find a way to optimise the documentation for
ref I will personally merge your commit preferred. The way to start is load the page in the documentation that you want to change, then click the edit link at the bottom. Just add a note to @davidsneighbour in your commit at Github. I myself did this kind of things often after reasonably pushy asking here on discourse about it. The way to win is to ask without starting your sentence with “your docs are crap”.
What Hugo needs is a team of non-developers writing the documentation. But that is not how it historically grew. I stopped saying that because people frowned upon it, but there is a lot of people using Hugo that should just (<<< there, a trigger word) go to use WordPress.
As long as Hugo’s version number starts with a 0, people should not assume to have a finished polished well documented product.
Open source is like these “take one, leave one” coin exchanges at your mum-and-pop-stores at the corner. And criticising WITHOUT an attempt to do it better never helps.
And reopening an opinion piece 9 months after it happened? Muahaha.