Core-Request - Kommentierung von Funktionen

Ideen für neue Funktionen in CONTENIDO?
Antworten
rethus
Beiträge: 1851
Registriert: Di 28. Mär 2006, 11:55
Wohnort: Mönchengladbach
Kontaktdaten:

Core-Request - Kommentierung von Funktionen

Beitrag von rethus » Fr 7. Aug 2009, 08:47

Contenido wird immer umfangreicher, doch auch immer unübersichtlicher.
Wer weiß schon welche Klassen es gibt, und vofür diese alle sind.
Dafür muss, wie für jedes größere Projekt eine API-Referenz her, anhand der man sich einfach und analytisch durchhangeln kann.

Der Grundstein ist gelegt (Contenido API), dennoch erschwert der schlecht kommentierte Quellcode die Arbeit mit der API.

Wären in den Quellcode direkt von Anfang an entsprechende Kommentare hinzugefügt worden, würde man in der erzeugten API direkt alles über die entsprechende Funktion erfahren.

Würde mich sehr freuen, wenn dieses Manko nach und nach aufgearbeitet würde.
Ggf. könnte man ja auch ein Community-Projekt daraus machen:
Man nehme eine aktuelle Stable-Version, und veröffentlicht in einer Liste ein paar (z.B. 5 pro Woche) Klassennahmen, deren Funktionsbeschreibung (also Kommentare für Funktionen) aktualisiert werden sollte. Für die Zeit der Kommentar-aktualisierung wird in diesem Bereich der Core-Code dieser Klassen nicht weiterentwicklet, um keine redundanten Daten zu haben.
Wurden die Beschreibungen angepasst, wird die Beschreibung dann in die aktullen Klassen übernommen und in die Stable-Version aufgenommen.

So könnte man Stück für Stück Contenido gut dokumentieren. Das bringt meiner Meinnug nach gerade den Entwicklern eine imense Zeitersparnis, und kommt so Contenido wieder zugute.

Wa sagt Ihr dazu?
Could I help you... you can help me... buy me a coffee . (vielen ❤ Dank an: Seelauer, Peanut, fauxxami )

xstable.com: - HighSpeed Hosting, Domains, DomainReselling, Linux-Administration
suther.de: - App-Programierung, High-Performance-Webpages, MicroServices, API-Anbindungen & Erstellung

Software... ein Blick wert: GoogleCalender Eventlist, xst_dynamic_contentType

Dodger77
Beiträge: 3626
Registriert: Di 12. Okt 2004, 20:00
Wohnort: Voerde (Niederrhein)
Kontaktdaten:

Re: Core-Request - Kommentierung von Funktionen

Beitrag von Dodger77 » Fr 7. Aug 2009, 08:48

Ich denke, hier passt das besser. => verschoben

knb
Beiträge: 224
Registriert: Fr 9. Sep 2005, 14:03
Wohnort: Potsdam
Kontaktdaten:

Re: Core-Request - Kommentierung von Funktionen

Beitrag von knb » Di 27. Okt 2009, 10:45

Hier kann man sich durch den Cross-Referenzierten Quellcode hangeln:

http://phpxref.com/xref/contenido/nav.h ... hp.html.gz
Gruss,
Knut

Antworten