Web page proposal

[Jeff MacDonald]

[my previous reply showed up blank.. dunno why, but I'll try again..]


On Sat, 2003-08-09 at 08:45, Jon Lapham wrote:
> I would like to propose a change to the www.gnucash.org web site 
> organization concerning the documentation.  If people like this 
> proposal, I would be happy to make the changes myself.
[..snipped..]
> Advantages:
> 
> 1) we clearly show what we think is the best documentation for people to 
> use.  That is, the latest GnuCash documentation.
> 

good :)

> 2) We *still make available* all forms of documentation.  No judgements, 
> every possible documentation concerning GnuCash will be available.
> 

good. :)

> 3) This approach is much more extensible, when GnuCash v1.10 comes out, 
> the documentation for v1.8 simply moves into the [other] link. Hell, if 
> we have any "older than 1.6 documentation", let's put that on the 
> [other] link too.
> 

ya, I like this idea, but it would be clearer if you didn't group
everything that isn't current and local as "other"-- perhaps "external
guides", "tutorials", etc?

> 4) Left hand column of the web site becomes simpler to navigate, less links.
> 

right, but unnecessary clicking is required to find something other than
"current documentation" if you put everything in the "other" section.

> 5) We could put a "in development" link on the [other] page, where 
> documentation people could put their in development docs.  Kind of like 
> what I am doing now with my own web site.
> 
> Disadvantages:
> 
> 1) Two clicks to get to documentation other than the current User Guide 
> and Help Manual.

as long as it is three clicks or less, you are fine, IMHO.

I like what the python folks have done with their doc page:
<http://python.org/doc>

regards,
J
-- 
|| Jeff MacDonald <jam at zoidtechnologies.com>
|| Web: <http://zoidtechnologies.com/>
|| GPG: 1024D/35172A42