Inspired by The Zen of Python✨
Machine-readable is better than PDF.
Avoid jargon.
Documentation is not separate from your product - it is part of it.
Good docs help people to help themselves.
Multilingual support matters.
Some links:
Why GOV.UK content should be published in HTML and not PDF
This is a living document, so please feel free to make a pull request if you want to add on something or just make your own!