os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
51236 commits 1 branch 79 tags 298 MiB
Commit graph

562 commits

Author SHA1 Message Date
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
Glen Barber
5292536242 Reword a scary warning. 
Remove a few remaining vestigates of hub.

Prodded by:	jgh (proxied via postmaster@)
Sponsored by:	The FreeBSD Foundation
 2015-10-14 19:18:27 +00:00
Edward Tomasz Napierala
b865008cd6 Document "freebsd-sponsored-by" and "freebsd-mfc-after". 
Reviewed by:	gjb@
Approved by:	gjb@
Sponsored by:	The FreeBSD Foundation
 2015-08-24 08:23:54 +00:00
Patrick Kelsey
e579c3b3cc Remove trailing "@" from team approval example in Committer's Guide, 
plus incorporate additional content and formatting suggestions made by
wblock.

Differential Revision: https://reviews.freebsd.org/D3128
Reviewed by: wblock
Approved by: doceng (wblock)
Approved by: jmallett (mentor)
 2015-07-20 18:27:34 +00:00
Xin LI
2bed4d5006 s/svn.freebsd.org/repo.freebsd.org/ when appropriate. I have left the 
mirroring portion out because it's svn://, not svn+ssh:// and may be
different.
 2015-07-14 23:38:20 +00:00
Xin LI
e1d89928bc Reflect Peter's email regarding svn.freebsd.org changes -- developers 
should now use repo.FreeBSD.org for commits.
 2015-07-14 23:33:24 +00:00
Warren Block
ef904adea3 Surprising to see 
surprised
spelled with a z.
 2015-07-14 22:07:01 +00:00
Matthew Seaman
74d8e01b4f Fix typo 
Approved by:	doceng (gjb, implicit)
 2015-07-14 18:26:10 +00:00
Matthew Seaman
319e698e06 Introduce a new Code of Conduct. 
Update the Committer's Guide

  - section 21 covers much of the same areas as the new Code of
    Conduct, but the CoC is authoritative.  Update wording where
    there is some disagreement.

  - Add a new section on Privacy and Confidentiality which was felt to
    be too committer specific to go into the general Code of Conduct.

With hat:	core-secretary
Reviewed by:	gjb, core
Approved by:	core
 2015-07-14 17:56:30 +00:00
Glen Barber
8163f7d37d Remove references to hub, updating or removing entirely as 
appropriate.

Sponsored by:	The FreeBSD Foundation
 2015-06-22 03:26:55 +00:00
Mathieu Arnold
48f66a431f Add pkg-status to the "How do I know if my port is building correctly" 
question.  While there, axe the ports freeze section.

Differential Revision:	https://reviews.freebsd.org/D2403
Approved by:	gjb, wblock (mentors)
Sponsored by:	Absolight
 2015-04-30 19:34:03 +00:00
Eitan Adler
6c608de18b committer guide: don't point people to beefy 
Requested by:	bdrewery
 2015-04-26 17:11:00 +00:00
Eitan Adler
091f5908e7 committer guide: point people to beefy instead of pointyhay 
- these new logs actually exist
 2015-04-26 17:05:42 +00:00
Eitan Adler
64dbd1394a committer guide: remove additional www/ references 
- we havn't added/removed categories since the switch to svn I guess ;)
 2015-04-26 16:54:39 +00:00
Eitan Adler
5044b02740 committer guide: igor and whitespace cleanup 
- clean up whitespace in committer guide
 2015-04-26 16:31:29 +00:00
Eitan Adler
d3c4036af0 committer guide: mention phabricator 
- point people to phabricator just like we do for bugzilla`
 2015-04-26 16:13:03 +00:00
Eitan Adler
321e6d99d0 committer guide: remove www/ reference; mention igor 
- www/ is the old repo for doc/*/htdocs so don't mention it anymore
- explicitly mention using igor for both docbook and man pages
- use <package> rather than command for manck
 2015-04-26 16:08:51 +00:00
Eitan Adler
65321df79a committer guide: point people at the correct subversion primer 
The old link pointed to the wiki which pointed back at this article
 2015-04-26 15:57:37 +00:00
Brad Davis
d9fbffc21e Document how to use 'Differential Revision:'. 
PR:		197500
 2015-04-24 02:15:35 +00:00
Warner Losh
2ada15cebb Add a last-second note about ia64. Also, review applies to prior 
commit.

Differential Revision: https://reviews.freebsd.org/D2289
 2015-04-14 18:14:06 +00:00
Warner Losh
59b02d3f40 Tweak the Tier policy and wording slightly to match current reality. 
Also, move ia64 to Tier 4 status starting in FreeBSD 11. Keep it in
the Tier 2 status category until FreeBSD 10 ages out of support.

Consistently use Toolchain maintainers (plural) and adjust surrounding
verbs, etc to match.
 2015-04-14 18:09:14 +00:00
Eitan Adler
33428dd6e8 Committer guide: gramos and typos 
Submitted by:	wblock
 2015-04-03 05:11:59 +00:00
Eitan Adler
7e356bbf2f committer-guide: 
- move perks into a question rather than its own section
	- stop directing people to email me directly and instead direct people
	  to email the liasion alias
 2015-04-03 01:33:54 +00:00
Eitan Adler
b01ccacb90 Generalize the rules for cross-tree committers 
The section previously about doc committers in the src repo had information
relevant to all committers.  Generalize this section.

Approved by:	core
 2015-03-31 19:13:31 +00:00
Eitan Adler
b544187783 stop comparing to CVS 
Finish the job of r45149 and remove reference to now undocumented 'better
features' of CVS.

Remove note about difference between location of www repo between CVS
and SVN: we switched long enough ago now that it doesn't matter.

Remove additional comparisons to CVS which likely don't matter to committers
anymore.
 2015-03-30 08:25:38 +00:00
Mathieu Arnold
0b9c47980a s/pkg_/pkg / 
Sponsored by:	Absolight
 2015-03-06 15:37:11 +00:00
Mathieu Arnold
a6b46d2cd1 Add xml:id to the qaandaentry in the ports FAQ. 
Sponsored by:	Absolight
 2015-03-06 15:14:28 +00:00
Mathieu Arnold
50c685ebe5 Reword port resurrection instructions instructions to be more clear. 
Add a bit about how to request and apply merge to the ports' quarterly branches.

Differential Revision: https://reviews.freebsd.org/D2006
Approved by:	wblock
Sponsored by:	Absolight
 2015-03-06 14:05:41 +00:00
Glen Barber
a58a6dc75a Note that doc committers are allowed to update the 
documentation within the ports/ tree as necessary.

Update copyright year while here.

Sponsored by:	The FreeBSD Foundation
 2015-01-28 14:58:51 +00:00
Craig Rodrigues
bcfbfb4968 List some services which require Kerberos password. 2014-11-29 01:16:18 +00:00
Jason Helfman
24e341fd47 - drop gnats id (html anchor) from committers-guide 
- change linking in internal site, and remove gnats referrences

Differential Revision:	https://reviews.freebsd.org/D1177
Approved by:	bcr (mentor)
 2014-11-24 17:31:34 +00:00
Warren Block
1e07a71a55 Whitespace-only fixes, translators please ignore. 2014-11-06 03:33:44 +00:00
Warren Block
3c5e1f1f1c In the section on re-adding a deleted port, clarify what addport is and 
link back to the section where it is described.  Also clean up some of
the language in that first section.
 2014-11-06 03:12:49 +00:00
Brad Davis
4150de2c1d - Use the correct argument for svn up vs svn co 2014-11-01 22:39:42 +00:00
Gavin Atkinson
c218af171a Update another example PR number for Bugzilla rather than GNATS, missed 
in r45528.

PR:		192930
 2014-09-03 20:01:22 +00:00
Gavin Atkinson
862a49e940 Fix example referencing PRs: we don't use the categories for PR numbers 
with Bugzilla

PR:		192930
Submitted by:	ngie
 2014-08-27 12:53:32 +00:00
Enji Cooper
856670e1e5 Document how committers can merge non-FreeBSD.org Bugzilla accounts 
Approved by: jmmv (mentor)
Reviewed by: wblock
 2014-08-21 19:45:22 +00:00
Alex Dupre
2fda475d12 Fix svn repo paths. 
PR:		192613
Submitted by:	dvl
 2014-08-12 15:14:21 +00:00
Glen Barber
90587cb82f Note that kpasswd.f.o must be accessed from a machine outside 
of the FreeBSD.org cluster.

Submitted by:	many
Final prodding:	imp
Sponsored by:	The FreeBSD Foundation
 2014-08-12 02:58:27 +00:00
Gavin Atkinson
078afa378f Use a SVN branch name rather than an old CVS name in an example. 2014-08-06 16:58:55 +00:00
Eitan Adler
1658dd8632 Stop comparing svn to CVS. We havn't used CVS in a long time, and its 
unlikely that new contributors have either.
 2014-06-29 07:40:21 +00:00
Eitan Adler
84a6a0a338 Keep up with the world of bugzilla 2014-06-29 07:40:20 +00:00
Eitan Adler
f5e11c7f75 Stop document edit-pr and friends now. 2014-06-29 07:40:18 +00:00
Eitan Adler
12d2a3d49d - Non-redistribution of content on the developers@ mailing list has 
little to do with copyright and more to do with ethics.

- Make it more clear what type of content is off-topic on developers@
 2014-06-28 19:54:59 +00:00
Eitan Adler
88e5278159 The script in ~fenner relies on CVS. I've modified it for svn. 
In addition, call out that technical conversations should not happen in
private.
 2014-06-28 19:37:32 +00:00
Warren Block
4963c4ca05 Spelling, bad phrase, and missing link corrections. 2014-06-24 13:52:01 +00:00
Warren Block
3d1300b921 Whitespace-only fixes, translators please ignore. 2014-06-24 13:38:27 +00:00
Warren Block
897a8350aa Clarify and organize the steps for new committers. 2014-06-24 13:20:27 +00:00
Gabor Pali
60e0ca41f5 - Fix a typo 2014-06-22 09:51:49 +00:00
Gabor Pali
4fc4b56e75 - Add a section on keeping track of licenses granted to the Project 
Submitted by:	core
 2014-06-21 09:43:30 +00:00
Christian Brueffer
74c900c9d5 Fix links to the SVN mirror list. 
PR:		190962
Submitted by:	Sergey V. Dyatko
 2014-06-13 10:26:42 +00:00
Glen Barber
4a0f178f2b Document that zsh users should escape '^' when using the '^/head' 
subversion syntax for merging.

Sponsored by:	The FreeBSD Foundation
 2014-06-04 15:34:42 +00:00
Warren Block
74068a9dd2 Fix numerous things in the Conventions and Traditions section. 2014-06-01 01:04:58 +00:00
Warren Block
9bb801aff1 Clarify changes to be made by new committers to committers-*.dot files. 
Minor markup and clarity changes for immediate area added to submitted
patch.

Submitted by:	pkelsey
 2014-05-31 15:39:10 +00:00
Benedict Reuschling
37383a44b0 Remove some redundant words, add capitalization to titles, as well as 
redundant markup and words around <filename>.
 2014-05-24 20:44:43 +00:00
Warren Block
331e30e001 Whitespace-only fixes, translators please ignore. 2014-04-13 01:40:20 +00:00
Warren Block
5fe8bbe8ef Recover lost <replaceable> tags. 2014-04-13 01:29:40 +00:00
Glen Barber
8040c27e48 Add a note about where to look for information about updating 
ssh keys for the cluster.

Sponsored by:	The FreeBSD Foundation
 2014-04-08 01:13:54 +00:00
Glen Barber
6b8df10c49 Document the 'Relnotes:' commit template line. 
Sponsored by:	The FreeBSD Foundation
 2014-03-20 19:19:22 +00:00
Rene Ladan
1710a1aa24 ru@ left, so move him from the alumni section. Also remove him from the 
Committers Guide ("mr mdoc").
 2014-03-10 13:30:15 +00:00
Glen Barber
2df638cdde Make the text regarding the new merge policy for stable/10 
less hard to miss.

Submitted by:	rwatson
Sponsored by:	The FreeBSD Foundation
 2014-03-09 16:05:01 +00:00
Craig Rodrigues
fbc63e5a98 Add note for setting Kerberos password. 
Learned from: peter
 2014-02-26 21:27:52 +00:00
Glen Barber
82ac8d333e Dereference the SVN->CVS exporter. 
Sponsored by:	The FreeBSD Foundation
 2014-02-21 22:16:31 +00:00
Warren Block
4ab95997c1 Typo fix. 
Submitted by:	jgh
 2014-02-10 22:42:22 +00:00
Warren Block
c7a8a11682 Add a tip to the Vendor Imports with SVN section showing how to deal 
with vendor merges for packages which were in the tree before the
cvs2svn conversion.

Submitted by:	gshapiro@
Reviewed by:	gshapiro@
 2014-02-10 17:29:56 +00:00
Warren Block
94d53355f6 Add an 'svn up' step to the Ports repo copy answer (discussed on IRC 
with zi@).

Add IDs to all the ports qandadiv elements for easy linking.  Other
minor fixes.
 2014-02-05 05:52:37 +00:00
Mathieu Arnold
fcc09ead19 Remove LATEST_LINK mentions, nobody should use it, ever. 
Sponsored by:	Absolight
 2014-02-04 14:09:02 +00:00
Remko Lodder
ab8c12ecde Correct layout. By breaking this line into an additional line, the output is 
not just one single line but it is two lines, where one is blank.  That is
inconsistent with the other examples.

Facilitated by:	    Snow B.V.
 2014-01-22 11:47:58 +00:00
Warren Block
3a39b7c20a Miscellaneous punctuation and markup fixes. 2014-01-05 22:52:50 +00:00
Warren Block
7a3d8abb09 Whitespace-only fixes, translators please ignore. 2014-01-05 22:45:51 +00:00
Rene Ladan
439ff3e52a - Correct repository path in section 16.3.1 (restoring a removed port). 
- Add 2014 as copyright year
 2013-12-31 15:16:27 +00:00
Warren Block
7621bec9f3 Add instructions on creating an OpenPGP key. Also add a checkkey.sh 
script that can be used to test keys for minimal security requirements.
A long list of people helped with this.  In particular, Michael Lucas
and David Wolfskill contributed many corrections and suggestions.  I
started the script based on the addkey.sh script, and David Wolfskill
worked it into something usable.  After more testing, the text can
suggest using it to check keys before committing them.

Reviewed by:	accounts@, postmaster@, mwl@, sbruno@, gavin@
 2013-12-27 22:57:39 +00:00
Glen Barber
214d6f9e50 Fix build. 
Pointyhat:	gjb
Sponsored by:	The FreeBSD Foundation
 2013-12-09 16:25:24 +00:00
Glen Barber
77db3bf8bb Clarify the releng/ merge sentence. 
Submitted by:	wblock
Sponsored by:	The FreeBSD Foundation
 2013-12-09 16:10:05 +00:00
Glen Barber
95ecb782e4 Make it clear that merges to releng/N.M branches should originate from 
the corresponding stable/N branch.

Reviewed by:	gavin
Sponsored by:	The FreeBSD Foundation
 2013-12-09 15:37:30 +00:00
Ed Maste
9f76c4aa26 Remove reference to CVS from Subversion Primer opening paragraph 
The last of the three trees switched from CVS over a year ago, and
detailed notes on the dates and revision numbers of the three
switchovers appear later on.

Reviewed by:	gjb
 2013-12-09 15:09:28 +00:00
Eitan Adler
80ac50a87b Fix, odd comma 2013-12-08 20:03:50 +00:00
Eitan Adler
e806e04158 Document the "Dogs of FreeBSD" page. 2013-12-08 20:01:07 +00:00
Eitan Adler
72f4e4107a Misc fixes to the merging section of the committer's guide: 
- add xml:id to section header
	- remove period of title
	- correctly capitalize title
	- adding missing ','

Reported by:	lint^W wblock
 2013-12-08 02:23:48 +00:00
Eitan Adler
0ab43263c7 Update the merging chapter and explain the new merging policy. 
Reviewed by:	peter
 2013-12-07 23:00:33 +00:00