Hacker News new | past | comments | ask | show | jobs | submit login

I don't get it, what does providing a pdf or zipped html files have to do with installing?

Flask does this[0], and so does ReadTheDocs.

It isn't clear to me what is stopping Django from providing precompiled docs, bandwidth costs?

[0] http://flask.pocoo.org/docs/




You know, I'm not sure what I was thinking when I wrote that. There's no real great reason to avoid doing it other than download size, and I doubt that's a huge issue. Right now I think they're just doing releases as a .tar.gz archive of the checkout files. That'd mean an extra "build" step at release time, but that's probably trivial to automate.

That said, the source text files for the documentation are included, and whatever markup format they use (reStructuredText?) is relatively legible. HTML docs would be better, though.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: