Citat:
Originalno napisao Dragi Tata
Нисам сигуран да се слажем. Кад се промени код, често се заборави да се промени и коментар па више штете него користи. Мада, јесте мало предугачко и напорно за читање  |
Zbog toga se nijedan od poznatijih sistema za dokumentovanje koda (
phpDocumentor,
javaDoc...) ne oslanja direktno na nazive elementa koji dokumentuje (funkcije, metode itd.) već se oni "kupe" u toku procesa kompajliranja dokumentacije čime se efektivno eliminiše navedeni problem. Isto tako ako se i dogodi da postoje nesuglasice između iskomentovanog koda i stvarnog koda veoma lako se može podesiti da prilikom kreiranja dokumentacije kod uvek ima prednost nad postojećom dokumentacijom.