Christopher Arndt schrieb: > I just created a diagram showing how the different parts of TurboGears > interact on a high-level. This updates the outdated one on the > 1.0/BigPicture page in the docs wiki, something I wanted to do for a > long time. > > http://docs.turbogears.org/1.1/BigPicture > > Though this is meant for the TG 1.1 documentation, if you replace > "CherryPy" with "Pylons" and "Request filters" with "WSGI middleware", I > think it also reflects the way TG2 works as well. > > I have attached a JPG, a PNG, a PDF and the OpenOffice draw file to the > page given above. Feel free to use it in other contexts and of course > comments, corrections, suggestions for improvement etc. are always welcome!
Cool. A pic says more than 1000 words. We probably cannot overrate the importance of such diagrams, particularly the "big picture" in our docs. Some suggestions: * Model and controller show the file names in a quickstarted project. View should als mention /templates (maybe even indicate master/page templates). Static ressources belong in a separate box IMHO. * It looks like the return value of the controller is the rendered page which is not true and can confuse new users. The old picture showed the work flow up to the final response better, including the JSON shortcut. * I would not label SQLAlchemy as "database adapter", but as ORM & SQL tookit, since it can be confused with the DBAPI2 adapter which should be visible as small separate layer between SQLAlchemy and the Data Storage. * Widgets are not in the picture though they are an important part of TG. I remember I missed them also in the old picture. And since this is about TG1, I would also show MochiKit (connected with widgets). -- Christoph --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "TurboGears" 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/turbogears?hl=en -~----------~----~----~----~------~----~------~--~---
