I understand this product is free and without guarantee. And I also understand that the community should contribute to the documentation, in the spirit of open source. What I have a problem with is that the main owners of this project must know the main documentation has completely wrong information in it. It would be a simple task to put a disclaimer on the documentation website saying 'this documentation is wrong'. Moreover, they are selling books for $40 USD with presumably this same wrong information.
I have spent a lot of time trying to figure out how to use the 1.3/4 forms system, etc. and it's almost impossible with the state of this documentation. For example, the documentation is wrong:
in http://www.symfony-project.org/gentle-introduction/1_4/en/10 -Forms
, reference to method sfForm::setNameFormat:
But this method doesn't exist!
If I would have known up-front that the documentation was wrong I would have just stuck with symfony 1.0.
So I know a lot of people will get angry at this post and say 'so why don't you write documentation'. After I finish this project which I'm now struggling to finish on a tight deadline because of this documentation, I will. Also I really appreciate the developers efforts here, it's a fantastic product (if I can just figure out how to use it). But I would appreciate if the website was also a little more honest and forthcoming about the state of the documentation, currently it's very misleading. In my opinion 1.3/1.4 is not production ready if the documentation is wrong.
Thank you, -Tom