ugrás a tartalomhoz

szabványos kommentezés

daniel · 2006. Május. 9. (K), 16.57
Sziasztok!

Felvetődött egy munka kapcsán, hogy elég szigorúan -kicsit bővebben- kellene kommentezni a forrást, lehetőleg szabványszerűen.

A kérdésem az, hogy mit érdemes használni, már ha van egyáltalán valamilyen előírás, szabvány ezt illetően.

Bevallom, jómagam (szerintem sokakhoz hasonlóan), nem kommentezek nagyon bőbeszédűen, inkább csak a "rázós" programrészekben.

Előre is köszi az ötletekért!
 
1

phpDocumentor

-zsolti- · 2006. Május. 9. (K), 17.12
2

Köszi

daniel · 2006. Május. 10. (Sze), 08.35
Köszi, korábban ezt már szemügyre vettem. Talán ez a legelfogadottabb, legismertebb ilyen eszköz? Ha egyáltalán más is létezik... :)
3

Öö...

-zsolti- · 2006. Május. 10. (Sze), 12.00
...hogy a legelfogadottabb-e, azt nem tudom, de valószínűleg igen, mivel más, hasonló "színvonalút" nem nagyon ismerek, ami gombnyomásra dokumnetációt generál a teljes projektből. A néhány jelölő megtanulása sem nehéz, úgyhogy érdemes beleásnod magad.
4

van más is

Hodicska Gergely · 2006. Május. 10. (Sze), 12.57
Pl. PHPDoc. Már nem emlékeszem, hogy milyen különbségek vannak, de általában mindenhol azt látom, hogy a PHPDocumentor-t részesítik előnyben, de lehet ez is egy alternatíva.


Felhő