On Tue, Feb 10, 2009 at 4:52 PM, 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. > > 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. > > -- > Greg > > > > I don't mean to be rude, but the development tools needed(Sphinx) aren't particularly difficult to install, and really are a valuable resource to have. Prebuilding the docs means that either the developers need to remember to build the docs before each checkin, or a post-commit hook needs to be added to build them(assuming this is possible) both of which incur additional overhead on the django developers to the benefit of the subset of the community that both doesn't have constant access to the internet(not an unreasonable situation) and who don't have Sphinx installed(which I would consider unreasonable for someone who knows they can't access the web docs). These are just my thoughts, I'm not a core dev, but I'd rather they spent their time working on Django than remembering to rebuild the docs and fiddling with SVN post commit hooks. Alex -- "I disapprove of what you say, but I will defend to the death your right to say it." --Voltaire "The people's good is the highest law."--Cicero --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
