Dokumentowanie aplikacji

Z PHPEdia.pl
Skocz do: nawigacji, wyszukiwania

Dlaczego jest potrzebne?

Pamięć jest zawodna. Kod, niezależnie od tego, jak dobrze byłby sformatowany, zaprojektowany i przemyślany, dla osoby, która go nie pisała, lub po dłuższym czasie, potrafi być bardzo trudny do zrozumienia, zmodyfikowania lub użycia.

Przykład dokumentacji kodu

<?php
/**
 * Opis pliku
 */
 
/**
 * Opis klasy
 */
class Klasa
{
   /**
    * Opis funkcji
    */
   function funkcja()
   {
 
   }
}
?>

Zobacz także

Wiki letter w.png To jest tylko zalążek artykułu. Jeśli możesz, rozbuduj go.