On 3 Mar 2011, at 14:18, Alexander Sergeyev wrote: > Bulat, > you're bright enough to write MVC framework documentation so your fiancee > could use it to build website for her handcraft boutique? To date I see > you're a bright developer and If i suggest you to be more friendly you > wouldn't understand me without details. So cancel updates on this topic and > move along to new issues if you don't like details. Besides details are > summed up already and now I reply those greats developers who asked the > questions. Peace.
Hi Alexander, I didn't get an answer: have you've read "From flat PHP to Symfony2" at http://docs.symfony-reloaded.org/master/book/from_flat_php_to_symfony2.html . Is this the documentation you are complaining about, or is it the PR6 documentation at http://docs.symfony-reloaded.org/, or just the "Quick Tour"? I want to be sure that we aren't arguing about a problem that has already been solved. Assuming you take exception to the current state of symfony2 book, not the PR6 docs or the quick tour: The main documentation for any project should be written with the specific target audience of that project in mind. If you write documentation that assumes the reader doesn't know PHP and concepts such as OO, then the documentation will not be useful to people who do. It will be obstructive and irrelevant. Wordpress and Drupal need documentation for people who aren't necessarily programmers, because they have been designed to be used by those people. Symfony2 is designed for programmers. The book documentation doesn't expect them to be _advanced_ programmers, but it does expect them to know which way around the <?php ?> brackets go. I think that's exactly right. I love how ">From flat PHP to Symfony2" explains MVC in such a clear step by step way with examples of each transition. It couldn't be more useful to an average PHP coder. I agree that it _would_ be nice to see an alternative documentation that teaches programming and PHP from scratch, maybe introducing concepts through real-world analogy, and then moving on to using advanced frameworks like Symfony2, but that's absolutely not the job of the _main_ Symfony2 documentation. It's reasonable to expect people who are new to Symfony2 to at least be familiar with basic PHP concepts. That is the audience that Symfony2 has been written to be used by, and the primary documentation should be aimed at those people, otherwise it will fail to be useful. -- Matt -- If you want to report a vulnerability issue on symfony, please send it to security at symfony-project.com You received this message because you are subscribed to the Google Groups "symfony developers" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/symfony-devs?hl=en
