As the first beta version of symfony 1.2 is about to be released (expect some more information from Fabian Lange, the release manager of 1.2, really soon now), I want to have a look at the current state of the documentation for this new version and what must be done before the final release.
The symfony blog
During the development of symfony 1.2, we have tried to publish a lot of blog posts about the new features, small and big. You can read useful information about the new REST architecture or about the new admin generator.
You can expect more blog posts like those in the coming weeks. Some of the tutorials we have published on the symfony blog have also been added to the cookbook.
We have more than doubled the number of tutorials in the cookbook between symfony 1.0 and 1.2, with a total of 24 tutorials.
The following tutorials have been added for symfony 1.2:
- How to unit testing your models
- How to customize the Web Debug Toolbar
- How to implement a conditional validator
- How to customize Error Templates
- How to implement a choice in a form
- How to test an application
- How to get started with Doctrine
As for symfony 1.1, you can read the upgrade instructions for symfony 1.2. This tutorial contains everything you need to know for upgrading your symfony projects.
We have also written a What's new? tutorial where existing users of symfony will find all the new features explained. So, instead of re-reading the whole symfony book trying to spot new things, you can just read this tutorial and you will learn all the enhancements and new features at your disposal in symfony 1.2.
Speaking of work that still need to be done, the symfony book has not been updated yet, except for the chapter about the new admin generator.
We were waiting for the final set of features to start updating the book. Just after the release of the first beta, we will start the update process, which will be quite easy as everything has already been documented in the What's new tutorial.
The community has also made a lot of efforts on the translation side of things. Some new tutorials have already been translated in several languages. If you want to help, please subscribe to the symfony docs mailing-list.
The new admin generator also comes with built-in translations in more than 21 languages.
We have never been so active on the symfony documentation, and I really hope you will enjoy what we have already published. That's already a lot, but there is still some work to be done, so, expect more to come in the coming weeks.