gnu-arch-users
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Gnu-arch-users] Re: [GNU-arch-dev] Re: new documentation progress


From: John A Meinel
Subject: [Gnu-arch-users] Re: [GNU-arch-dev] Re: new documentation progress
Date: Wed, 30 Mar 2005 10:50:15 -0600
User-agent: Mozilla Thunderbird 1.0.2-1.3.2 (X11/20050324)

Anand Kumria wrote:
On Sun, 27 Mar 2005 17:48:33 -0800, Tom Lord wrote:


I've been working up some new docs in "handbook" format.
It's not done yet but there's enough to get the sense:

 http://www.seyza.com/src/docs-tla/my/id.html

and

 http://www.gnuarch.org/src/docs-tla/my/id.html

I'm open to "early feedback" at this stage although
the development pace for these docs is very fast
so it won't be "early" for long :-)


Some comments:

'Next' and 'Prev' would be nice within each section

1.1: 'revctl' - I wouldn't be shortening words straight off the bat

- I'd suggest ~/arch/archives as the 'archloc'

- likewise, ~/arch/mirrors as the 'mirrorloc'

- and, ~/arch/revision-library as the 'revlib'

2.4: intro paragraph is hard to parse

4.1: the wiki syntax has broken the display

4.2: why not discuss 'tla grab' ?

5.1: mention '-l' ? since making your archive available for others is a
common next step, typically done via plain HTTP

5.3+ and onwards aren't displayed in the left nav-area for some reason

I think this is because they don't exist yet. Try clicking on a link and
you'll find you get 404.


Cheers,
Anand

Attachment: signature.asc
Description: OpenPGP digital signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]