3 ms·
Exactly. Good documentation is much harder than you'd think. I had similar policies. Also periodic reviews and especially during onboarding new devs I had them
by Lutger 3y ago
Exactly. Good documentation is much harder than you'd think.
I had similar policies. Also periodic reviews and especially during onboarding new devs I had them review the docs and make a list of missing points etc
Its just as important to delete out of date topics. Wrong and stale info is costly, it decreases trust and sends people in wrong directions.
edit: another obvious but surprisingly difficult thing to do is have everything in one system and make sure everything knows where to find it. Especially if your org is a bit bigger everybody will have their own systems and it'll be a big mess before you know it. But even so, within a single project I've often seen 3 to 8 'sources of truth', like trello tickets, images in onedrive, a word doc, markdown files, various propietary formats, pinnend posts in chat system, email archives, etc, etc.