On 8/31/13 at 9:10 AM, [email protected] (Paul Everitt) pronounced:
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?
Whenever the MVC topic enters discussions, it's not been during
the Quick Tour but when I give the elevator pitch for trying
Pyramid. The question boils down to, "Is Pyramid MVC?" to which
I reply, "Kind of, but better." That leads to this:
http://pyramid.readthedocs.org/en/master/designdefense.html?highlight=mvc#pyramid-gets-its-terminology-wrong-mvc
That question is used as a litmus test for frameworks being
"good", and to me it smells like the questioner does not really
understand what is the MVC pattern. I don't know of any web
framework that implements MVC as originally defined, so it's a
silly question to ask in the first place. If one evaluates a
framework on the basis of whether it follows the MVC pattern,
then they're doing it wrong.
So during an elevator pitch MVC is discussed, but not during the
Quick Tour. Adding MVC to the Quick Tour would be what is
called "talking over the sale". The user is already sold on
trying Pyramid, so why distract them when they want to take it
for a spin?
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.
Here's a link for a "note" admonition, which should include
exactly what Jonathan describes above.
http://docs.python.org/3/library/json.html#encoders-and-decoders
I'd point out it's a Python thing, not a Pyramid thing, to give
better context than "standard json encoder/decoder". When I
first heard the term "standard library", I had no idea that it
meant "Python standard library" and wrongly assumed that it
applied to the context where I experienced it first, namely Pyramid.
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.
To the cookbook!
http://docs.pylonsproject.org/projects/pyramid_cookbook/en/latest/deployment/index.html
A side note--and this is something that really confused me when
I first started reading the docs for Pyramid and all its related
projects--I got very confused about what was core Pyramid docs
and what was not. The docs sites look the same. I'd like to
see some designation for external versus internal links, which
would give new readers better context.
http://sphinx-doc.org/theming.html?highlight=externalrefs
--steve
------------------------
Steve Piercy, Soquel, CA
--
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.
