← Engineering notebook
Support & infrastructure

Documentation systems people actually use

The solution usually existed already. Nobody knew where it was.

Throughout my career I kept noticing the same issue: the solution already existed, but nobody knew where it was.

Systems I have worked with

  • Wiki platforms
  • Issue trackers
  • Document portals
  • Internal knowledge bases

The lesson

Documentation only works when engineers actually use it. The best documentation system is simply the one people open.

The technical implementation matters. The process design matters even more.

This site itself is an attempt to live by that lesson: write things down so the next person (sometimes future me) solves the problem faster.