Dokumentacja kodu

W jaki sposób sensownie tworzyć dokumentację w trakcie pisania programu?

Standardowe narzędzie nr 1 JavaDoc > http://www.oracle.com/technetwork/java/javase/documentation/index-jsp-135444.html

Pomaga w tym środowisko IDE, które potrafi wygenerować nagłówek dokumentacji, pozostaje uzupełnić opisy zmiennych i opis metod,klas.

Poza tym każdy język ma standardy dokumentowania, których warto się trzymać.
Do konkretnego języka znajdziesz w wyszukiwarce!

Chodzi ma bardziej o metodykę tworzenia dokumentacji. To tak jak z komentarzami, są te dobre i te niepotrzebne. Czy z dokumentacją jest podobnie? Zadając pytanie miałem na myśli jakąś... filozofię, tworzenia dobrej dokumentacji.

Kod samo-dokumentujący się :) Co do reszty to wszystko zalezy od tego jaka zostanie przyjęta konwencja w ramach danego zespołu.

Ok, dzięki za odpowiedzi :)