Zend Framework Tutorial an die Community übergeben?
Nach gründlicher Überlegung habe ich den Entschluss gefasst, mein Zend Framework Tutorial an die Community zu übergeben. Das soll bedeuten, dass ich das Tutorial nicht mehr alleine pflege, sondern die deutsche Zend Framework Community dabei hilft, ein verständliches und tiefgehendes Tutorial für alle Einsteiger zu schaffen.
Die Gründe für diese Entscheidung sind vielfältig. Allen voran habe ich mit der Zeit gemerkt, dass die Pflege des Tutorials beim Erscheinen neuer Releases einfach zu lange dauert, wenn ich mich darum alleine kümmere. Außerdem hat sich gezeigt, dass ein Blog für solch ein Tutorial doch nicht unbedingt die geeignetste Form darstellt. Zumal auch die Druckversion schon immer zu wünschen übrig lässt. Ich bin mittlerweile der Meinung, dass ein Wiki besser für das umfangreiche Tutorial geeignet ist. Zudem hoffe ich, mit der sich gerade entwickelnden Community beim deutschen Zend Framework Forum einige begeisterte Helfer für die Fortführung des Tutorials zu finden.
Im Grunde werden zwei Dinge benötigt. Zum einen ein Wiki für die Pflege der Tutorial Seiten und zum anderen ein SVN Server für die Verwaltung der Projektdateien, mit dem auch der Code für die einzelnen Kapitel des Tutorials verwaltet werden können, damit jeder sich bei Bedarf den vollständigen Code jedes Kapitels downloaden kann. Die Zend Framework Website bietet mit dem Laboratory und dem Wiki bereits die technischen Voraussetzungen, um das Tutorial von der Community pflegen und fortführen zu können. Es wäre aber auch denkbar, ein eigenes Wiki aufzusetzen. Ein eigener SVN Server wiederum würde meiner Meinung nach weniger Sinn machen.
Ich möchte nun alle Interessierten zur Diskussion einladen,
- wie man das Ganze gemeinsam umsetzen könnte
- ob man die vorhandenen technischen Voraussetzungen nutzt
- ob man eigenen technische Voraussetzungen schafft (halte ich persönlich eher für ungünstig)
- wer Interesse hat, sich an der Umsetzung zu beteiligen
- wer ggf. an einer Übersetzung in andere Sprachen (vor allem Englisch) interessiert ist
- was sonst noch so einfällt
Dazu bitte entweder in den Kommentaren hier im Blog melden oder die Diskussion im Zend Framework Forum nutzen. Ich freue mich auf zahlreiche Meinung.
Natürlich werde ich auch weiterhin am Tutorial mitarbeiten und werde sicher auch neue Teile beisteuern. Aber gerade die Pflege nach einem neuen Release artet sehr schnell in Fleißarbeit aus, wenn z.B. eine Änderung in allen Codepaketen eingepflegt werden muss. Parallel werde ich mich auch mit dem Server Team in Verbindung setzen, wie man das Tutorial und die Codebasis auf der Zend Framework Website integrieren könnte.
Donnerstag, 04.01.2007, um 15:07
> wie man das Ganze gemeinsam umsetzen könnte
Denke ein Wiki ist das der beste Ansatz.
> ob man die vorhandenen technischen Voraussetzungen nutzt
> ob man eigenen technische Voraussetzungen schafft (halte ich persönlich eher für ungünstig)
Ich kenne das Wiki von Zend nicht sehr gut. Aber bermutlich ist es wirklich einfacher, dieses zu nutzen.
> wer Interesse hat, sich an der Umsetzung zu beteiligen
ich :)
> was sonst noch so einfällt
- Baldige Umsetzung wäre toll. ;)
- Lizenz?
Freitag, 05.01.2007, um 00:55
Also das Tutorial an die Community zu übergeben halte ich für eine sehr gute idee.
Allerdings ist ein Wiki in meinen Augen als Tutorial ziemlich ungeeignet.
Ein Wiki bietet sich eher als ideale Begleitung und für weitergehende Lektüre.
Wenn ich ein Tutorial lese, erwarte ich eine Step by Step Anleitung die einem streng linearen Schema folgt (welches sich der Autor im Idealfall wohl überlegt hat [steigende Schwierigkeitsgrad, Abhängigkeiten etc]), und ein Wiki ist alles andere als Linear.
Freitag, 05.01.2007, um 10:51
Hallo Hans,
es kommt darauf an, wie man das Ganze umsetzt. Auf jeden Fall sollte der Schreibzugriff begrenzt sein, damit nicht jeder wie wild darum herum editiert. Dafür würden sich die Diskussionen besser eignen. Beim Aufbau des Tutorials müssen sich die Autoren dann aber auch zusammen reissen, damit es kein Chaos gibt. Alternativ könnte man natürlich auch ein anderes CMS aufsetzen, auf das nur ausgewählte Leute Zugriff haben.
Gruß,
Ralf
Freitag, 05.01.2007, um 12:06
@Hans und Ralf:
Ihr könnt euch ja kurz anschauen, wie ich mir das ungefähr gedacht habe: http://zftut.warui.info
setzt auf einem Dokuwiki auf, Registrierung ist obligatorisch. Und mit vernünftiger ACL kann man das sogar so machen, dass in einem Bereich die Tutorials geschrieben werden und in einem anderen können sie abgerufen werden, sobald sie verfügbar sind.
Tut mir leid, aber natürlich können Wikis linear sein. Hast du dir je Wikibooks angesehen?
Und dann wäre übrigens das ZF-Wiki auch nicht linear ;)
Übrigens bin ich nicht sooo überzeugt davon, dass es gut ist, wenn das alles auf dem Zend-Server liegt … wir hatten kürzlich schon nen Ausfall des Wikis für 5 Tage oder so und kein Statement, wann es denn wieder gehen wird.
Freitag, 05.01.2007, um 14:29
Nur mal so als Einwurf in die Runde, weil es mir gerade durch den Kopf schiesst:
Drupal mit dem Inhaltstyp “Book” – http://drupal.org/handbook/modules/book
Freitag, 05.01.2007, um 18:27
@Warui
das sieht doch schon mal ganz gut aus. Ich habe heute morgen eine Mail an das ZF Server Team gesendet und warte noch auf eine Antwort. Vielleicht könnten wir das Incubator Wiki auch dort anlegen oder aber es gäbe eine Möglichkeit, den Austausch zwischen den Wikis zu automatisieren. Ich denke, wir finden da schon einen Weg.
@Kaiuwe
Mit Drupal kenne ich mich nun gar nicht aus, aber wenn das Modul dafür gemacht wurde, wäre es durchaus eine Überlegung wert.
Samstag, 06.01.2007, um 04:22
Ich habe selbst keine Erfahrungen mit Drupal gemacht, habe mich heute aber mal umgehört.
Und die meisten haben mir davon abgeraten, teilweise, weil es wohl verdammt mies upzudaten ist.
Ist, wie gesagt, nichts persönliches ( ;-) ), ist mir nur so gesagt worden, und kann ich gerade nicht überprüfen.
Samstag, 06.01.2007, um 13:46
@Warui
Drupal funktioniert schon ganz prima, nur muss man wieder umdenken, da Drupal nur aus Funktionen besteht und keine Klassen verwendet. Es ist eine echte API vorhanden und Coding-Standards ebenfalls, aber wenn man vom Zend Framework kommt… ;-)
Updates lassen sich eigentlich ganz gut bewerkstelligen, nur muss man wirklich Plugins schreiben und nicht im Core spielen.
Aber egal, denn wie ich schon geschrieben habe, war dies nur ein einfacher Einwurf in die Diskussionrunde zum Thema “gemeinsam Tutorial schreiben”. Und warum persönlich nehmen? Ich habe das Ding nicht geschrieben! ;-)
Gruss
Kaiuwe
Montag, 08.01.2007, um 22:50
Als Veröffenltichungsform würden ganz einfach Webseiten in Kapiteln ausreichen.
Mag sein, dass man auc ein Wiki nehmen kann, aber es ist eigentlich nicht für so etwas gedacht und in meinen Augen auch nicht so gut geeignet. Mir persönlich wäre es am angenehmsten, wenn die Kapitel als pdf-Dokumente vorlägen. Das kann man dann alles irgendwie in den Ramen des zf-Forums eingliedern, sodass die Diskussion und die Fragen dazu dort diskutiert werden und nicht sonstwo.
Die ZF-Gemeinde sollte, finde ich, schon ein wenig beisammen gehalten werden.
Ich sehe mich selbst noch zu sehr als Anfänger, als dass ich mich sonderlich einbringen könnte, aber sobald ich einigermaßen flügge bin, würde ich anderen Anfängern Rat geben wollen, wenn ich kann. Schon aus Dank für die Ratschläge, die ich erhielt. Von diesem Mechanismus lebt ein Forum.
Also: Kein Wiki, kein Drupal, kein sonstiges Extraprojekt, sondern Eingliederung in die Community, die sich um das zf-Forum bildet. Das ist in meinen Augen die beste Lösung.
Martin
Dienstag, 09.01.2007, um 01:52
@Martin:
Mag sein, dass alles leichter erreichbar ist, wenn alles in einem Forum statt findet. Aber nichts für ungut, wer editiert das PDF, wenn jemand sagt “Hey, da auf Seite XXX, da ist ein Fehler, das ist doof”? Und womit?
Und wer hat Lust, seitenlange Tutorials in einem Forum zu diskutieren. Da verliert man doch den Verstand …
Und das Lesen derselben macht auch nicht viel Spaß …. frag mal Ralf, ein Blog ist dafür teilweise schon unpraktisch, und hier hat man wenigstens einen angenehmen Rahmen.
Und was machst du, wenn es mehr als, sagen wir mal, 10 Tutorials gibt. Kriegt jedes Kapitel (mit oder ohne PDF) seinen eigenen Thread? Und wieviel Threads hast du dann nach ein paar Monaten? Und wenn jedes Tutorial seinen eigenen Thread bekommt, dann verschlimmert sich das mit den Einwänden von oben nochmal.
Außerdem haben wir kürzlich imho am (originalen) Zend_Wiki gesehen, warum das schlecht ist, wenn alles auf einem Server liegt. Der ist nämlich schwuppsdiwupps mal für 7 Tage weg und dann ….?
Was ist schlecht an “Hier ist das Forum, da kriegst du den Sourcecode und dort gibt es eine Sammlung von deutschen Tutorials”?
Und zu der Idee mit den PDFs: Ich hab mir initial schon ein paar Gedanken gemacht, ob es nicht möglich ist, das in ein großes, böses LaTeX-Skript zu gießen … Schaun mer mal, das ist derzeit noch ungarer als ZF v2.0 ;-)
Donnerstag, 10.01.2008, um 10:03
Hi,
was ist nun?
Wer hilft mit im Wiki, das Tutprial auf ZF 1.03 umzuschreiben?
http://zftut.warui.info/
Gruß Clark
Mittwoch, 09.06.2010, um 00:00
Ist die Idee noch im Raum oder gibt es da schon andere Projekte die ich noch nicht gefunden habe
Mittwoch, 09.06.2010, um 07:35
Hier wurde das Tutorial weiter geführt, ist leider aber mittlerweile auch veraltet:
http://www.zf-tutorials.de/