Best practices for documentation?

[StochasticTelegraph (Mahlen Morris)]

If you want examples to draw from and infer what makes for good docs, I’ll suggest this thread:

John's "Gold Star for Documentation" Awards

The first Gold Star for Documentation goes to . . .drumroll . . . Algoritmarte VCV Rack Modules All the gozintas and gozoutas are explained, the effects of parameters and knob-twisting, what voltage levels are expected, each module has an overview at the start to give an idea of what it might be useful for, the names of the modules are somewhat descriptive (if a bit whimsical), The largest one, “Zefiro”, is even broken down into its ten main sections, each with a partial image o…