Django documentation index redesigned

1 view
Skip to first unread message

Adrian Holovaty

unread,
Nov 18, 2008, 2:44:12 AM11/18/08
to django-d...@googlegroups.com
After months of being frustrated (and hearing other people being
frustrated) with our newish documentation index, I took some time
tonight to reorganize the links, to make it easier and faster to find
things. Take a look here:

http://docs.djangoproject.com/en/dev/

I opted for a much more compact approach, with related links
side-by-side. The previous version tended to organize each link based
on whether it was reference vs. an overview, but this new version
organizes by topic, instead.

The "Other batteries included" section is kind of a cop out. It's a
bit past my bedtime, so that's all I could come up with in a hurry.

Hope people find this easier and faster to use!

Adrian

Mike Scott

unread,
Nov 18, 2008, 2:47:38 AM11/18/08
to django-d...@googlegroups.com
+1!

Just one suggestion - if the final "bateries included" could be split into contrib apps, and core library that'd be nicer.

Clint Ecker

unread,
Nov 18, 2008, 11:54:42 AM11/18/08
to django-d...@googlegroups.com
Aw, I had actually started to like/get used to the old-new way ;)
--
Clint Ecker -- http://blog.clintecker.com
c: 312.863.9323
---
twitter: clint
skype: clintology
AIM: clintecker
Gtalk: clint...@gmail.com

David Cramer

unread,
Nov 18, 2008, 2:28:31 PM11/18/08
to Django developers
My only opinion, is beyond the tutorial, people would much rather
search then dig for the link :)

On Nov 18, 10:54 am, "Clint Ecker" <clintec...@gmail.com> wrote:
> Aw, I had actually started to like/get used to the old-new way ;)
>
>
>
> On Tue, Nov 18, 2008 at 1:44 AM, Adrian Holovaty <holov...@gmail.com> wrote:
>
> > After months of being frustrated (and hearing other people being
> > frustrated) with our newish documentation index, I took some time
> > tonight to reorganize the links, to make it easier and faster to find
> > things. Take a look here:
>
> >http://docs.djangoproject.com/en/dev/
>
> > I opted for a much more compact approach, with related links
> > side-by-side. The previous version tended to organize each link based
> > on whether it was reference vs. an overview, but this new version
> > organizes by topic, instead.
>
> > The "Other batteries included" section is kind of a cop out. It's a
> > bit past my bedtime, so that's all I could come up with in a hurry.
>
> > Hope people find this easier and faster to use!
>
> > Adrian
>
> --
> Clint Ecker --http://blog.clintecker.com
> c: 312.863.9323
> ---
> twitter: clint
> skype: clintology
> AIM: clintecker
> Gtalk: clintec...@gmail.com

J. Cliff Dyer

unread,
Nov 18, 2008, 2:38:54 PM11/18/08
to django-d...@googlegroups.com
I like the new new version much better.

With the old new one, I kept going through the search bar, and contrary
to David Cramer's opinion, I like being able to drill town to what I'm
looking for (as long as it's not frustrating trying to find it). It
gives me the sense that I know where I am, and that I could send someone
else to the right place if I needed to.

Cheers,
Cliff

Florian Apolloner

unread,
Nov 18, 2008, 5:53:30 PM11/18/08
to Django developers
Yeah, I really like it. Now I am able to jump to the Queryset-methods
etc right from top page and don't need to dig through subpages (I
always took me hours to find the builtin filters/tag reference) :)

Thx,
Florian

Andrews Medina

unread,
Nov 18, 2008, 6:11:15 PM11/18/08
to django-d...@googlegroups.com
On Tue, Nov 18, 2008 at 5:47 AM, Mike Scott <mic...@gmail.com> wrote:
> +1!
>
> Just one suggestion - if the final "bateries included" could be split into
> contrib apps, and core library that'd be nicer.

+1

--
Andrews Medina
www.andrewsmedina.com

Ludvig Ericson

unread,
Nov 18, 2008, 7:47:23 PM11/18/08
to django-d...@googlegroups.com
On Nov 19, 2008, at 00:11, Andrews Medina wrote:

>
> On Tue, Nov 18, 2008 at 5:47 AM, Mike Scott <mic...@gmail.com> wrote:
>> +1!
>>
>> Just one suggestion - if the final "bateries included" could be
>> split into
>> contrib apps, and core library that'd be nicer.
>
> +1

Why are you +1ing a change that has been made? ;P

I like it either way. Actually I'd like it if things stuck to one
way. :-)

Haroldo Stenger

unread,
Nov 19, 2008, 2:17:31 PM11/19/08
to django-d...@googlegroups.com
Adrian,

I think this reorganization of Django's documentation is a Big Step Forward. Congratulations. Not only this will be very important for Django adoption and public consideration, but also it will model other systems' documentation, methinks.

best,

haroldo
Reply all
Reply to author
Forward
0 new messages