2006/8/13, jws <[EMAIL PROTECTED]>: > [snip] > > Given the recent security problems with Rails, it's clear that the RoR > community is not infallible. Why have they then received so much praise > and admiration? It's not the technology, it's the narrative.
37signals is the best Buzz2.0 company you know :-). > > The Rails community hit this one out of the park with their > screencasts. When evaluating frameworks, you want to get a feel for how > it works in broad terms. This is not the same as 'well-documented'. > Documentation tells you how product features work, a narrative tells > you how use the product. A tutorial should never tell me to refer to > the documentation of another project. Zope is well-documented, but try > explaining it to someone who's never used it before. Likewise, A wiki > is great for reference material, but it's no replacement for a > step-by-step walkthrough of actually doing work in the product. The > point is not that you can create a blog or wiki in 15 minutes, > > It's that you can understand _how_ to_ in 15 minutes! Just a testimony, I have to learn symfony php framework (django rox but my boss no...) recently and I'm really surprised by the quality of the documentation. Have a look at: http://www.symfony-project.com/content/documentation.html It's really clear: you have tutorials on the top and documentation at the bottom. I think it's interesting to have two kind of tutorials for Django too: * a quick one for a first overview. * a second one for a real site, everybody knows that a real site can't be done in 15 minutes! For the moment, polls app is great but not as fast as "create a blog in 5 minutes" (and with generic views it's possible to do that). In this case, the user doesn't understand exactly what happens but he is really impressed and want to know more about this wonderful framework. Next step is the real site one which explain exactly what happens and Django mechanisms. This one can be detailed and follow a kind of time line to reflect the "reality" of the tutorial. Just my 0.2cts David --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Django users" group. To post to this group, send email to django-users@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/django-users -~----------~----~----~----~------~----~------~--~---
