On 8/14/13 4:45 PM, Jonathan Vanasco wrote:
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.
My guess is that this is too much detail for a Quick Tour. But it
probably should be in the main docs.
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";
)
That would be good to link to, yes.
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.
I'll admit that I never found the MVC/MVT discussion all that useful for
the target audience of the Quick Tour. I'd like to hear from Steve, who
has been giving some Pyramid presentations to outsiders. Steve, has
anybody asked about it? Do you think we should make mention of it?
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.
Yes, I should do a warning about that, as you mention.
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
I originally thought that the Quick Tour audience wouldn't care much
about it, but I suspect it is worth pointing out the deployment choices.
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."
Good wording, thanks!
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.
True.
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.
Yeh, I got that from the existing tutorial, which means that also needs
to be fixed.
--Paul
--
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.
