Sekä Java- että JavaScript-koodissa ei juuri ole kommentteja, ei ainakaan sellaisia, että ne auttavat ymmärtämään ohjelman rakennetta tai toimintaa.
Java-koodi piti olla kommentoitu JavaDoc:lla. Nyt generoituvasta dokumentaatiosta ei juuri ole hyötyä (vain joillain paketeilla ja luokilla on yleiskuvaus; hyvin harvaa metodia on kuvattu ollenkaan).
JavaScript-koodissa on satunnaisia kommentteja ja ne selittävät vain jonkin yksityiskohdan toteutusta. Yleiskuva ja eri funktioiden tarkoitusta ei ole avattu juuri ollenkaan (tiedostot metkaJS.js ja l10n.js ovat poikkeuksia, niissä avataan itse funktioiden käyttöäkin).
matti-heinonen
commented
8 years ago
Sekä Java- että JavaScript-koodissa ei juuri ole kommentteja, ei ainakaan sellaisia, että ne auttavat ymmärtämään ohjelman rakennetta tai toimintaa.
Java-koodi piti olla kommentoitu JavaDoc:lla. Nyt generoituvasta dokumentaatiosta ei juuri ole hyötyä (vain joillain paketeilla ja luokilla on yleiskuvaus; hyvin harvaa metodia on kuvattu ollenkaan).
JavaScript-koodissa on satunnaisia kommentteja ja ne selittävät vain jonkin yksityiskohdan toteutusta. Yleiskuva ja eri funktioiden tarkoitusta ei ole avattu juuri ollenkaan (tiedostot metkaJS.js ja l10n.js ovat poikkeuksia, niissä avataan itse funktioiden käyttöäkin).