[Python-Dev] [Web-SIG] wsgiref doc draft; reviews/patches wanted
joe.gregorio at gmail.com
Fri Jun 9 18:40:33 CEST 2006
On 6/9/06, Phillip J. Eby <pje at telecommunity.com> wrote:
> >4. I believe the order of submodules presented is important and think that
> > they should be listed with 'handlers' and 'simple_server' first:
> I agree that the order is important, but I intentionally chose the current
> order to be a gentle slope of complexity, from the near-trivial functions
> on up to the server/handler framework last. I'm not sure what ordering
> principle you're suggesting to use instead.
When I first hit the documentation I was confused by the order.
This is wsgiref, a reference implementation of wsgi and I expected
wsgi servers and middleware, actual implementations of WSGI, to be
the most prominent part of the library and thus presented first.
The utility functions would come afterward, after you got the basic
wsgi pieces in place.
Joe Gregorio http://bitworking.org
More information about the Python-Dev