Just prepared a lightning talk for #PyConLT in 1 minute: 3 + 1 tips to enjoy writing documentation!
0️⃣ Love @readthedocs
1️⃣ Follow the Diàtaxis framework (and never mix explanations and tutorials!)
2️⃣ You can use the second person, it's fine https://ddbeck.com/second-person-is-ok/
3️⃣ You don't need reStructuredText anymore, write Markdown in Sphinx using MyST https://astrojuanlu.github.io/mystyc/
Cheers!
