From: David Bremner <david@tethera.net>
To: Jameson Graef Rollins <jrollins@finestructure.net>,
 notmuch@notmuchmail.org
Subject: Re: [PATCH v3] contrib/nmbug: new script for sharing tags with a
	given prefix.
In-Reply-To: <871utef4bp.fsf@servo.finestructure.net>
References: <1320627586-10068-1-git-send-email-david@tethera.net>
	<1321024095-6387-1-git-send-email-david@tethera.net>
	<877h36fdgb.fsf@servo.finestructure.net>
	<87ty6a9puk.fsf@rocinante.cs.unb.ca>
	<871utef4bp.fsf@servo.finestructure.net>
User-Agent: Notmuch/0.9+51~g0234a16 (http://notmuchmail.org) Emacs/23.3.1
	(x86_64-pc-linux-gnu)
Date: Sat, 12 Nov 2011 00:52:26 -0500
Message-ID: <87fwhtanvp.fsf@rocinante.cs.unb.ca>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Precedence: list

On Fri, 11 Nov 2011 18:43:38 -0800, Jameson Graef Rollins <jrollins@finestructure.net> wrote:
> On Fri, 11 Nov 2011 18:55:15 -0500, David Bremner <david@tethera.net> wrote:

> At this point I actually think they're probably exactly the same
> audience, aren't they?  Isn't nmbug primarily aimed at notmuch
> developers that are reading patches sent to the list?

Well, same people, different roles.  I maintain that the purpose of
commit messages and online help is different. Commit messages are
intended to help understand the implementation, help message how to use
it.

> > My own workflow involves fetch, merge, and the occasional
> > checkout. Your might or might not; in my case it has to do with the
> > fact that I am syncing tags in several different ways.

> This is the sort of thing that I'm finding confusing.  Is this your work
> flow because you are the primary developer and are therefore frequently
> working under the hood, or because this is the prescribed procedure?

>From my point of view the analogy with git is fairly precise. Some
people prefer the convenience of pull, some people prefer to sanity
check the fetched changes (in the case of nmbug, using status) before
merging.  I guess people only using notmuch on one primary machine are
less likely need checkout. The error message from nmbug pull explains
when you might want checkout.

> Maybe it would help if you could follow up with a good how-to that
> describes how someone could start using nmbug with a nicely defined
> prescribed procedure.

I have rewritten the page http://notmuchmail/nmbug to compare the 
"short and simple" workflow with "expanded and fussy" workflow.

d