Why all the empty pages?

Brian Burger blurdesign at gmail.com
Mon Sep 12 23:37:45 UTC 2005


On 9/12/05, matthew.east.ubuntu at breathe.com
<matthew.east.ubuntu at breathe.com> wrote:
> Duncan Lithgow writes:
> 
> > Brian Burger wrote:
> >> I'm not sure that spreading stuff out to multiple pages is really
> >> useful; UserDoc is supposed to be a general index already.
> > You mean UserDocumentation right?

Yes, sorry. UserDoc is easier to type out that UserDocumentation all
the time, though.

> > You could say it's an index, but it's so full of stuff that it reads more
> > like the index at the back of a book- without a structure that's easy to
> > grasp. 
>
> I don't really like this idea that much. I prefer the page to be complete
> and searchable. Given that the wiki search facility leaves a little to be
> desired, it was our intention with UserDocumentation to make as complete an
> index as possible. Naturally it is important for users to be able to find
> which chapter/section they need: in my opinion this can be achieved with an
> efficient structure on the one page, with an intuitive table of contents.

Matt's just summed up - better than I could - why removing stuff
arbitrarily from UserDoc is not a good idea.

> I think it is important we discuss these ideas a bit before implementing
> them, because I'm sure many people who have worked on this page will have
> opinions on them!

Likewise - UserDoc *is* the central page of the wiki for regular
users, so we need to be cautious about reworking it too drastically.

Brian
- irc:Madpilot -




More information about the ubuntu-doc mailing list