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

[Joe Gregorio]

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

-- 
Joe Gregorio        http://bitworking.org