quick thoughts... C Extensions
http://docs.pylonsproject.org/projects/pyramid/en/master/quick_tour.html#python-setup > Also, Pyramid has some optional C extensions for performance might be nice to link to which ones. Pyramid for Web Developers http://docs.pylonsproject.org/projects/pyramid/en/master/quick_tour.html#views > For the examples above, the hello_world function is a “view”. In Pyramid, views are the primary way to accept web requests and return responses. I'd suggest a quick overview of pyramid's appraoch to model/view/controller ( which is at the bottom of http://docs.pylonsproject.org/projects/pyramid/en/master/narr/introduction.html#what-is-the-pylons-project in a sidebar - "http://docs.pylonsproject.org/projects/pyramid/en/master/narr/introduction.html#what-is-the-pylons-project"; ) It might also make sense to add something to the effect of "Insofar as to offer some clarity to people familiar with MVC or MVT patterns, Pyramid's Resource View approach offers a similarly structured separation of data storage, business logic, and templating. JSON http://docs.pylonsproject.org/projects/pyramid/en/master/quick_tour.html#returning-json The standard json encoder/decoder ( and consequently json renderer ) doesn't handle datetime objects – something that has come up a few times. it might make sense to link out to that in the 'warning' box , and extend this url with one -- http://docs.pylonsproject.org/projects/pyramid/en/master/narr/renderers.html#adding-and-overriding-renderers Application Running with pserve > http://docs.pylonsproject.org/projects/pyramid/en/master/quick_tour.html#application-running-with-pserve possibly mention that pserve runs the application on waitress. also note that on http://docs.pylonsproject.org/projects/pyramid/en/master/narr/project.html#what-is-this-pserve-thing it's noted on the "using an alternate server below", but its a little weird to only find out what you're using in a section dedicated to using something else. Other docs - using alternate wsgi server http://docs.pylonsproject.org/projects/pyramid/en/master/narr/project.html#using-an-alternate-wsgi-server this talks about gunicorn, but i think more people have been using/talking about uwsgi Logging http://docs.pylonsproject.org/projects/pyramid/en/master/quick_tour.html#logging > Fortunately Pyramid uses the normal Python approach to logging. Might be good to stated something like "Pyramid is tightly integrated with the standard, and trusted, Python standard logging module. Pyramid's configuration file gives you full control of how and where to log. Your web application simply uses the standard Python logging facility, and you can direct output from all the packages you use." Some frameworks past, possibly present, have their own logging facility and things get messy. This is honestly a really good, simple and stupid thing. Databases http://docs.pylonsproject.org/projects/pyramid/en/master/quick_tour.html#databases 1. Might be a good idea to have a sidenote that you can use nosql databases. 2. the view code has "one = DBSession.query(MyModel)..." I really recommend the docs stay away from addressing the global sqlalchemy session/factory, and talk about a local session. -- You received this message because you are subscribed to the Google Groups "pylons-discuss" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/pylons-discuss. For more options, visit https://groups.google.com/groups/opt_out.
