webEdition Dokumentation verwirrend
Verfasst: Mi 25. Jun 2014, 14:58
Hallo
Die Seite documentation.webedition.org ergibt sich mir noch nicht ganz.
Unter http://documentation.webedition.org/wik ... playground finden sich Testeinträge. Tatsächliche Benutzer der Dokumentation könnte das ggf. verwirren, bzw. es ist ja schon nervig wenn man sich da erstmal durchgeklickt hat um dann in der letzten Ebene festzustellen, dass das ganze gar keinen Inhalt hat.
In der Core-Dokumentation unter http://documentation.webedition.org/core/ kann ich mir die ganze Dokumentation gar nicht ansehen, sehr wohl aber die Liste der Fehler Das ist ja irgendwie auch nicht zielführend im Sinne des OpenSource - Entwicklungsgedankens, oder?
In der eigentlichen webEdition Dokumentation wiederum ist irgendwie keine richtige Struktur erkennbar. Ist ja schonmal nicht soo 100% verständlich wenn ich von http://documentation.webedition.org auf "webEdition Dokumentation" gehe, dann Playground, Wiki, Deutsch - und Englische Dokumentation auswählen kann (Na was ist es nun, eine Dokumentation oder ein Wiki oder eine Kombination oder vielleicht doch ein Playground?) und wenn ich mich dann für die tatsächliche Dokumentation in einer Sprache entschieden habe, dann stehe ich nochmal vor der Wahl ob ich denn wirklich etwas über webEdition oder doch lieber etwas über PHP oder JavaScript oder eines der anderen Themengebiete erfahren möchte. Wobei ... auch die Unterteilung ist wieder nicht ganz klar, denn in webEdition finden sich sehr wohl auch PHP basierte Lösungen. Und so eine allgemeine Befehlsreferenz für PHP und JavaScript ist (aus meiner Sicht) auch nicht hilfreich, wenn ich mich als Benutzer in der webEdition Doku befinde.
Bin ich dann aber bei der wirklichen Dokumentation von webEdition die ich suche (über http://documentation.webedition.org [Englischsprachige Übersichtsseite] > webEdition Documentation [Deutschsprachige Übersichtsseite] > Dokumentation (deutsch) > webEdition) finden sich hier Punkte wie Codebeispiele, Problemlösungen, Frameworks einbinden (ohne JQuery aber dafür mit allem anderen ^^), Validierungsdienste (?? als Linkliste).
Ich weiß nicht - ich frage mich eben nur, ob die Dokumentation jetzt wirklich so zielführend ist. Ich finde es macht nach außen eher den Eindruck, dass das so ein Sammler aus allen möglichen Projekten ist. Playground, Linksammlungen (egal ob we bezogen, oder doch eher Entwicklungsgrundlagen, Validationsdienste, etc.), Fehlerbehandlung usw.
Ist das nicht eine Stelle, an der wir hier aus der Community auch mal konkret weiterhelfen können - auch ohne konkret in die Programmierung einzusteigen?
Viele Grüße
Martin
Die Seite documentation.webedition.org ergibt sich mir noch nicht ganz.
Unter http://documentation.webedition.org/wik ... playground finden sich Testeinträge. Tatsächliche Benutzer der Dokumentation könnte das ggf. verwirren, bzw. es ist ja schon nervig wenn man sich da erstmal durchgeklickt hat um dann in der letzten Ebene festzustellen, dass das ganze gar keinen Inhalt hat.
In der Core-Dokumentation unter http://documentation.webedition.org/core/ kann ich mir die ganze Dokumentation gar nicht ansehen, sehr wohl aber die Liste der Fehler Das ist ja irgendwie auch nicht zielführend im Sinne des OpenSource - Entwicklungsgedankens, oder?
In der eigentlichen webEdition Dokumentation wiederum ist irgendwie keine richtige Struktur erkennbar. Ist ja schonmal nicht soo 100% verständlich wenn ich von http://documentation.webedition.org auf "webEdition Dokumentation" gehe, dann Playground, Wiki, Deutsch - und Englische Dokumentation auswählen kann (Na was ist es nun, eine Dokumentation oder ein Wiki oder eine Kombination oder vielleicht doch ein Playground?) und wenn ich mich dann für die tatsächliche Dokumentation in einer Sprache entschieden habe, dann stehe ich nochmal vor der Wahl ob ich denn wirklich etwas über webEdition oder doch lieber etwas über PHP oder JavaScript oder eines der anderen Themengebiete erfahren möchte. Wobei ... auch die Unterteilung ist wieder nicht ganz klar, denn in webEdition finden sich sehr wohl auch PHP basierte Lösungen. Und so eine allgemeine Befehlsreferenz für PHP und JavaScript ist (aus meiner Sicht) auch nicht hilfreich, wenn ich mich als Benutzer in der webEdition Doku befinde.
Bin ich dann aber bei der wirklichen Dokumentation von webEdition die ich suche (über http://documentation.webedition.org [Englischsprachige Übersichtsseite] > webEdition Documentation [Deutschsprachige Übersichtsseite] > Dokumentation (deutsch) > webEdition) finden sich hier Punkte wie Codebeispiele, Problemlösungen, Frameworks einbinden (ohne JQuery aber dafür mit allem anderen ^^), Validierungsdienste (?? als Linkliste).
Ich weiß nicht - ich frage mich eben nur, ob die Dokumentation jetzt wirklich so zielführend ist. Ich finde es macht nach außen eher den Eindruck, dass das so ein Sammler aus allen möglichen Projekten ist. Playground, Linksammlungen (egal ob we bezogen, oder doch eher Entwicklungsgrundlagen, Validationsdienste, etc.), Fehlerbehandlung usw.
Ist das nicht eine Stelle, an der wir hier aus der Community auch mal konkret weiterhelfen können - auch ohne konkret in die Programmierung einzusteigen?
Viele Grüße
Martin