Re: New website: what's the sense of '(main)'?

[John Mandereau]

Le dimanche 03 janvier 2010 à 01:52 +0000, Graham Percival a écrit :
> When you're clicked through a few options in a chapter, you've
> been staring at the highlighted second-level TOC changing.  It's
> not obvious how to get back to the first page, if you want to see
> the overview of pages in that chapter again.  This is a problem in
> the old website.

There is a quite explicit path with links at the bottom of each page,
e.g.

"""
Home > Introduction > Why use LilyPond?
"""

on http://lilypond.org/switch/advantages
It may not be visible enough, as it shows only at bottom of the page,
though.  Maybe we could print this just below the navbar on the new
website; actually, this is the only solution I currently see for the
issue you point out below.


> It might be obvious to some people with a CS background and
> knowledge of trees, but I remember being confused by this more
> than 5 years ago.  And if I can get confused, I'm certain that
> other people can get confused.

This is a good point, but putting this even on each chapter page
(Introduction, Download etc.), and at the left of entries of lower level
is confusing too, so this IMHO this "(main)" should be removed.


> I'll entertain a renaming (if introduction wasn't already taken,
> we could use that; I suppose we could even duplicate the
> chapter-name instead of (main)).

Yes, this "(main)" is ugly, the actual name of the chapter should be
used.

Anyway, this "(main)" is un-i18n-able, so I'll remove it (or comment it
out) along finalizing other changes to the init file (the navigation bar
with buttons of different colors that works for docs in all languages,
and the i18n of search-box.html being renamed to search-box.ihtml).

Best,
John

signature.asc
Description: Ceci est une partie de message numériquement signée