A kto jest użytkownikiem twojego kodu? ALbo ty po długim okresie czasu albo inny programista. Jeśli kod jest otwarty, nie zamknięty w biblioteke, to komentarze są częścią dokumetacji. Jeśli ty odejdziesz z roboty, a twój kod zostanie... to musi być czytelna i treść, i forma.
Dlatego też napisałem rozszerzyć pojęcie komentarze o bardziej ogólne pojęcie dokumentacji.
Oraz, tutaj to lepiej ode mnie napisali:
http://www.linfo.org/documentation.html"Good documentation also facilitates the improving, extending and updating of software. Because programs can be extremely complex, their developers often forget what they were doing or thinking when they created them, particularly after the passage of long periods of time. Moreover, it is frequently the case that some or all of the original writers of a program are no longer available, thus making it even more difficult to understand the original software in order to improve, extend or update it. It is often said that the largest cost of software is not creating it, but rather maintaining it (i.e., correcting errors and updating it); good documentation can help reduce this cost. Good documentation can also help users make useful suggestions for improving the software."
Edit: Oraz ten fragment -
"One of the most important forms of documentation for computer software is one that ordinary users rarely, if ever, see. It is the comments that are included in the source code of programs. Source code is the version of software (usually an application program or an operating system) as it is originally written (i.e., typed into a computer) by a human in plain text (i.e., human readable alphanumeric characters) in a programming language."
