[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Gnu-arch-users] "Newbie-ized help"
From: |
James Blackwell |
Subject: |
Re: [Gnu-arch-users] "Newbie-ized help" |
Date: |
Sun, 26 Sep 2004 09:33:54 -0400 |
> James Blackwell wrote:
>> Ok. Discuss.
>
> 94 lines is still a heck of a lot of help output. Some of the ones
If you can do a better job, patches welcome. :)
Btw, its down to 89 now, which is a 51% reduction from the original.
> you've left in are aliases (which shouldn't be included in "newbie"
> help) and some of them are what I'd consider esoteric
> (e.g. explicit-default -- after reading the help on it, I'm still not
> sure what it does or why I'd ever want to use it).
Since I wrote that, I've hidden:
move
add
delete
explicit-default
> Why show both abrowse and rbrowse in the "newbie" help? I've only
> ever used abrowse, but from reading this list it seems that rbrowse
> can do a superset of what abrowse can. Also, the current organisation
> of sub-headings etc seem kind of arbitrary, at least to a newcomer.
Because rbrowse is a bit more powerful, but is _to this day_ missing
some basic functionality. It also doesn't feel as nice when working with
remote archives.
> How about splitting them by "task"?
>
> tla help -> a short introduction, points to other help
> tla help starting -> my-id, my-revision-library, library-config
> make-archive, my-default-archive,
> register-archive, archives
How many hours do you estimate it would take to change the current
codebase over to doing what you request?
Also, how do you think this will be received by people that are looking
for a command name, but can't remember what section its in? (i.e. gdb
help disease)
--
James Blackwell Try something fun: For the next 24 hours, give
Smile more! each person you meet a compliment!
GnuPG (ID 06357400) AAE4 8C76 58DA 5902 761D 247A 8A55 DA73 0635 7400
- [Gnu-arch-users] "Newbie-ized help", James Blackwell, 2004/09/26
- Re: [Gnu-arch-users] "Newbie-ized help", Cameron Patrick, 2004/09/26
- Re: [Gnu-arch-users] "Newbie-ized help",
James Blackwell <=
- Re: [Gnu-arch-users] "Newbie-ized help", Cameron Patrick, 2004/09/26
- Re: [Gnu-arch-users] "Newbie-ized help", James Blackwell, 2004/09/26
- [Gnu-arch-users] Re: "Newbie-ized help", Mark Stosberg, 2004/09/26
- Re: [Gnu-arch-users] "Newbie-ized help", Dustin Sallings, 2004/09/26
- Re: [Gnu-arch-users] "Newbie-ized help", Cameron Patrick, 2004/09/27
- [Gnu-arch-users] Re: "Newbie-ized help", Miles Bader, 2004/09/27
- [Gnu-arch-users] Re: "Newbie-ized help", Anand Kumria, 2004/09/27
- [Gnu-arch-users] Re: "Newbie-ized help", Miles Bader, 2004/09/27
- Re: [Gnu-arch-users] Re: "Newbie-ized help", Dustin Sallings, 2004/09/28
- [Gnu-arch-users] Re: "Newbie-ized help", Miles Bader, 2004/09/28