Aussehen PHP-Dokumentation

Hallo an alle,
ich habe mich in letzter Zeit an einen automatischen PHP-Code Dokumentator gemacht (ja, ich weiss über phpdocumentor).
Uhrsprünglich hatte ich geplant, das Layout und design der PHP-Dokumentation zu übernehmen, das geht aber aus rechtlichen gründen nicht und auf meine E-Mail erhalte ich keine Antwort.
Deshalb muss ein eigenes Design und Layout her. Da ich vermute, gerade in foren wie diesem, später eine große Zielgruppe zu haben, bitte ich hiermit darum, Designvorschläge hervorzubringen, da ich relativ ideenlos bin.

Ihr könnte also eure Vorstellung von der prefekten Doku (zumindest vom aussehen her) hier einsenden und wenn ich es für gut befinde werde ich es übernehmen und in die Software einbauen.

Ich habe hier als Anhang einen Screenshot vom aktuellen Design, falls jemand dau noch etwas äusern möchte.

Also, ich hoffe also auf viele Ideen und Anregungen um am ende eine Software beritstellen zu können, die jedem nutzer dieses Forums zurechtkommt und bestmöglich die nötigen Ansprüche erfüllt.

Gruß, Tobse

P.S.: Ich habe bereits von anfang an ein Template-System eingebaut, evtl. kann ich betas zum testen herausgeben.

Ich habe schon länger gegoogelt und habe nur phpdocumentor.org gefunden - auf der suche nach so einem Programm, weil ich selbst eins wollte, dass mit die arbeit abnimmt. Aber die Demo-Seiten auf der Webseite sehen sooo langweilig aus, ich würde glaub keine Dokumentation, die damit erstellt wurde, länger als 10 Minuten lesen. Deshalb wollte ich es besser machen.
Und ja, ich bastle gerne an dingen, dies evtl. schon gibt - mir ist das aber egal. Es ist eine Heruasforderung, an der ich wachsen kann, Geld verdienen ist eh noch nicht.
Und zwischen phpdocumentor.org und meinem Prog ist noch ein wesentlicher unterschied. Dazu aber wenns fertig ist.
EDIT: Das mit dem ausprobieren war eher auf die Templates als auf das ganze bezogen.

Ich wusste nicht, dass das teil Templates kennt - aber phpdocumentor erstellt doch einmalig html-dateien. Was ist mit späterenb änderungen oder verbesserungen?

Zitat von jojo87

Ohne dich beleidigen zu wollen denke ich nicht, dass du eine Software ähnlicher Qualität hinbekommst.

Kommt drauf an, wie man das definiert. Evtl. nicht die gleichen (bzw. gleich guten) Qualitäten aber sicherlich andere auf änlichem Nevau.
Der Sinn von phpdocumentore ist es doch, einaml geschriebenen code zu dokumentieren. Meine Software wird einen anderen zweck erfüllen, und ich möchte eben, dass sie schön aussieht xD

Also, PHPDocumentor erstellt einmalig HTML-Dateien mit nur infos aus den PHP-Dateien. Allerdings sind große Funktionsbeschreibungen wie in der PHP-Doku damit nicht möglich, man muss es hinterher in den HTML-Code reinfireimeln.
Meine Software speicher das alles in SQL-Datenbanken, sodass man meinen Parser zwar auch nach jeder änderung über den code jagen kann - aber nicht muss sondern wenn es z.B. nur ein paar methoden sind sie im Web-Interface eintragen bzw. ändern.
Momentan gibts noch keine Userverwaltung, aber es wird am Ende ungefähr so sein, dass z.B. jeder Entwickler eines Projekts seinen Code reinhauen kann und auch nur den bearbeiten, ann dem er gerade arbeitet und (je nach einstellung) von anderen Klassen/Funktionen nur den (programmiertecnisch) öffentlichen teil sieht.
Oder eben dass z.B. ein Freeware Projekt die Doku online stellt (z.B. für eine Library) aber die Öffentlichkeit sieht nur die public felder, wärend den Entwicklern auch die protected und private gezeigt werden.

Und als eine art nebenfeature muss dann eben noch ein Spider/Scanner her, der das ganze in unabhängige HTML-Dokumente exportieren kann.

Zitat von jojo87

Wo hast du das einmalig her? Du kannst PHPDoc so oft über deinen Code jagen wie du magst.

Sicher kann ich das. Aber s.o. wegen änderungen/erweiterungen und der PHPDoc parser ist doch auch in PHP geschrieben, also stell ich mir das langsam vor. Ich habe meinen in Java geschrieben (wegen der Webserver unterschiedlichkeit) und er braucht für 250Kb Code c.a. 3 Sekunden (ohne auswertung durch PHP und Datenbankeintragung, versteht sich. Das hat glaub so 20 Sekunden gebraucht).

Zitat von jojo87

Auch wenn ich mich wiederhole: An die Qualität dieses Programms kommst du nicht ran.

Nach meiner Erklärung oben ist glaub klar, dass ich eine andere Zielgruppe habe.

Zitat

Du begibst dich da quasi auf das Feld der statischen Codeanalyse, und das traue ich dir in dem Maße einfach noch nicht zu. Was nicht heißen soll, dass du mich/uns nicht vom Gegenteil überzeugen darfst

Ich habe nicht ganz gelesen, inwiefern PHPDocumentor einzelne variablen verfolgt (in prozedualen scripts oder OOP Methoden). Klassen/Interface, Funktions und Methodendeklerationen funktionieren jedoch schon.

Zitat von jojo87

Und Niveau ist keine Creme

Zum glück nicht. Aber genau deshalb will ich ja versuchen, es zu erreichen - ob ich dabei jetzt eine unnötige dopplung schaffe oder nicht (Mir persönlich ists egal).