Django documentation index redesigned

[Adrian Holovaty]

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]

+1!

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

[Clint Ecker]

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]

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]

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]

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]

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]

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]

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