mach: No, to už je hodně přehnaný. Lpší je jen na začátku funkce popsat spíš rámcově a stručně co je jejím úkolem a konkrétní algoritmus už čtenář pochopí sám, případně se ještě zdokumentují "magická čísla", pokud jejich smysl nevyplyne z použitého řešení. Je blbost komentovat každou řádku třídícího nebo hledacího algoritmu; stačí uvést co to dělá, jaké jsou parametry a co to vrací. |