[rfc] developer documentation on user interaction

[Russel Winder]

Stephen,

On Fri, 2009-09-25 at 23:59 +0900, Stephen J. Turnbull wrote:
[ . . . ]
> The audience I'm talking about here is Russel, Ben, and Maritza, not
> Alex.  And yes, I think they'd agree that they don't want to have to
> do "bzr --version" on an unfamiliar host in order to know what to tell
> the new dev they're mentoring how to use bzr's CLI.  Don't you agree?

I have failed to read this thread, so I have no idea whether this is the
5 minute argument or the full half hour, but my name detector went
off . . .

Clearly CLI needs some stability or you will lose audience -- no
continuity, no audience.  But it must be amenable to some change or you
cannot have evolution.  Change in CLI has to be gradual so that the
audience's knowledge works from one version to the next.  This really
means that the meta-CLI needs to be very stable, and "bzr help" needs to
do useful and sensible stuff no matter what.

So actually I do do "bzr --version" all the time when training and
mentoring.
 
-- 
Russel.
=============================================================================
Dr Russel Winder      Partner
                                            xmpp: russel at russel.org.uk
Concertant LLP        t: +44 20 7585 2200, +44 20 7193 9203
41 Buckmaster Road,   f: +44 8700 516 084   voip: sip:russel.winder at ekiga.net
London SW11 1EN, UK   m: +44 7770 465 077   skype: russel_winder
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 197 bytes
Desc: This is a digitally signed message part
Url : https://lists.ubuntu.com/archives/bazaar/attachments/20090925/f680d4e3/attachment-0002.pgp