CakePHP: CookBook

Si algo se le puede echar en cara a este framework es la documentación. Por lo que tengo entendido antes había un wiki en el que la gente intentaba ayudarse con código, comentarios y puntualizaciones. No sé qué motivó a descolgarlo, imho un wiki es una buena plataforma para generar información -supongo que spam o malos rollos-.

Después vino Bakery, una plataforma donde una vez registrado puedes agregar artículos, comentar otros y compartir conocimientos. No acabo de encontrarle el punto, además considero que no tiene documentación suficiente, hay varios artículos buenos pero no abarcan el grueso del framework ni de lejos. Con la salida de 1.2 se ha estado (re)escribiendo documentación en los famosos tempdocs. Si bien pretenden documentar lo que sería el manual de 1.1 para la nueva versión, solo hace falta echarles un vistazo para ver que están en fase bastante precaria y necesitan mucho desarrollo todavía. Sin embargo me atrevo a decir que es la fuente más fiable de documentación -aunue el formato sea un pelín engorroso.

El último movimiento -y creo que uno de los más importantes- ha sido crear el CookBook. Imagino que la idea viene a ser un poco similar al DjangoBook donde exista una plataforma *oficial* de documentación con ciertos comentarios y/o mejoras que irán aportando los usuarios. Esperemos que sea el movimiento definitivo, que los tempdocs se traduzcan cuanto antes al nuevo formato y que lo que -actualmente- es un inconveniente para gente que quiere desarrollar sobre CakePHP se resuelva de una vez.
code php

About the author

Óscar
has doubledaddy super powers, father of Hugo and Nico, husband of Marta, *nix user, Djangonaut and open source passionate.