Skip to content
Unknown's avatar

Surfing Complexity

Lorin Hochstein's ramblings about software, complex systems, and incidents.

Tag: documentation

Code is for reading, docs are for writing

  1. The documentation is out of date, you’ll have to read the code. Make sure the code you write will be readable by others.
  2. Write documentation. Yes, it will go quickly out of date, but in the act of explaining how the software works to others, you’ll force yourself to acquire a better understanding of how it works.
Lorin Hochstein software Leave a comment December 12, 2011December 12, 2011 1 Minute
  • lorinhochstein.org
  • Bluesky
  • Mastodon
  • How incidents can teach us about what’s already working well
  • My SREcon talk
  • Life comes at you fast
  • The normal work of creating reliability
  • Thoughts on the Bluesky public incident write-up
Blog at WordPress.com.
  • Subscribe Subscribed
    • Surfing Complexity
    • Join 251 other subscribers
    • Already have a WordPress.com account? Log in now.
    • Surfing Complexity
    • Subscribe Subscribed
    • Sign up
    • Log in
    • Report this content
    • View site in Reader
    • Manage subscriptions
    • Collapse this bar