Ask HN: What is the best config file documentation you have seen? I run a project called goreleaser, which is configurable via YAML. Since it has a lot of options, it can get confusing. I do provide a JSONSchema and a documentation page, with all available options and some commented examples. Still, I feel like it could be better - especially regarding informing in which version a given option was added, discoverability, etc.. I'm just not sure how to make it so. That said, I wonder: what is the best software configuration documentation you have ever seen? |