Re: Github?

[notmuch-archives.git] / e4 / b9ba73b0aff3348048e0e3214b2b74e1421d97

Return-Path: <madduck@lapse.rw.madduck.net>\r
X-Original-To: notmuch@notmuchmail.org\r
Delivered-To: notmuch@notmuchmail.org\r
Received: from localhost (localhost [127.0.0.1])\r
        by olra.theworths.org (Postfix) with ESMTP id 1678D431FBD\r
        for <notmuch@notmuchmail.org>; Wed,  3 Feb 2010 19:51:32 -0800 (PST)\r
X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
X-Spam-Flag: NO\r
X-Spam-Score: -0.995\r
X-Spam-Level: \r
X-Spam-Status: No, score=-0.995 tagged_above=-999 required=5 tests=[AWL=1.604,\r
        BAYES_00=-2.599] autolearn=unavailable\r
Received: from olra.theworths.org ([127.0.0.1])\r
        by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
        with ESMTP id 2v4WQuPWJkxV for <notmuch@notmuchmail.org>;\r
        Wed,  3 Feb 2010 19:51:31 -0800 (PST)\r
Received: from clegg.madduck.net (clegg.madduck.net [193.242.105.96])\r
        by olra.theworths.org (Postfix) with ESMTP id 8DF10431FAE\r
        for <notmuch@notmuchmail.org>; Wed,  3 Feb 2010 19:51:31 -0800 (PST)\r
Received: from lapse.rw.madduck.net (lapse.nz.madduck.net\r
        [IPv6:2001:4428:234::1])\r
        (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))\r
        (Client CN "lapse.rw.madduck.net",\r
        Issuer "CAcert Class 3 Root" (verified OK))\r
        by clegg.madduck.net (postfix) with ESMTPS id 353F81D4099;\r
        Thu,  4 Feb 2010 04:50:29 +0100 (CET)\r
Received: by lapse.rw.madduck.net (Postfix, from userid 1000)\r
        id D9B2C2A5; Thu,  4 Feb 2010 16:50:26 +1300 (NZDT)\r
Date: Thu, 4 Feb 2010 16:50:26 +1300\r
From: martin f krafft <madduck@madduck.net>\r
To: Carl Worth <cworth@cworth.org>\r
Message-ID: <20100204035026.GA13411@lapse.rw.madduck.net>\r
Mail-Followup-To: Carl Worth <cworth@cworth.org>, notmuch@notmuchmail.org\r
References: <87my083mgh.fsf@SSpaeth.de> <87d4148s2c.fsf@lillypad.riseup.net>\r
        <4B595D3A.1030901@SSpaeth.de> <87636u34lw.fsf@SSpaeth.de>\r
        <87d411zvz8.fsf@yoom.home.cworth.org>\r
        <20100125213231.GB15987@lapse.rw.madduck.net>\r
        <87ock5punt.fsf@yoom.home.cworth.org>\r
MIME-Version: 1.0\r
Content-Type: multipart/signed; micalg=pgp-ripemd160;\r
        protocol="application/pgp-signature"; boundary="9jxsPFA5p3P2qPhR"\r
Content-Disposition: inline\r
In-Reply-To: <87ock5punt.fsf@yoom.home.cworth.org>\r
X-Motto: Keep the good times rollin'\r
X-OS: Debian GNU/Linux squeeze/sid kernel 2.6.32-trunk-686 i686\r
X-Spamtrap: madduck.bogus@madduck.net\r
X-Subliminal-Message: debian/rules!\r
User-Agent: Mutt/1.5.20 (2009-06-14)\r
X-Virus-Scanned: clamav-milter 0.95.3 at clegg\r
X-Virus-Status: Clean\r
Cc: notmuch@notmuchmail.org\r
Subject: Re: [notmuch] Git feature branch\r
X-BeenThere: notmuch@notmuchmail.org\r
X-Mailman-Version: 2.1.13\r
Precedence: list\r
List-Id: "Use and development of the notmuch mail system."\r
        <notmuch.notmuchmail.org>\r
List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
        <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
List-Post: <mailto:notmuch@notmuchmail.org>\r
List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
        <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
X-List-Received-Date: Thu, 04 Feb 2010 03:51:32 -0000\r
\r
\r
--9jxsPFA5p3P2qPhR\r
Content-Type: text/plain; charset=utf-8\r
Content-Disposition: inline\r
Content-Transfer-Encoding: quoted-printable\r
\r
also sprach Carl Worth <cworth@cworth.org> [2010.02.04.1605 +1300]:\r
> >   maint/    =E2=80=94 the stable release\r
> >   master/   =E2=80=94 the stablising head\r
> >   next/     =E2=80=94 testing branch\r
> >   pu/       =E2=80=94 patch integration branch (proposed updates)\r
>=20\r
> I'm not a fan of this scheme, (or maybe I've just never quite understood\r
> it).\r
>=20\r
> When I first encountered this scheme, (when first using git), it was\r
> never clear to me what branch I should actually run or test as a\r
> user. Nor was it obvious which branches would be regularly rebased or\r
> not---nor which branches had features being discussed on the mailing\r
> list.\r
\r
I'll happily explain if you want. I think that this workflow, in\r
combination with the distributed functionality of Git, makes for\r
really powerful collaboration.\r
\r
To answer your two (implicit) questions directly:\r
\r
- as a user, you'd probably be tracking master, if you aren't\r
  running a stable release anyway. if you are ready to deal with the\r
  occasional bug and want some juicy stuff, go with next. if you are\r
  a developer ready to fend of the sh*t as it hits the fan, use pu.\r
\r
  Basically, it's a bit like Debian testing/unstable/experiemental,\r
  except that the default entry point for new patches (packages in\r
  that analogy) is pu (experimental), not next (unstable, as it is\r
  in Debian).\r
\r
  maint is then the stable branch, see below.\r
\r
- nothing is ever rebased. patches are cherry-picked downwards\r
  (pu=E2=86=92next=E2=86=92master) and branches are occasionally merged upw=\r
ards\r
  (master into next, next into pu).\r
\r
I don't think we will need 'next' anytime soon, not until we have\r
a situation where we are e.g. working on the next 1.x release by\r
already have 2.0 on the horizon.\r
\r
The important distinction is between pu (proposed-updates) and\r
master. The goal for master should always be that it's usable.\r
Features that are too new to ensure that go to pu until they\r
matured.\r
\r
> Instead of "maint" I'd much rather just have branches that are\r
> named directly after the stable releases being maintained. We've\r
> done this with the cairo repository with branch names like "1.2",\r
> "1.4", "1.6", etc. That way it's very clear what the branch\r
> represents and it's possible to have multiple concurrent "live"\r
> maintenance branches. But of course, until we actually have\r
> releases, this doesn't really matter. :-)\r
\r
This is all possible to do. It has no impact on the pu/next/master\r
distinction. Basically, once a release is made, master is merged\r
into maint (I think) and tagged. If a maintenance release has to be\r
made, a maint/1.0 branch is created. I don't think Git/Linux do\r
that, but I do.\r
\r
> I want to maintain a branch myself, (where I'm the only person\r
> pushing to the branch). [This is different than what I've done\r
> with the cairo repository where we have all core maintainer's\r
> pushing to a central repository. I'm intentionally trying\r
> something new here.]\r
\r
Do you want to maintain that branch yourself for your own purposes,\r
or do you want to be the sole maintainer of the branch that is\r
advertised as *the* notmuch branch, and from which future releases\r
are made?\r
\r
> Obviously, that branch that I maintain is currently called\r
> "master", but I wouldn't mind (and might actually prefer) to have\r
> it be called "~cworth" or so. Though we have the problem that we\r
> need "master" to point to *something*.\r
\r
Actually, there is no reason for master to exist at all. ;)\r
It's just the default, but it's not intrinsic.\r
\r
> Beyond that, I'm quite happy to have any number of branches similarly\r
> maintained by any other individuals. I want to get things setup so that\r
> those will be hosted and listed alongside my branch on\r
> notmuchmail.org.\r
\r
So you are talking repos, not branches. I know they are almost the\r
same, but branches live in repos, and if you want to be the only\r
person pushing to a branch, you need to be the only one with write\r
access to the containing repo =E2=80=94 unless you use gitolite, which can\r
do in-repo per-branch access control.\r
\r
> > What patch tracking workflow should we adopt? Keep sending\r
> > patches to the mailing list\r
>=20\r
> I definitely like the patches on the list. I find that with\r
> notmuch, I can maintain a queue of outstanding patches very\r
> effectively, (meaning, that the queue is usable and doesn't forget\r
> even if I do get very far behind like I am currently).\r
\r
The reason why I set up patchwork is because you might have spent\r
hours triaging some patches already, e.g. bringing the count from\r
400 to 100. Since I cannot really "pull" your tags, I am forced to\r
go through the entire list myself.\r
\r
> > master or pu (or even maint/next), as appropriate? Use the\r
> > Debian bug tracker? Use Sebastian's Roundup instance? Set up\r
> > a patch queue manager on notmuchmail.org? Use patchwork [1]?\r
>\r
> I'm personally not interested in any system that requires me to\r
> push any additional buttons outside of notmuch and git itself.\r
> I am interested in tools that can generate reports and help\r
> provide visibility into things. So patchwork fixed to\r
> automatically notice when patches are merged would be interesting.\r
\r
Absolutely. There are two comments I have:\r
\r
- this gets easier the closer we get to a centralised model, simply\r
  because patchwork is centralised.\r
\r
  We *may* be able to use Git's new "notes" feature to attach\r
  workflow information to patches, but for that, patches have to\r
  become commits in the ancestry, so we need some way of pulling\r
  them off the list and into the ancestry.\r
\r
  Simply slurping all patches into an 'all-patches' branch won't\r
  work due to merge conflicts, so it has to be a manual operation\r
  anyway. This then either happens centrally, or we have some sort\r
  of communication protocol to tell others which patches have been\r
  integrated into the ancestry.\r
\r
  This is where patchwork could come in (again).\r
\r
- =E2=80=A6 which brings me to my second point: there are certain things\r
  that patchwork can do, at least in theory:\r
\r
  * mark patches accepted when they hit your (canonical) master\r
    branch\r
  * mark patches rfc when they hit e.g. my (canonical) next branch\r
  * mark patches "under review" when they hit the all-patches (or\r
    pu) branch.\r
\r
  I have not yet tried any of these, and I am basing this theory\r
  only on the idea that git-patch-id can come to the rescue, for\r
  there is no other linkage between the patch on the mailing list\r
  (and thus known to patchwork), and the commit in the repo.\r
 =20\r
  Given that\r
\r
  * git-patch-id will fail if the patch is modified before it's\r
    applied to the ancestry,\r
  * git-patch-id might not work at all,\r
  and\r
  * there are status changes that cannot be deduced from Git\r
    (rejected, superseded, not applicable, changes requested,\r
    deferred),\r
\r
  we might need some sort of protocol anyway. This could be either\r
\r
  * a mail processor, in the style of the Debian bug control system,\r
    to which you send commands like 'status 1234 superseded',\r
  or\r
  * a policy specification using e.g. Git notes on commits, such\r
    that workflow changes could be attached to commits in a way that\r
    would let patchwork and humans follow what's going on.\r
\r
> Also interesting would be support for publishing my notmuch-based\r
> queue of patches to a web page.\r
\r
Absolutely. As I said before, notmuch and tagging could pretty much\r
render patchwork obsolete, but to do that, I /think/ we need to grow\r
two features:\r
\r
- the ability to share tags, so that I don't have to manually track\r
  my own patch list,\r
- a web archive with notmuch search/tag support.\r
\r
Simply publishing your workflow statuses would be an improvement,\r
but I am unsure I can fully quantify the gain.\r
\r
In closing, I would like draw a parallel between commits, patches\r
and mails:\r
\r
1. notmuch deals with mails, and Git deals with commits\r
2. a commit can be turned into a patch and sent as a mail\r
3. notmuch can tag mails, Git can attach notes to commits\r
4. notes can be used to store tag-like information\r
\r
If we continue the road of sending patches to the mailing list\r
(which I think is a good one, due to discussions and comments), then\r
we inevitably need to link commits to mails, along with the\r
associated metadata (tags, workflow status), in two ways.\r
\r
Fun times,\r
\r
--=20\r
martin | http://madduck.net/ | http://two.sentenc.es/\r
=20\r
"of course the music is a great difficulty.\r
 you see, if one plays good music, people don't listen,\r
 and if one plays bad music people don't talk."\r
                                                        -- oscar wilde\r
=20\r
spamtraps: madduck.bogus@madduck.net\r
\r
--9jxsPFA5p3P2qPhR\r
Content-Type: application/pgp-signature; name="digital_signature_gpg.asc"\r
Content-Description: Digital signature (see http://martin-krafft.net/gpg/)\r
Content-Disposition: inline\r
\r
-----BEGIN PGP SIGNATURE-----\r
Version: GnuPG v1.4.10 (GNU/Linux)\r
\r
iEYEAREDAAYFAktqQ/8ACgkQIgvIgzMMSnVjUgCfQ+ol7A/0ui9ZG2GaNgqMeh+9\r
3XgAnR6oVumiHm0ENvGhtCpX41y1zKdk\r
=/TV9\r
-----END PGP SIGNATURE-----\r
\r
--9jxsPFA5p3P2qPhR--\r