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

Thu Mar 31 18:34:26 CEST 2011

On 2011年3月31日 18:47:39 +0300, Ezio Melotti <ezio.melotti at gmail.com> wrote:
> On 30/03/2011 23.20, Antoine Pitrou wrote:
> > On 2011年3月29日 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