Zu meinen reinen Freelancer-Zeiten arbeitete ich ja einige Zeit regelmäßig mit dem MVC-Framework CakePHP, seit Ende letzten Jahres jedoch leider wieder etwas weniger. Das lag zum einen daran das sich meine Aufgabengebiete etwas verschoben haben, zum anderen jedoch an der bis Dato wirklich bescheidenen Dokumentation des Frameworks.
Es gab zwar eine grobe API in der man sich im Notfall z.B. mal ansehen konnte wie einer der Standardhelper überhaupt arbeitet und welche Variablen man einer Funktion überhaupt übergeben kann, um damit dann sein Script zu debuggen, doch am Ende führte dies zu etlichen Stunden von Try & Error.
Nun habe ich mich mal wieder an ein kleines Projekt gewagt was wieder mit CakePHP 1.2 umgesetzt wird, und ich bin begeistert was sich in der Dokumentation so alles getan hat. Mit dem Cookbook kann man endlich richtig arbeiten! Alles ist ordentlich gegliedert und auch die Suche spuckt endlich passable Ergebnisse aus. So habe ich mich z.B. vorher nie an die Auth-Component heran gewagt, einfach weil ich kaum etwas über sie wusste.
In der neuen Dokumentation wird einem nun endlich alles erklärt was man braucht. Es werden direkte Codebeispiele und Vorschläge ausgegeben, so das es wieder richtig Spaß macht sich an neuen Cake-Entdeckungen zu versuchen.
Wer sich also bisher aufgrund der noch schlechten Dokumentation mit CakePHP nicht anfreunden konnte, dem sei ein zweiter Versuch ans Herz gelegt!
Wie ich beim Cakebaker gerade lesen konnte, gibt es nun eine erste richtige Dokumentation zur CakePHP 1.2 Alpha.
Bisher konnte man sich bereits mit einer frühen PDF-Version begnügen, doch die jetzt veröffentlichte Version scheint doch um einiges ausführlicher zu sein und ist zudem nicht in einer so unleserlichen Schrift ins Netz gestellt worden.
Aus meiner Sicht ist das ein wichtiger Schritt in Richtung 1.2, denn ohne eine ordentliche Dokumentation fällt einem die Programmierung wirklich etwas schwer, gerade wenn man noch ganz frisch in CakePHP 1.2 ist.
Die Dokumentation ist jedoch leider bei weitem noch nicht komplett und soll daher in der nächsten Zeit ständig erweitert werden.
Update
Leider wurde die Dokumentation fürs offene Netz gesperrt. Den Sinn dahinter kann ich jetzt aufs erste überhaupt nicht deuten. Hoffen wir mal das sie einen guten Grund dazu hatten uns einfach so vor die Tür zu setzen.
Noch ein Update
Gerade im CakePHP-Channel von PHPNut: “That site was not ready to be released to the public. We will make an official announcement when it is ready”. So richtig verstehen will ich das nicht, aber es ist zumindest ein Grund.
Und noch ein Update
Die Doku scheint jetzt wieder Online zu sein. Wer auf Nummer sicher gehen möchte der sollte sich die Doku diesmal wohl lokal abspeichern :)
