On Fri, 11 Nov 2011 18:55:15 -0500, David Bremner <david@tethera.net> wrote: > I think the commit message and the online help are aimed a different > audience, so it is not crucial (or even desirable) that they be exactly > the same. Perhaps it would be more clear to say that these are the > "non-trivial" commands. 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? > The "most commonly used commands" could be retitled "the minimal set of > commands to use nmbug". 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? The tag sharing process that nmbug is using is complicated and subtle enough that you should make it very clear what the "proper" procedure is, and what are the "under the hood" commands that one should never really have to use. I've been following pretty closely and I'm still kind of confused. I'm sure that others coming to it now because they're seeing this posting to the list might share that confusion. 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. jamie.