Open source (Emacs) development using Bazaar (Explorer) tutorial

[Karl Fogel]

Ian Clatworthy <ian.clatworthy at canonical.com> writes:
> With the Emacs team about to switch to Bazaar, I put together a tutorial
> last night explaining how *I* think open source projects ought to use
> Bazaar. The tutorial uses Bazaar Explorer but the workflows equally
> apply to those using the command line. The example project used is GNU
> Emacs but the processes apply to many open source projects, either
> already on Launchpad or capable or being mirrored there.
>
> Here's the link:
> http://doc.bazaar-vcs.org/explorer/en/tutorials/open-source-dev-gnome.html

I think it's great!  My brain is already tainted because I am not a new
user, so it's hard for me to say for sure whether it really answers all
the questions a new user might have, but I think it does.

(Few of the actual Emacs developers would use this, of course, since the
UI in the examples is not Emacs.)

> Note: This tutorial very intentionally says "this is how to use Bazaar"
> instead of offering multiple options up front. I hope this approach
> helps to get new users over the initial learning curve (by removing
> choices).

Yes.  Yes.  Yes.  Choices == confusion == unhappiness.

> Could someone on the emacs-developers list please announce this tutorial
> there, collect feedback and report back?

Well, we have enough problems with people there being confused by the
number of workflows available.  I am loathe to actively point them to
Yet Another Document :-).  IMHO Stephen Turnbull did the best thing by
simply linking to it as a reference from the bottom of
http://www.emacswiki.org/emacs-en/BzrForEmacsDevs.

-Karl