I found the Google code mod_wsgi wiki pages very useful and clear and
got mod_wsgi up and running quickly.

However, the 'Integration with Django' page (http://code.google.com/p/
modwsgi/wiki/IntegrationWithDjango) isn't as clear as the 'Quick
Configuration Guide' and 'Configuration Guidelines'. Perhaps it could
be made clearer by adding subheads, and appear more up-to-date as
follows:

1. Collect information and issues already raised in Django tickets for
any *pre-1.0* versions of Django, under a subhead 'Older versions of
Django', so users of recent (backward compatible) versions don't have
to see irrelevant info (e.g. 'Be careful using the BuildBot
djangorecipe version 0.17...', 'Django's WSGI adapter prior to alpha
versions of version 1.0...', 'HTTPS detection done by Django was wrong
for WSGI...' etc.).

2. Since (as I understand it) from Django 1.0, successive versions are
backward-compatible and the majority(?) of developers are using at
least that version, make it clear at the top (instead of 'Requires
Django 0.90') that these instructions apply mainly to Django >= 1.0,
then collect version-specific issues under the 'Older versions of
Django' subhead.

3. Separate Windows-specific information under its own subhead.

4. Perhaps similar for Apache - mention up front that the instructions
apply mainly to Apache 2.*, and - although they will also work with
1.* - the main difference is that WSGIDaemonProcess will not run.

5. It would - in the Python spirit - be good to have 'one obvious way'
of setting things up e.g. - daemon mode, an ideal directory structure
within a *nix user directory, a typical VirtualHost block, etc., then
cover other options afterwards.

If it helps, I'm a good sub-editor and have a passion for making
instructions as simple as possible, although I'm sure others in the
community are more knowledgeable.

-- 
You received this message because you are subscribed to the Google Groups 
"modwsgi" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/modwsgi?hl=en.

Reply via email to