richtig kommentieren

Diskutiere mit über: richtig kommentieren im Web-Programmierung Forum

  1. balufreak

    balufreak Thread Starter MacUser Mitglied

    Beiträge:
    1.560
    Zustimmungen:
    28
    Registriert seit:
    12.10.2003
    guten morgen allerseits

    ich habe mir da mal eine frage gestellt. und zwar habe ich schon mehere php seiten gemacht. aber der code ist zum teil recht unübersichtlich. im internet habe ich mal gesucht, wie man php dateien eigentlich kommentiert/dokumentiert. so mit header und so. hab aber nichts schlaues gefunden, bzw. bin nicht auf einen standard gestossen. nun wollte ich mal fragen, wie dokumentiert/kommentiert ihr eure php dateien so? was schreibt ihr in die header, wie kommentiert man klassen, dass sie z.B von Zend Studio oder Eclipse erkennt werden usw.

    Greets balu
     
  2. koli.bri

    koli.bri Gast

    Also ich kommetiere fast alles damit, was es macht.

    Am Anfang der Datei kommt der Dateiname, und der Zweck der Datei, eventuell was sie darf und was nicht.
    Funktionen bekommen die Parameter als Kommentar.
    Im Grunde so, dass, wenn ich den eigentlichen Code weglasse, dass ich imer noch genau weiß, was die Datei macht

    Wegen Eclipse und Zend-Konformer Kommentation:
    Ich würd mal gucken, die die beiden das von Haus aus machen, und mir das quasi abschauen...
     
  3. wegus

    wegus MacUser Mitglied

    Beiträge:
    15.029
    Zustimmungen:
    1.314
    Registriert seit:
    13.09.2004
    Gib Deine Klasse kommentarlos jemand Anderem! Wenn er damit arbeiten kann war der Kommentar gut :)

    Jede Datei muß einen header haben ( Name, Beschreibung, Author, Besonderheiten, History). Jede Methode muss eine Kurzbeschreibung besitzen, ebenfalls ein Datum und eine History. Parameter und Return.Werte müssen beschrieben sein.

    Gute Dokumentation ist maschinell extrahierbar!
     
  4. balufreak

    balufreak Thread Starter MacUser Mitglied

    Beiträge:
    1.560
    Zustimmungen:
    28
    Registriert seit:
    12.10.2003
Die Seite wird geladen...
Ähnliche Themen - richtig kommentieren Forum Datum
MVC richtig anwenden Web-Programmierung 26.02.2012
wie eine seite richtig mit ajax nachladen? Web-Programmierung 02.10.2011
jQuery führt Funktion nicht richtig aus Web-Programmierung 10.10.2009
htaccess funktioniert nicht richtig Web-Programmierung 17.07.2008
MAMP richtig installieren Web-Programmierung 08.03.2008

Diese Seite empfehlen

Benutzerdefinierte Suche