[Python-Dev] [Web-SIG] wsgiref doc draft; reviews/patches wanted

Joe Gregorio 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 mailing list