documentation Archives - Duck Alignment Academy

Conway’s Law applies to your documentation, too

In order to keep your documentation from falling into the Conway trap, you have to actively curate it across the entire project.

Posts

What should you choose for your documentation: a wiki or text files hosted in a git repo and rendered by another tool?

Posts

Chat is somewhat ephemeral. When you try to use it as a long-term resource — even if you have years of logs — it gets rough.

Posts

When you document how to execute a process, that ensures you’ll do it right the next time. This helps your future self and your successors.

Posts