Mire kell?
Ha kilóra meg kell lennie valamennyi papírnak, akkor bármi jó, amit a menedzsment és/vagy a pályázat kiírója elfogad, ahhoz kell igazodni.
Ha értelmes célja van, vagyis horrible dictu dolgozni kell belőle, integrálódni, később hozzányúlni, akkor meg a projekt mellett a helye, szintén bármi jó, de a legjobb, ha a forráskóddal együtt lehet szerkeszteni, mert például refactor esetén az IDE szól, hogy van az adott dologról említés a doksiban, azon is változtatni kell.
A projekttől külön életciklust élő dolgok sajnos arra jók, hogy oda küldjük meghalni a dokumentumokat.