[prev in list] [next in list] [prev in thread] [next in thread] 

List:       darcs-devel
Subject:    [darcs-devel] [issue1883] It's too easy to mix up --patch-name and
From:       Jason Dagit <bugs () darcs ! net>
Date:       2010-06-30 23:53:01
Message-ID: 1277941981.19.0.9069649781.issue1883 () darcs ! net
[Download RAW message or body]


New submission from Jason Dagit <aoeu>:

It's hard to look at --patch-name and --patch and tell how they are 
different.  Each is documented in the help/manual adequately, but a good UI 
would not present them together (as with amend-record), without giving them 
names that help differentiate them.

See for example issue1778.

So, my proposal is a renaming of these options (yes, that makes it an icky 
UI change) in order to prevent this sort of confusion.  If they couldn't be 
passed to a command at the same time it would be less of an issue.  Since 
they can be passed at the same time my 'wish' is for them to be more 
different.

The fact that a user was confused enough to take the time to write a bug 
report and then several devs looked at the report before catching the 
confusion points to the depth of the confusion, especially for new users.

Example new names:
--set-patch-name and --patch-name-matching
--new-patch-name and --find-patch-name
--set-name and --name-matching
--set-name and --find-named
etc.

There should probably be some consensus on the best new names.  For reaching 
consensus, I propose making a list of 6, or so, alternatives and then 
holding a closed-ended multiple choice poll.  Then using the top voted 
option.

Jason

----------
messages: 11655
milestone: 2.6.0 HEAD
nosy: dagit, dmitry.kurochkin
priority: wishlist
status: waiting-for
title: It's too easy to mix up --patch-name and --patch in some commands

__________________________________
Darcs bug tracker <bugs@darcs.net>
<http://bugs.darcs.net/issue1883>
__________________________________
_______________________________________________
darcs-devel mailing list (AUTOMATIC POSTINGS ONLY PLEASE!)
darcs-devel@darcs.net
http://lists.osuosl.org/mailman/listinfo/darcs-devel
[prev in list] [next in list] [prev in thread] [next in thread]