Biweeklycast

53: Undead documents


Listen Later

📺 Watchthis 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!

...more
View all episodesView all episodes
Download on the App Store

BiweeklycastBy Biweeklycast

  • 5
  • 5
  • 5
  • 5
  • 5

5

2 ratings