Commit graph

562 commits

Author SHA1 Message Date
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
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