feedback on Desktop Guide structure

[Matthew East]

On Sun, 2006-02-12 at 00:25 -0800, Brian Burger wrote:
> On 2/11/06, Karl Goetz <kamping_kaiser at internode.on.net> wrote:
> > I find the structure in the Ubuntu Desktop Starter Guide a little
> > annoying - clicking on common tasks give a list of categories within
> > common tasks (which is fine), but there is no indication of what's
> > inside those sub groups. even when you enter the sub group, you still
> > have to scroll through the page to see what's there - a list at the top
> > of the page, or on the 'common tasks' page would be good. This applies
> > for all the menus.
> 
> Hmm... could we get the <title> (or <sectX>) tags of each section to
> display on the opening page of each chapter?

This can be done easily enough for the html, indeed is already done.
I'll look into whether we can make the table of contents that already
exists on each chapter page in yelp a bit deeper. But, I'm not convinced
there is a problem, because the idea is that once you get as deep as
sect1, the subject matter of the section should be totally clear (music,
codecs etc). If it isn't, it's a bug in the document.

Indeed having deeper tables of contents might actually be pretty ugly,
given that some of the sections have a very large number of sub-sections
(e.g. common-tasks/internet, or configuring your system/desktop).

Matt
-- 
mdke at ubuntu.com
gnupg pub 1024D/0E6B06FF
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20060212/55bb2393/attachment.pgp>