[Python-Dev] [Web-SIG] wsgiref doc draft; reviews/patches wanted (original) (raw)
Joe Gregorio joe.gregorio at gmail.com
Fri Jun 9 18:40:33 CEST 2006
- Previous message: [Python-Dev] [Web-SIG] wsgiref doc draft; reviews/patches wanted
- Next message: [Python-Dev] 'fast locals' in Python 2.5
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]
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 'simpleserver' 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
-- Joe Gregorio http://bitworking.org
- Previous message: [Python-Dev] [Web-SIG] wsgiref doc draft; reviews/patches wanted
- Next message: [Python-Dev] 'fast locals' in Python 2.5
- Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]