dokumentaatiokommentteihin
Dokumentaatiokommentit ovat ohjelmointikielissä käytettyjä kommentteja, joiden tarkoituksena on kuvata ohjelmiston julkista sovellusohjelmointirajapintaa ja moduulien käyttöä. Ne on suunnattu koodin käyttäjille ja niiden tehtävä on tarjota kuvaus parametreista, palauttavista arvoista, poikkeuksista sekä käyttöesimerkeistä ilman, että koodi tarvitsee ymmärtää toteutusta. Hyvin laaditut dokumentaatiokommentit helpottavat ohjelmiston käyttöönottoa sekä ylläpitoa.
Monet kielet käyttävät erityisiä dokumentaatiokommenttipolkuja tai syntakseja. Esimerkiksi Javaa varten on JavaDoc-merkinnät, C#:n XML-dokumentaatiokommentteja, C++:ssa Doxygen-tyylisiä
Dokumentaatiokommentit voivat sisältää tunnisteita kuten @param, @return tai kuvaustekstin, ja ne voivat kattaa sekä yksittäisen funktion
Hyvät käytännöt ja haasteet liittyvät muun muassa ajantasaisuuteen ja selkeyteen. Kommenttien tulisi kuvata tarkoitus ja käyttö