Come strutturate la documentazione tecnica del codice?

La nostra documentazione è un disastro: README obsoleto, zero commenti nei punti critici, nessuna documentazione architetturale. Come avete risanato situazioni simili?