Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 25 Jun 2020 16:55:47 +0000
From:      Brooks Davis <brooks@freebsd.org>
To:        Ed Maste <emaste@freebsd.org>
Cc:        freebsd-git@freebsd.org
Subject:   Re: svn primer translation to git
Message-ID:  <20200625165547.GA75705@spindle.one-eyed-alien.net>
In-Reply-To: <CAPyFy2Dy4cLQpgUsk_ushXsQFvRPk2S8SEfgWF=0xibGRGJvKw@mail.gmail.com>
References:  <CAPyFy2Dy4cLQpgUsk_ushXsQFvRPk2S8SEfgWF=0xibGRGJvKw@mail.gmail.com>

next in thread | previous in thread | raw e-mail | index | archive | help

--bp/iNruPH9dso1Pn
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Wed, Jun 24, 2020 at 12:34:33PM -0400, Ed Maste wrote:
> We currently have a FreeBSD Subversion primer in the committer's guide:
> https://www.freebsd.org/doc/en_US.ISO8859-1/articles/committers-guide/sub=
version-primer.html
>=20
> I've started a translation of this into a Git primer, at:
> https://hackmd.io/ML5TSl8mQ5-27B5eqDf7YA?view
>=20
> I'm particularly interested in feedback on how much git background /
> theory of operation we want to include here (vs referring to external
> documentation).

One result of this being a translation of the SVN guide is that it's not
IMO GIT-centric enough.  It suggests a number of things that are in
fact excellent foot cannons (git commit -a being the most egregious).
I'd like our document to recommend practices that make it relatively
easy to double and triple check commits.  E.g. for direct commit I
generally follow a process of staging with `git add -p` + `git add` for
new files followed by `git status` and/or `git diff --staged`, and then
`git commit`.

Obviously people will have varying workflows, but for people with little
git experience, let's try to prime them with good ones (unlike the
quickstart tutorials that do things like `git commit -a -m "foo"`).

-- Brooks

--bp/iNruPH9dso1Pn
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQEcBAEBAgAGBQJe9NcNAAoJEKzQXbSebgfA4lgH/j2F2oKcbHVrhwbQKuqeDIM3
d9eVlbJVi1v2ZPnMO3+Wss8T2VUEDpODhL4st4FA7DHTzOS0bYg8b6u5Mw6npQg3
8DzmNUdSCCE5Ye2S+91qG/+arFa4gPrNs5EHAMvKHre6LsGqwP7/Za0w96VPArya
9aJPkW8xHn7Yo6snJw9PbaytHhY4AN5vHCuhAPAZOuW48z5rK7jQSQ+pZaLdSSZT
vUkgUaSaKyVq+WSSeVkxyMuog+lXcUx75N88rNU8Can+pvDhrDJT4TKl4695VAEj
W8R4eENxkmHxZwGcZfaIBSVZ4zr3fPJqE1vuHGNJKBjd/xanmcTH/c3vrWGvI3A=
=zliX
-----END PGP SIGNATURE-----

--bp/iNruPH9dso1Pn--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20200625165547.GA75705>