I was going to start this as a rant for how bad most docs are but instead I'll just list what I think are some best practices. I know no one will read this but what else can I do 😉