This article is really good. It says something very important: good documentation about work isn't enough. It also talks about how we need to make it easy for people to understand this documentation and use it.