Re: Contributor's Guide on Website

[Carl Sorensen]

On 1/7/10 5:10 PM, "Graham Percival" <address@hidden> wrote:

> On Thu, Jan 07, 2010 at 05:04:29PM -0700, Carl Sorensen wrote:
>> I would like to propose that the Contributor's Guide be added to the
>> main documentation web page, at the bottom of Infrequent Use box.
> 
> No, because then people will be looking at the 2.14 CG while we're
> working on the 2.15 CG.
> 
>> It is very painful to have to go to 5 links to get to the Contributor's
>> Guide.
> 
> That's because you're looking at the fuzzy doc-webpage in the 2.13
> docs, instead of the real "staging" webpage in ~graham/.  Note
> that the Manuals page is all for 2.12, while the community->devel
> page is all for 2.13.  As a developer, you're going to go to the
> devel page most of the time (*not* the old stable manuals page),
> so then it's one click.

No, I'm looking on the docs that are built on my local system.  I use both
the Notation Reference and the Contributor's Guide.  I don't want (and
shouldn't have) to go to two different places.  One comfy home for documents
should be good for me.

Oh -- I just looked at the devel page more clearly.  OK, it might be usable.

Then let me suggest some changes to the Development page.  My objective is
to be able to click to all the manuals from one page without having to
scroll.

I would prefer to have the manuals grouped by type, instead of by Manual

Split HTML:
Notation
Usage
Snippets
Extending
Internals
Contributor's (maybe, or maybe not).
Learning
Glossary
Essay
Web
Changes

(I don't really care if we have Glossary, Essay, Web, or Changes, because I
never use them as a developer, but I'm fine to have them.)

One Big Page HTML:
Notation
Usage
Snippets
Extending
Internals
Contributor's
Learning
Glossary
Essay
Web
Changes

PDF:
Notation
Usage
Snippets
Extending
Internals
Contributor's
Learning
Glossary
Essay
Web
Changes

I would also prefer to have Manuals at the top and Downloading at the
bottom.

I would prefer to see the "Read it" section eliminated and have the "All
formats" heading changed to "Read it"

I would like to see the left hand and right hand sides of the page switched.

I would like to have the Download section below the Manual section.
Actually, perhaps I'd even prefer it to be below the Contributor's Guide
section.

If we added Contributor's to all of the Manual sections, we could save space
by eliminating the "All formats" section, and move Download into that space.
 
A perfect page for me would have all of the manuals easily available in
split HTML format once I get to that page.

I think new contributors need to see the Contributor's Guide section,
followed by Downloads (so they can get the current binary if they're just
doing doc work).

I don't know if any of this is possible, but if it is, it would make my life
easier.

Thanks,

Carl