Four kinds of documentation
My pet peeve is auto-generated documentation from configuration files or source code. It is absolutely useless and I would rather prefer no documentation than auto-generated.<p>Some time ago Swagger (nowadays OpenAPI) got really popular and many projects &quot;had an API&quot; and pointed users to their green autogenerated API documentation clusterfuck. When time went on this green page would become an indicator for me, that the project does not work and I should be very sceptical - I am sure there are projects that do it better, but for me <i>no-content</i> auto-generated documentation is a real code smell.