53: Undead documents

📺 Watch this episode on YouTube.

Dima and Slava discuss documentation for systems, processes, and so on, and debate how to prevent it from crossing the line from being helpful to being actively misleading.

• Dima's January of putting one foot in front of the other
• Hacker News
• Fighting undead documentation
• Documentation evolves independently of the systems/processes it describes
• Put date of last update in the document to signal that it may be outdated
• Doing something vs documenting something
• Finding a updated document can also be a challenge
• How often and how much to document?
• Ideally, documentation is integrated into the system is documents
• 1-2-3 rule for automation writing documentation

Just feel it!