Summary:
s/SVN/Git
s/head/main
Although there are other branches in the repo (like vendor/ or releng/), if they
were not considered noteworthy before, I choose not make them notheworthy now.
Test Plan: * Renders OK.
Reviewers: 0mp, gbe
Differential Revision: https://reviews.freebsd.org/D29886
The MFH field is still useful to note that the commit is going to be
merged into a quarterly branch.
Reported by: mat
Reviewed by: mat
Differential Revision: https://reviews.freebsd.org/D29862
Merging commits into the quarterly branch no longer requires an explicit
approval [1]. Let's remove outdated documentation and leave a note
explaining that there is no need for an explicit approval to MFH.
[1] https://svnweb.freebsd.org/ports?view=revision&revision=556626
* There is no authors.toml but authors.adoc
* Add `doc` in the path as in the other steps to make explicit that we refer
to the `doc` repository.
* s/shared/share in `src` repository:
Approved by: 0mp (mentor)
Differential Revision: https://reviews.freebsd.org/D28590
I've capitalized "git" throughout the document where appropriate.
There are also some other words I've fixed like "github" and "gitlab",
but I've not reviewed the whole document looking for those.
Adds an example on howto configure OpenSMPTD to forward
locally sent mails to FreeBSD.org mail servers.
Approved by: crees, imp
Differential Revision: https://reviews.freebsd.org/D29574
FreeBSD committers no longer need to know how to use subversion.
Remove the subversion primer from the committer's guide.
Add a VCS history section.
Suggestions by: lwhsu@
Differential Revision: https://reviews.freebsd.org/D29610
- Remove notes that the migration is in progress
- Remove old branch names and URLs
- Remove mention of psvn
- Remove section about re-adding a deleted port, git add will do the
right thingn natively (most of the times).
- Remove section about repo-copies, git has no copy command.
- Simplify instructions for moving a port.
- Remove section about the mfh tool. Merges are now just cherry-picks.
Reviewed by: crees, emaste, imp, lwhsu, mat
Differential Revision: https://reviews.freebsd.org/D29450
bsdl-gpl: style line
building products: style line and fix images path
committers-guide: style line, convert some MarkDown
links to Asciidoc and upgrade some entries still making
reference to the old Docbook tech.
Document that we try to follow SPDX 2.2 for the SPDX-License-Idneitfier: tags
that are in the source. Note that they are informative only. Give pointers to
the standards and a status of the files marked in-tree.
Suggestions by: Pau Amma
Differential Revision: https://reviews.freebsd.org/D29330
Lots of wording improvements, grammar errors, punctuation error and wrong word
fixes. Also, do some limited one sentence one line (1s1l) conversion.
Submitted by: Pau Amma (though not the 1s1l stuff).
Don't say there are two options and then give only one. Update that
sentence to reflect where the project seems to have landed in terms of
how to do MFCs. The original was written prior to the transtion and the
existing practice has shifted to cherry-pick -x almost exclusively.
Highlight MFC to a branch needing approval
Rearrange a couple sections to improve document structure.
Change some enumeration lists to bulleted lists since I think that looks nicer.
Fix a few typos and reformat a few paragraphs to one line per sentence
style. Try to use repository insteast of 'repo' or even 'source of
truth'. Clarify a few places and fix some grammar errors.
Submitted by: Pau Amma
Add git commit --amend with a comment about doing a final check of the commit
message before the push. Update with some more specific guidance on a good
commit message. Add link to commit message section. Minor tweaks I noticed
while doing this as well for having one setence one line.
Submitted by cy@
Add in the git minirpimer from my github. It contains the basics that
you'll need to track the tree and/or contribute.
Contributions by: rwatson@, Rainer Hurling, jhb@, Ceri Davies, lwhsu@,
chuck@, Robert Gogolok
Add in the migrating from the old subversion / git docs. This section
should be removed in a few months maybe.
Contributions by: lwshu@, Alexander Richardson, kib@, Ceri Davies
Use angle brackets instead of italic to denote mandatory fields after
"freebsd/developer/" blocks. "freefall name" and "NickServ name" are
also renamed to "freefall username"` and "FreeNode account".
Reviewed by: debdrup, ygy, lwhsu
Approved by: philip (mentor)
Differential Revision: https://reviews.freebsd.org/D29285
Integreate MFC procedures into the committer's handbook. This was originally in
my freebsd-git-docs repo where it was collaberatively created. The changes here
are light edits and a conversion from markdown to asciidoc.
Contributions from: jhb@, lwhsu@, delphij@, Ceri Davies, Alexandre
Fernando Apesteguía
Mateusz Piotrowski
Mark Johnston
Ryusuke SUZUKI
Muhammad Moinur Rahman
Marc Fonvieille
George V. Neville-Neil
Warner Losh
Rene Ladan
Sergio Carlavilla Delgado
Benjamin Kaduk
Li-Wen Hsu
Ka Ho Ng