On Wed, Feb 11, 2009 at 6:52 AM, Greg Ewing <greg.ew...@canterbury.ac.nz> wrote: > > Alex Gaynor wrote: > >> As I said above, a checkout of the django source includes all the docs, >> which can be built into nice HTML just as online with the sphinx module >> for python. It takes all of 30 seconds. > > Only if you have all the necessary tools and dependencies > installed and working, which not everybody does, especially > on Windows.
Well... there's your problem right there. :-) > Besides which, you're *already* building the html yourself > for the web site, so why not make it easily available? Refusing > to do so seems pointlessly obstructive. Yes. We want to make sure you never get any work done. We want to put roadblocks on your road to world domination. Seriously - dial down the rhetoric a bit. If you are unhappy with the service you have received, we will happily give you a 100% refund of your purchase price. We already provide up-to-date generated HTML documenation. We just don't provide it in a nice tarball to download. If you can't install Sphinx and build the documentation yourself, then how about using wget or any one of the several thousand site mirroring tools that are in existence? Building the infrastructure to handle automatic downloads is not a 0 effort activity. Someone needs to write the code, and someone needs to maintain it. Unfortunately (for you), in the opinion of the core developers, this simply isn't worth the effort. While there is an occasional (and usually very vocal) request for downloadable documentation, in our estimation this is a very small group. We can spend our time trying to satisfy this group, or we can spend our time improving Django - for example, by adding aggregates and query expression to the ORM. We have decided to do the latter. Also - one of the benefits of using ReST as a source format is that it is actually human readable. If you put the ducks in a row to use Sphinx, and you can't find a site mirroring tool, you can still read the raw ReST sources. Yours, Russ Magee %-) --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "Django users" group. To post to this group, send email to django-users@googlegroups.com To unsubscribe from this group, send email to django-users+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/django-users?hl=en -~----------~----~----~----~------~----~------~--~---
