Re: FAQ TOC

From: Kinkie <kinkie-dev@dont-contact.us>
Date: Mon, 21 Aug 2006 17:23:39 +0200

On Mon, 2006-08-21 at 17:04 +0200, Henrik Nordstrom wrote:
> mån 2006-08-21 klockan 15:23 +0200 skrev Kinkie:
>
> > The expanded TOC is now available as
> > http://wiki.squid-cache.org/SquidFaq/FaqIndex
>
> Looks good. Can you move that up to http://wiki.squid-cache.org/SquidFaq
> please? The collapsed TOC isn't that useful, and having two pages which
> needs to be maintained just asks for trouble later on..

I'm not totally convined about doing this because
- the full index is pretty long and cluttered, and it's just a click
away anyway
- the hand-built index allows for some concise summary about what's in
the pages
- the full index can be fully self-updateable if we accept the drawback
that it will sort pages by page name rather than by faq section order.
- I tend to keep the wiki on a short leash (thanks to RecentChanges and
a blanket page-change notification), mostly out of fear of wiki spam. As
an example today Steven Wilton added a section dealing specifically with
COSS, without updating the index (Steven, thanks for contributing, and
shame on you for not giving your work proper visibility :). I updated
both indexes within 10 minutes of the faq page being added.

This said, I'm not opposing the idea; I'd just like to get more reasons
to do it :)

   Kinkie
Received on Mon Aug 21 2006 - 09:23:47 MDT

This archive was generated by hypermail pre-2.1.9 : Fri Sep 01 2006 - 12:00:03 MDT