[andrelaszlo]

One good way to understand how something works is to write documentation for it. In this case it seems like the author has pretty strong opinions about how it should be done. It's a big job, of course, but perhaps similar in effort to writing a blog post?

I don't mean to be snarky! Just got the feeling that the current docs are written a bit as an afterthought and that the blogger, on the other hand, is a good writer. I wonder how useful this type of feedback is, and if the irritation over the docs could have been challenged into something more impactful.

[digianarchist]

I think the post serves as general advice for writing documentation for a project. If the author had gone off and wrote docs for Hugo they 1. Might not have been accepted 2. Wouldn't contain info on why the docs are bad.