Commit graph

541 commits

Author SHA1 Message Date
Benedict Reuschling
b4b80b99e9 Extend the example in the committers guide with the SPDX license identifier.
This should encourage people to use these identifiers to highlight our
licensing advantages by adopting SPDX tags.

Submitted by:	pfg@
2017-11-16 17:49:47 +00:00
John Baldwin
a237823c26 Promote FreeBSD/mips from Tier-3 to Tier-2.
Approved by:	core
2017-11-13 21:39:49 +00:00
Romain Tartière
d0cf868b6d The documentation incorrectly states that
% svn copy foo.c bar.c

and

% cp foo.c bar.c
% svn add bar.c

are equivalent. However, the first one keeps foo.c history and the second gets
rid of it.

Fix this and explain the difference.

Reviewed by:	brd, allanjude
Approved by:	allanjude
Differential Revision:	https://reviews.freebsd.org/D12678
2017-10-17 17:43:45 +00:00
Guangyuan Yang
1f9b6b2475 Update the process of creating new Wiki accounts in Committer's Guide Section 6.1.7.
PR:		222655
Reviewed by:	sbruno
Approved by:	allanjude
Differential Revision:	https://reviews.freebsd.org/D12567
2017-10-07 17:25:04 +00:00
John Baldwin
e37ad32d81 Note that pc98 is transitioning to Tier-4 in FreeBSD 12. 2017-10-04 20:17:56 +00:00
John Baldwin
a714595969 Tweak Tier-1 description to not require Tinderbox by name.
Instead, just require build and testing automation of some form (e.g.
Jenkins-backed ci.freebsd.org).

Reviewed by:	emaste
2017-10-04 20:12:20 +00:00
Wolfram Schneider
6924bcbf71 switch to HTTPS for people.freebsd.org 2017-10-01 11:48:37 +00:00
Wolfram Schneider
5261228467 switch to HTTPS 2017-09-29 10:55:37 +00:00
Mathieu Arnold
36ed4c972f Fix up formatting issues in <screen> entries.
PR:		222006 (for the committer's guide)
Submitted by:	Paul Townsend
Sponsored by:	Absolight
2017-09-07 11:21:07 +00:00
Mathieu Arnold
8d6970fd84 Add a question about what the blanket approvals on the quarterly branch
are.

Reviewed by:	bcr
Sponsored by:	Absolight
Differential Revision:	https://reviews.freebsd.org/D12024
2017-08-14 15:12:13 +00:00
Mathieu Arnold
3514a00b2f Add an entry about hunting the vuxml database for the new name.
Sponsored by:	Absolight
2017-08-11 16:30:24 +00:00
Glen Barber
895562773c Prefer repo over svn, and fix a broken URL as a result.
Sponsored by:	The FreeBSD Foundation
2017-07-13 22:03:57 +00:00
Mathieu Arnold
2b3334c438 Use the correct anchor.
Sponsored by:	Absolight
2017-06-01 13:44:47 +00:00
Benjamin Kaduk
ae9e612adb Fix typo 2017-06-01 01:39:53 +00:00
Mathieu Arnold
9d13a54bcb Add some emphasis, the last two new committers added themselves instead
of leaving the file alone. (And their mentors let it pass.)

Sponsored by:	Absolight
2017-05-31 14:13:10 +00:00
Mathieu Arnold
26936acb67 A few more nits from matthew.
Submitted by:	matthew
Sponsored by:	Absolight
2017-05-31 12:49:08 +00:00
Mathieu Arnold
095cc93f12 Last minute typo.
Pointy hat:	mat
Sponsored by:	Absolight
2017-05-31 12:08:22 +00:00
Mathieu Arnold
fc5ccafc7a Pass the committer's guide through igor.
Most of those were fixed.

- "(s)" used 5 times Please do not form plurals this way. It is a
  holdover from lazy programming practices, is difficult to read, and
  almost always unnecessary. A plural formed with a plain "s" is usually
  correct when speaking about numbers of one or more.
- "in order to" used 6 times Unless "in order to" has some special
  meaning here, "to" is simpler.
- "i.e." used 1 time "I.e." (Latin "id est") means "that is" and is
  mostly used in academic and scientific writing. Consider replacing
  with the more common English words. Both forms are usually followed by
  a comma for a verbal pause: "i.e., a b c" or "that is, a b c"
- "e.g." used 1 time "E.g." (Latin "exempli gratia") means "for example"
  and is mostly used in academic and scientific writing. Consider
  replacing with the more common English words. Both forms are usually
  followed by a comma for a verbal pause: "e.g., a b c" or "for example,
  a b c"
- "simply" used 3 times Use "simply" to mean "in a simple manner",
  "just", or "merely", not the patronizing "details omitted because they
  are not simple enough for you". "basically" used 2 times Use
  "basically" to mean "essentially" or "fundamentally", not "only the
  basics are shown because anything more will be too complicated for
  you".
- "the following" used 18 times "as follows" used 3 times If something
  is following, the reader can see it without being told.
- "should" used 83 times Use "should" sparingly, it is feeble and
  suggests unsureness. Attempt to be imperative: "do this" rather than
  "you should do this".
- "you" used 176 times "your" used 84 times "You" and "your" are
  informal and subjective. Attempt to be formal and objective: "the
  file" rather than "your file".

Reviewed by:    wblock
Sponsored by:   Absolight
Differential Revision:  https://reviews.freebsd.org/D7531
2017-05-31 12:04:37 +00:00
Ed Maste
91dd27eff1 committers guide: mention that multiple PRs may be specified on the same line
Reviewed by:	bcr, gavin
2017-05-04 13:06:31 +00:00
Ed Maste
57347080a0 committer's guide: document MFC to: and MFC with:
There are a couple of different forms of these in use. Add "MFC to:" and
"MFC with:" tags consistent with the existing "MFC after:", and provide
a description so that consistent values can be used.

There are ongoing discussions about "X-MFC-*" tags which still need to be
resolved and documented here, or general guidance on X-MFC-*.

Reviewed by:	bcr, ngie
Differential Revision:	https://reviews.freebsd.org/D10585
2017-05-03 18:04:24 +00:00
Mathieu Arnold
d8df142c40 Expand a bit the usage of the quarterly branch in the mfh command line.
Sponsored by:	Absolight
2017-05-01 09:25:22 +00:00
Mathieu Arnold
2082cd9344 Add some emphasis to important bits.
Sponsored by:	Absolight
2017-05-01 09:25:19 +00:00
Mathieu Arnold
b811ab8fd7 Split a long paragraph in two.
Sponsored by:	Absolight
2017-05-01 09:25:17 +00:00
Mathieu Arnold
9846a9ca5a Split the request and the merge actions into two separate questions.
Sponsored by:	Absolight
2017-05-01 09:25:11 +00:00
Sevan Janiyan
8ad16ad486 Fix command to show eligible revisions for merging.
The old syntax no longer works.

Approved by:	bcr (mentor)
Differential Revision:	https://reviews.freebsd.org/D9426
2017-02-03 15:20:53 +00:00
Mathieu Arnold
f76db6814a Fix typos.
Reported by:	wblock (at least one of them)
Sponsored by:	Absolight
2017-01-19 15:37:18 +00:00
Glen Barber
c571a69fd7 Include trailing '/' for consistency.
Sponsored by:	The FreeBSD Foundation
2017-01-06 22:46:07 +00:00
Glen Barber
0eb12ab8a9 Further clarify the source and target branches when merging.
While here, bump the Copyright year.

Submitted by:	ngie
Sponsored by:	The FreeBSD Foundation
2017-01-06 22:28:56 +00:00
Mathieu Arnold
868cfb2227 Move the procedure to merge to the quarterly branch to a separate
section.

It will, maybe, be easier to find there.

No content change, except for the new title of the section.

Sponsored by:	Absolight
2017-01-03 18:42:44 +00:00
Mathieu Arnold
f798724859 Note the branch name as the first argument of mfh is obsolete.
Sponsored by:	Absolight
2017-01-03 18:39:02 +00:00
Mathieu Arnold
01da8481f1 Move the Differential Revision example at the end.
As it must be the absolute last line of the commit message, it is better
to put it at the end.  Also, add a sentence about that.

Sponsored by:	Absolight
2016-08-17 10:56:51 +00:00
Mathieu Arnold
b0ecf6583e Add a tip about using git grep when removing a port.
Sponsored by:	Absolight
2016-08-16 15:05:08 +00:00
Mathieu Arnold
6480a72910 Update the bit about ssh keys, DSA keys are not supported any more.
Sponsored by:	Absolight
2016-08-16 14:39:05 +00:00
Brad Davis
1b5d0045c9 Update the reference 64-bit arch and remove a blurb about ia64 vs sparc64.
Reported by:	mat
Reviewed by:	bcr
2016-08-16 13:18:00 +00:00
Mathieu Arnold
1d81d0dca6 &a.portmgr; and &a.ports-secteam; need "the" before them for the
sentences to be readable.

Sponsored by:	Absolight
2016-08-16 12:29:51 +00:00
Mathieu Arnold
9e25d12202 Document how to ask for an exp-run.
It seems that people do not find the exp-run flag when opening a PR.

Reviewed by:	bcr, wblock
Sponsored by:	Absolight
Differential Revision:	https://reviews.freebsd.org/D7503
2016-08-16 12:29:48 +00:00
Benedict Reuschling
5a7592f3a5 Remove mention of specific key types to discourage the generation
of old and potentially insecure keys.

Discussed with:	    David Wolfskill
2016-08-03 15:43:10 +00:00
Mathieu Arnold
31b1c079e9 Add a small bit about the mfh script being able to handle multiple
revisions at once.

Reviewed by:	wblock
Sponsored by:	Absolight
Differential Revision:	https://reviews.freebsd.org/D5634
2016-03-23 15:28:38 +00:00
Warren Block
218b75cc0b Legends have been told about the mysterious mentors file. Some say it
can only be located with a secret map that is even more difficult to
locate, requiring the solution of a series of increasingly-obscure
clues...  Oh, wait, there it is, right over there.
2016-02-26 16:03:12 +00:00
Warren Block
b2b7d126d1 Correct the path to mail archives.
Submitted by:	gonzo
2016-02-25 02:55:54 +00:00
Warren Block
e1381efc57 Fix something I meant to fix earlier. 2016-02-11 01:12:53 +00:00
Warren Block
8e1ba4b359 Whitespace-only fixes, translators please ignore. 2016-02-11 01:09:55 +00:00
Warren Block
9f0f364171 Clarify the process of setting up a FreeBSD.org Kerberos account for
the first time.

Submitted by:	sobomax
Differential Revision:	https://reviews.freebsd.org/D5247
2016-02-11 01:05:32 +00:00
Jason Helfman
e7f8222d12 - contributors should be sorted by first name
PR:		203708
Submitted by:	s3erios@gmail.com
Approved by:	wblock (mentor)
Differential Revision:	https://reviews.freebsd.org/D5169
2016-02-02 21:36:01 +00:00
Andrew Turner
bd2438dfff Add arm64 and riscv to the list of supported architectures in the
committers guide.

Reviewed by:	allanjude, gjb
Approved by:	core (gnn)
Differential Revision:	https://reviews.freebsd.org/D4955
2016-01-15 17:21:31 +00:00
Eitan Adler
7ea2d52e39 Update to current so@
Use entity to avoid having to update multiple places again

Requested by:	allanjude
2016-01-02 21:26:15 +00:00
Warren Block
18738f40fb Whitespace-only fixes, translators please ignore. 2015-12-17 01:45:07 +00:00
Warren Block
a57d3a2e35 Add a new section on benefits, supplied by bapt@. Move the last question
about perks from the miscellaneous questions section into this section.

Submitted by:	bapt (part)
2015-12-17 01:38:47 +00:00
Gavin Atkinson
2fd1b49a98 Stop pointing people to region-specific svn0.X.FreeBSD.org and instead
point them to svn.FreeBSD.org which is distributed using GeoDNS.
2015-11-02 03:17:28 +00:00
Benjamin Kaduk
b915697e0f Use gpg --full-gen-key to keep the example consistent gpg 2.1's behavior
Update the displayed version and copyright year as well (manually).

Submitted by:	lidl
2015-10-25 17:43:52 +00:00