Hi Halfer, Thanks for your great work. This is going in the right direction. I hope the tutorial can be made accessible within days - every day count, especially since symfony is 'in the news' because of the symfony camp.
Now if you want my "expert view", here it is. Try to avoid using "we". I know the original tutorial has some of these, but either the reader is doing the tutorial (and that's "you" or "do that"), or we're doing it together, but then it should be "we" everywhere. Since the symfony book uses the first form, I advise removing all "we" instances. Note that "Let's" works fine. Keep the tutorial fast and simple. Add more references to the doc (for instance about forms). I think the security part at the end of the tutorial should teach the user how to install and configure sfGuardPlugin rather than explain another form object. Forms have already been introduced before at that time, so it's not worth talking about it again. Incidentally, that would introduce plugins, which are a great strengh of symfony, and you could include a link to the plugins page. Last but not least, sfGuard is used in a large majority of projects, so showing how to use it in a First Project tutorial makes sense. As for the sfForms part itself, I got lost reading it. I think you try to explain too many things. You should just tell that a form is automatically generated for Propel objects and that you can already use it (show a screenshot), then explain how to customize it in a very simple way - and in the right order. Don't show the code of BaseBlogCommentForm. Pass the FK argument to the form before showing how the form constructor can use it. Show a screenshot of the form before and after your changes. If you can, cut this part by 50%, or users might run away. I'd even encourage you to remove all mention of the new form system from this tutorial, because this part of the framework is way too complex for a beginner. But that's only my personal opinion. François 2008/9/18 halfer <[EMAIL PROTECTED]>: > > Hi Francois > > It's nearly done: > > http://www.symfony-project.org/tutorial/1_1/my-first-project > > You're right, it is important, and although I'm not an official > contributor I have made substantial changes to what was effectively > the 1.0 version. It is good to use already, although (as per the > warning at the top of the page) the screens have not been re-captured. > I won't be able to do that this week (maybe next) but if someone wants > to do that for me, that'd be great. Once the screens are done I > suggest it is ready to link from the 1.1 docs page. > > Of course your expert view on the quality of the new tutorial would be > most welcome. I can also send anyone the tarfile of the tutorial if > anyone wants it. > > Jon > > > > --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
