Ja tak w nawiązaniu do podobnego tematu sprzed ponad roku.
Dokumentowanie kodu
To jak to w końcu jest - warto a może nie warto dokumentować kod za pomocą przeznaczonych do tego narzędzi np. JSDoc (JS), Documentation comments (C#), Javadoc (Java)? Nie pogardziłbym ciekawą analizą z punktu widzenia poważnych (nie)komercyjnych projektów i skromnych programików tworzonych w ramach samodzielnej nauki. Czy docs comments pomagają czy bardziej przeszkadzają?
W moim odczuciu takie komentarze dokumentacyjne (tak to się formalnie nazywa?) to pewna pomoc dla obcującego z kodem, ale ja jestem niedzielnym teoretykiem amatorem, dlatego wolę zapytać praktyków z doświadczeniem. Jeśli ktoś chce to może wypowiedzieć się również na temat zwykłych komentarzy, ale wiadomo - ponoć lepiej ich unikać, ponieważ kod ma być samoopisujący się itd. itp.