Proper Documentation
summary
Argues that documentation is insurance and shows concrete stakes: 58% of managers get no management training, only 4% of companies always document processes, and 106 million US adults lack life insurance as an analogy. Recommends simple, durable tools—journals, phone notes, email, scanned records, transcription tools, Slack and performance platforms—and records a federal case where lack of a written rule reversed a firing. Claims contemporaneous, dated notes repeatedly save time, money and legal exposure and reports that longterm journaling has proved effective.
AI-written summary · about
chapters (10)
- 0:00Proper documentation
- 1:32Documentation like insurance
- 7:52Poor documentation consequences
- 12:04If not written it never happened
- 15:57Why managers avoid docs
- 20:13Good documentation practices
- 24:47Documentation failure example
- 30:07Start documenting effectively
- 34:39Documentation for evaluations
- 37:52Q&A
related talks
31mBack to the Future: What Can Documentarians Learn From The Past?
45mHow I convinced my boss to build our docs team
23mDocument Yourself: A Framework for Career Advancement
43mThe Joys of Managing Engineering Teams
36mOvercoming the Plight of Lone Writers
35mEngage or Die: Four Techniques for Writing Indispensible Docs
14mKeeping a Coder's Journal
21mSkills for Managing your Documentation Team