3 ms·

I just got back into Django heavily after a 4 year hiatus - It's a little frustrating that even though the platform has evolved, the documentation has gotten m

I just got back into Django heavily after a 4 year hiatus - It's a little frustrating that even though the platform has evolved, the documentation has gotten much much worse.. back in 2008 the docs were one of the best things about Django but today they are just a total headache. The documentation is impossible to search using the built in search functionality, because it only returns a fraction of the right results. There are tons of omissions - key classes, methods etc that are only mentioned casually in bits and pieces. Lots of pages of documentation you can't even find without Google which half the time indexes docs for pages that are 4 versions outdated... Also frustrating how much the admin is still frozen in 2008, the options out there for responsive themes are really clumsy at best. I was trying to introduce junior devs to Django this month and all they see is an outdated interface and really really confusing documentation, it's a real turnoff

wldcordeiro 12y ago
That's odd, I've been using Django for 6 years now and to me it seems like the documentation has improved.
- rwhitman 12y ago
  If I had been using it every day since 2008 or so I probably wouldn't have seen the issue. Coming back to djangoproject.com after 4 years, it now feels like kind of a rats nest. Really wish they'd offload the documentation to ReadTheDocs.org, I love the information architecture of that site
  - wldcordeiro 12y ago
    They kind of do, if you look at their offline documentation download links they say that they're powered by Read The Docs.
rwhitman 12y ago
Gosh downvoted by Django devs, ouch.. don't want to sound ungrateful, a big amazing open source project built by very smart people, after almost a decade the documentation's bound to get a little unruly.. just been bashing my head against the wall trying to re-master django over the last few weeks and OP's topic hit a nerve

wldcordeiro 12y ago

That's odd, I've been using Django for 6 years now and to me it seems like the documentation has improved.

rwhitman 12y ago
If I had been using it every day since 2008 or so I probably wouldn't have seen the issue. Coming back to djangoproject.com after 4 years, it now feels like kind of a rats nest. Really wish they'd offload the documentation to ReadTheDocs.org, I love the information architecture of that site
- wldcordeiro 12y ago
  They kind of do, if you look at their offline documentation download links they say that they're powered by Read The Docs.

rwhitman 12y ago

Gosh downvoted by Django devs, ouch.. don't want to sound ungrateful, a big amazing open source project built by very smart people, after almost a decade the documentation's bound to get a little unruly.. just been bashing my head against the wall trying to re-master django over the last few weeks and OP's topic hit a nerve