Zio-6a-wyk-Slajd93
Z Studia Informatyczne
Przejdź do nawigacjiPrzejdź do wyszukiwania
Standard kodowania(4)
Kolejnym aspektem, który powinien być poruszony w standardzie kodowania jest sposób komentowania instrukcji. Panuje ogólnie akceptowany pogląd, że komentarze do instrukcji powinny być tak napisane, aby pomagały czytelnikowi zrozumieć kod. Rozważmy fragment kodu pokazany na slajdzie.
Można go na przykład skomentować w sposób pokazany na slajdzie: „czytaj kolejne pary węzłów A,B i dla każdej z nich , o ile jest poprawna , zapamiętaj , że jest łuk między tymi węzłami ”. Komentarz niesie informację, która nie wynika bezpośrednio z tego fragmentu kodu i to może być cenną wskazówką dla osoby próbującej zrozumieć kod.