Commit graph

587 commits

Author SHA1 Message Date
Mathieu Arnold
5c48b21e85 Add a description on how to configure a local postfix to forward
emails to the FreeBSD smtp servers.
2019-03-28 15:28:01 +00:00
Brooks Davis
ee29c13b62 Refer to the license policy document as the source of truth.
The summary of the license policy in the commiters guide is a good place
to get started, but the buck stops with the license policy.  We enourage
questions before making commits if the policy is not clear.

Approved by:	core (bcr, jhb, imp)
Differential Revision:	https://reviews.freebsd.org/D19515
2019-03-12 17:42:24 +00:00
Brooks Davis
6aedd1788e Committers Guide: Add a section encouraging pre-commit review.
This is based on LLVM's Code Review policy.  It differs it not requiring
review for non-trivial changes.

Reviewed by:	bcr (verbal), allanjude, imp, jhb
Approved by:	core
Differential Revision:	https://reviews.freebsd.org/D16730
2019-02-12 22:48:39 +00:00
Sergey Kandaurov
f23b53f8ae Fix typo. 2019-02-08 20:13:29 +00:00
Mathieu Arnold
4f2f112aee Add a note about direct commits for ports that have been removed from head. 2019-01-26 08:31:03 +00:00
Daniel Gerzo
374c66b515 - add instructions for FreeBSD.org SMTP access setup
Reviewed by:	bcr, mat, rpokala, allanjude
Differential Revision:	https://reviews.freebsd.org/D18708
2019-01-11 20:46:47 +00:00
Mathieu Arnold
c5ff427774 Move portmgr's blanket approval definition to the Committer's Guide, and
shuffle a few things around.

Reviewed by:	bcr, adamw
Differential Revision:	https://reviews.freebsd.org/D18308
2018-12-06 16:04:59 +00:00
Mathieu Arnold
8e549f630c Reword the quarterly blanket approvals so that it is less vague about
what is getting authorized.

Reviewed by:	bcr, adamw
Differential Revision:	https://reviews.freebsd.org/D18308
2018-12-06 16:04:56 +00:00
Rene Ladan
c2503121bb Make sure your new GPG key has a FreeBSD user ID. 2018-10-09 17:22:08 +00:00
Benedict Reuschling
da4f84da78 Minor cleanups of the committer guide from the textproc/igor output. 2018-08-17 13:57:02 +00:00
Eitan Adler
93b15fee8d [committer guide] update rules for contrib software.
- Most notably don't require talking to core@ to take on maintainership.
- Merge an FAQ into the main body of the text
- Wordsmith
- Remove references to CVS

Approved by:	core
2018-08-16 05:04:47 +00:00
Eitan Adler
d3a0e706f9 Committer guide: avoid confusing maintainers with hats
The content at administration.html discussed hats, not maintainers.
While certain people do tend to own various areas, this is covered by
MAINTAINERS, Herald, etc. Just remove the reference to administration
since its off-topic in this context.

Approved by:    core
2018-07-26 05:18:49 +00:00
Warren Block
b2a246aed9 Address problems reported by John O'Brien in 228353. My changes differ
from the patch included with that bug report, mostly by being more
general and hopefully head off some bikeshed discussions.

PR:		228353
Submitted by:	John W. O'Brien <john@saltant.com>
2018-07-22 22:38:13 +00:00
Michael Gmelin
8221b01bb5 Clarify wording when warning about unauthorized MFHs
Approved by:	adamw
Differential Revision:	https://reviews.freebsd.org/D16355
2018-07-20 12:12:35 +00:00
Mathieu Arnold
5c20249242 Add a tip about how to ask for a MFH when using a blanket approval.
Sponsored by:	Absolight
2018-07-10 08:38:43 +00:00
Eitan Adler
cf4d07046e Committer guide: expand ports-secteam blanket
This approves two additional blankets:
- security issues version bumps
- crash version bumps

Reviewed by:	feld
With hat:	ports-secteam
2018-07-02 01:49:50 +00:00
Eitan Adler
e383dc4bf2 Committers guide: remove about hrs being maintainer of relnotes
We now use 'relnotes: yes' instead of a manual email to an individual.
Catch up to this.
2018-06-30 10:35:57 +00:00
Eitan Adler
6fdf3dc507 Committers guide: simplification of the vendor merge section
- Remove comparison to CVS as we no longer use it
- correct location of `--parents`
- always quote and simplify admonition about zsh
2018-06-30 08:18:42 +00:00
Eitan Adler
109963ff7e Committers guide: pet igor 2018-06-30 08:02:21 +00:00
Eitan Adler
a3e7633a04 Committers guide: wordsmith the section on maintainers
- remove an aside about reading the mailing list. This is taken care of
  by the later sentence about reading revision history
- use a slightly stronger admonition ("important" instead of "note") for
  the comments about not sending mail directly to the maintainer.
- Refer explicitly to the 'MAINTAINERS' file at the root of the tree
- Use the language of "asking for a review" instead of "sending the
  change to them" which, again, encourages a more public interaction.
- Remove the weasel language "it may help" and just encourage people to
  scan the history
2018-06-30 05:56:32 +00:00
Eitan Adler
a796be71b6 Committer's guide: update the ssh_config
Since committers need to login to freefall or other project resources,
just always suggest using `*.freebsd.org` instead of making it a
comment.
2018-06-30 05:33:32 +00:00
Eitan Adler
d65564771e Committer guide: restore some information about svnsync
Even though we don't have currently have active seeds some people still
use the old ones. In addition we may restore creating new ones.

Update the text a bit to reflect that you can use the mirror. Move the
text together into one section, and keep the note about alternatives.

Requested by:	kib
2018-06-17 03:20:41 +00:00
Eitan Adler
4e00cf8428 Committer guide: generalise review
Some reviews go to other places. Just mention review in general.
2018-06-16 20:31:19 +00:00
Eitan Adler
205241edc8 Committer guide: remove non-exististant seed reference
The seed file referenced does not exist anymore.
2018-06-16 20:20:34 +00:00
Eitan Adler
62ddfba6e2 Committer guide: further remove merge information older branches
There are no such supported branches. Those that need to merge to such
branches can get the information from the documentation archive.

While here, remove an incorrect note that depth cannnot be reduced
(it can be).
2018-06-16 20:10:41 +00:00
Benedict Reuschling
d2dcb18a50 Properly break some overflowing lines that textproc/igor was reporting.
No visible content changes.
2018-06-14 17:14:31 +00:00
Benedict Reuschling
1118e3af7f Fix links to the dogs of FreeBSD and IRC nicks links on the wiki.
Capitalize IRC.

PR:		228457
Submitted by:	0mp@
2018-06-02 20:31:42 +00:00
Eitan Adler
b8807f3369 Committer guide: remove merge information for branches older than 10.x
There are no such supported branches. Those that need to merge to such
branches can get the information from the documentation archive.
2018-05-28 20:27:22 +00:00
Eitan Adler
3e4070e36b Committer guide: be more generic about noteworthy branches
We have several lists of important branches. Rather than having to
update them all just mention the important part. Another option might
be to change this to a link with more detailed information.
2018-05-28 20:21:04 +00:00
Gordon Tetlow
6fb81b7dfb Remove references to Perforce from the website.
Perforce no longer provides server binaries for FreeBSD and we haven't
used Perforce for project development in several years.

Reviewed by:	bjk (previous version)
Differential Revision:	https://reviews.freebsd.org/D15392
2018-05-20 23:11:23 +00:00
Warner Losh
ce3de5268d Fix preferred license.
I missed this in r51635 when we removed 'All Rights Reserved' from the
preferred license. The phrase is no longer needed and has no legal
meaning now that the Buenos Aires Convention is no longer in force.
2018-05-20 03:00:48 +00:00
Sean Chittenden
135ba28351 Chase bugzilla product rename to just Services.
Approved by:	bcr
Differential Revision:	https://reviews.freebsd.org/D15163
2018-04-23 07:48:49 +00:00
Mathieu Arnold
6f428b5aea Typo in URL.
Sponsored by:	Absolight
2018-04-20 12:15:56 +00:00
Mathieu Arnold
1f4a6e5b86 Add a missing xml:id on the Phabricator section.
Sponsored by:	Absolight
2018-04-20 12:08:48 +00:00
Mathieu Arnold
956136ef29 whitespace fixes.
Sponsored by:	Absolight
2018-04-20 12:07:52 +00:00
Mathieu Arnold
9351586f46 Add a procedure for new committers with existing Phabricator account.
Sponsored by:	Absolight
2018-04-20 12:07:50 +00:00
Mathieu Arnold
b428c08fdf Split this into substeps.
Sponsored by:	Absolight
2018-04-17 11:05:42 +00:00
Mathieu Arnold
18312182fe Expand this step a bit.
Sponsored by:	Absolight
2018-04-17 10:56:44 +00:00
Mathieu Arnold
0ccfa863b4 Expand a bit the last step of the exp-run procedure.
Sponsored by:	Absolight
2018-04-17 10:54:36 +00:00
Warren Block
a026f7aa7e Spelling corrections, tense improvements, possessive removals, and the
removal of one really weak and labored pun.
2018-02-11 19:52:22 +00:00
Eitan Adler
29a6e3564c committer guide: correct link to Jenkins
Jenkins has moved. Chase it.
2018-02-11 05:50:22 +00:00
Mathieu Arnold
6308c4a76c Revert "Also allow security related updates in the blanket." 2018-01-08 17:25:43 +00:00
Mathieu Arnold
d78669b55b Also allow security related updates in the blanket.
Sponsored by:	Absolight
2018-01-08 16:46:20 +00:00
Mathieu Arnold
7beb6244af Catch up on the wiki's blanket's definition.
Reported by:	swills
Sponsored by:	Absolight
2018-01-08 16:46:15 +00:00
Eitan Adler
1d6a8965af all: use https for FreeBSD.org domains
This change excludes some generally unchanged files such as release
announcements, events, news, etc.
2017-12-30 22:56:56 +00:00
Oleksandr Tymoshenko
8f439721ae Provide more details for new committers on Bugzilla account merging
Update Bugzilla section of new committer's guide with more detailed
description of Bugzilla account merging and add reference to Kerberos
password generation/change. Based on emails bugmeister@ team receives these
items are the most common sources of confusion for new FeeBSD committers
when it comes to bugtracker.

Reviewed by:	mat
Differential Revision:	https://reviews.freebsd.org/D12828
2017-12-26 21:17:23 +00:00
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