svn primer translation to git

Brooks Davis brooks at
Thu Jun 25 16:55:54 UTC 2020

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:
> I've started a translation of this into a Git primer, at:
> 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
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 455 bytes
Desc: not available
URL: <>

More information about the freebsd-git mailing list