Odpověď na názor

V zásadě komentuji algoritmy, pokud vlastní zdrojový kód je těžší analyzovat. Osvědčilo se mi prokládané komentování, tedy jeden komentář, a jeden řádek kódu

   //tak nyni si vyzvedni iterator vsech vertexu
VertexSet::iterator iter = vxset->getIterator();
   //zpracuj vsechny vertexy
while (iter.hasItems()) {
      //vyzvedni vertex
   PVertex vx = iter.getNext();
       //a neco s nim udelej
   foo(vx);
}

Ukázka je samozřejmě primitivní. Používám spíš u náročnějších úkolů, třeba různé ne zrovna na první pohled viditelné optimalizace. Další důvod pro komentáře u vícevláknových algoritmech, kde komentář zpravidla obsahuje očekávaný stav dalších vláken v tom daném míste (případně upozornění na problémové místo, možný race condition a podobně) Komentování algoritmu zjednodušuje pochopení principu fungovaní později a hlavně odhalování chyb. Komentáře jsou často v implementační části, takže (aspoň v C++) skryté běžnému uživateli.