[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Contributor's Guide on Website
From: |
Patrick McCarty |
Subject: |
Re: Contributor's Guide on Website |
Date: |
Thu, 7 Jan 2010 18:48:24 -0800 |
User-agent: |
Mutt/1.5.20 (2009-06-14) |
On 2010-01-07, Carl Sorensen wrote:
>
> On 1/7/10 6:56 PM, "Patrick McCarty" <address@hidden> wrote:
>
> > On 2010-01-07, Carl Sorensen wrote:
> >>
> >> A perfect page for me would have all of the manuals easily available in
> >> split HTML format once I get to that page.
> >
> > +1
> >
> > If you don't mind, I want to address a more general issue that's been
> > bothering me lately.
> >
> > IMO, the most distressing navigational problem about the new website
> > is that there are *too* many web pages.
> >
> > Back when we starting working on the constructing the website (in the
> > summer), this didn't bother me. But now, I would much prefer a
> > webpage that looks like this (content-wise) to access all of the
> > documentation:
> >
> > http://lilypond.org/doc/v2.12/Documentation/
> >
> > Yes, this will mean redoing the texinfo, but I honestly think that in
> > its current state, the website is too difficult to navigate
> > efficiently, especially for the documentation.
>
> The current page Manuals
>
> <http://kainhofer.com/~lilypond/Documentation/web/manuals.html#manuals>
>
> looks pretty much like the page you cite. It has
>
> Learning
> Glossary
> Notation
> Internals
> Usage
> Snippets
> Changes
> Extending (I think the name should change from Extend to Extending)
> License
> Web
> Translated
> Development
You're right. I guess what I'm more concerned about is whether the
current layout of the stable (2.12) documentation links on the website
is *confusing* or not -- primarily thinking from a navigational
perspective.
> It's basically the same set of links as in the 2.12 documentation. But it
> doesn't have all of the choices for each manual (one big page, pdf).
> Therefore, when you click on any manual, you get to a page that gives you
> all the choices, and then you click on the split HTML.
True. This gets tiresome after a while (for me).
> The All link from the manuals page gets you to a page (Documentation quick
> links) that you can use to get to any of the split HTML pages. If that page
> had the Contributor's Guide on it it would be perfect for my use, and I'd
> bookmark that as my Local Documentation link.
I completely forgot about that page. Thanks!
I *really* wish the website had a "sitemap" with links to every manual
from the stable and development documentation.
Maybe a two-column webpage with the 2.12 links in the left column and
the 2.13 links in the right column?
Thanks,
Patrick
- Contributor's Guide on Website, Carl Sorensen, 2010/01/07
- Re: Contributor's Guide on Website, Reinhold Kainhofer, 2010/01/08
- Re: Contributor's Guide on Website, Graham Percival, 2010/01/08
- Re: Contributor's Guide on Website, Carl Sorensen, 2010/01/08
- Re: Contributor's Guide on Website, Graham Percival, 2010/01/08