[Python-Dev] devguide: Add a table of contents to the FAQ.

[R. David Murray]

On Thu, 31 Mar 2011 18:47:39 +0300, Ezio Melotti <ezio.melotti at gmail.com> wrote:
> On 30/03/2011 23.20, Antoine Pitrou wrote:
> > On Tue, 29 Mar 2011 21:00:22 +0200
> > ezio.melotti<python-checkins at python.org>  wrote:
> >> http://hg.python.org/devguide/rev/f722956afeac
> >> changeset:   405:f722956afeac
> >> user:        Ezio Melotti
> >> date:        Tue Mar 29 22:00:13 2011 +0300
> >> summary:
> >>    Add a table of contents to the FAQ.
> > Could it be collapsed by default?
> 
> I don't think there's an easy way to collapse it by default.
> In most of the cases I anyway check the FAQ for something specific.  
> Having a list at the top provides an overview of the questions and also 
> an easy way to locate and jump to the right answer.
> 
> >   It's quite long, and redundant with the sidebar.
> 
> The list is indeed redundant, but the sidebar is not really usable here.

I agree with this point.  The sidebar list of questions is effectively
useless.

Most FAQ lists start with the long list of questions.  I don't see
why this one should be different :)

--
R. David Murray           http://www.bitdance.com