3 ms·
We started by building a culture of documentation within our team. A good place to start is with ADRs (architecture decision records). We also identified barri
by mattchamb 6y ago
We started by building a culture of documentation within our team. A good place to start is with ADRs (architecture decision records).
We also identified barriers for people to write docs on random topics. People thought writing docs would be onerous, so we explicitly encouraged low effort one liner how-tos.
Getting stuff into a wiki is more important than architecting it properly. You can reorganize it later.
You also need to refer people to the wiki to answer their questions.
Not saying we have it sorted, but for our corner of this 400 eng org is making progress on useful docs
- mattchamb 6y agoWriting docs is also important for working asynchronously so people were happy when writing and commenting on docs meant meetings started disappearing from their calendars and any remaining calls were more focused