Preferences

Good docs don’t fix bad apps or APIs though. I get the sense that demand for docs is a signal that there’s a deeper problem with DX. Good docs generally only exist in places where they’ve given the rest of the DX enough love in the first place, so it’s more of a mark of quality than a means to quality.

Yes, and creating documentation is an exercise in understanding the whole experience. Often, nobody on the team truly gets it.

This item has no comments currently.