Re: gunicorn in docs

2011-09-23 Thread Russell Keith-Magee 
On Sat, Sep 24, 2011 at 8:12 AM, Paul McMillan  wrote:
> If you write a good and comprehensive set of instructions for making
> django work with gunicorn, and are willing to keep them up to date, I
> see no reason we shouldn't include them. It's what I use, and has the
> advantage of being very, very easy to get working.

I agree with Paul that this would be a good contribution -- however, I
would provide one piece of guidance.

There's a fine line between documentation for how to get Django to
work with Gunicorn (or any other web server for that matter), and
providing documentation for Gunicorn itself. The right place for
canonical Gunicorn documentation is the Gunicorn project, not Django.

There is certainly room for documentation on how to get Django running
under Gunicorn. However the bits in Django's documentation should be
restricted to the Django-specific parts -- Django-specific settings,
configuration requirements, and maybe some guidance on how Django
interacts with any tuning parameters (e.g., Django uses a lot of X,
but not much Y, so you'll get better performance if you configure the
web server to allocate extra X at the expense of Y).

If you find yourself writing explanations for every setting in
Gunicorn, then you should be directing the reader to Gunicorn's
documentation on those settings; and if Gunicorn doesn't have adequate
documentation on those settings, then that's a contribution you should
be making to Gunicorn.

Yours,
Russ Magee %-)

-- 
You received this message because you are subscribed to the Google Groups 
"Django developers" group.
To post to this group, send email to django-developers@googlegroups.com.
To unsubscribe from this group, send email to 
django-developers+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/django-developers?hl=en.

Re: gunicorn in docs

2011-09-23 Thread Paul McMillan 
If you write a good and comprehensive set of instructions for making
django work with gunicorn, and are willing to keep them up to date, I
see no reason we shouldn't include them. It's what I use, and has the
advantage of being very, very easy to get working.

-Paul

-- 
You received this message because you are subscribed to the Google Groups 
"Django developers" group.
To post to this group, send email to django-developers@googlegroups.com.
To unsubscribe from this group, send email to 
django-developers+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/django-developers?hl=en.

gunicorn in docs

2011-09-23 Thread Wim Feijen 
Hello,

After watching glyphs talk [1], do we want to add a gunicorn
installation instruction to the installation docs? What is your
opinion?

Wim

[1]: http://blip.tv/djangocon/keynote-glyph-lefkowitz-5573264

-- 
You received this message because you are subscribed to the Google Groups 
"Django developers" group.
To post to this group, send email to django-developers@googlegroups.com.
To unsubscribe from this group, send email to 
django-developers+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/django-developers?hl=en.