aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/articles/committers-guide
Commit message (Collapse)AuthorAgeFilesLines
* Migrate doc to Hugo/AsciiDoctorSergio Carlavilla Delgado2021-01-252-5681/+0
| | | | | | | | | | | | | | | | | | | | | | | | I'm very pleased to announce the release of our new website and documentation using the new toolchain with Hugo and AsciiDoctor. To get more information about the new toolchain please read the FreeBSD Documentation Project Primer[1], Hugo docs[2] and AsciiDoctor docs[3]. Acknowledgment: Benedict Reuschling <bcr@> Glen Barber <gjb@> Hiroki Sato <hrs@> Li-Wen Hsu <lwhsu@> Sean Chittenden <seanc@> The FreeBSD Foundation [1] https://docs.FreeBSD.org/en/books/fdp-primer/ [2] https://gohugo.io/documentation/ [3] https://docs.asciidoctor.org/home/ Approved by: doceng, core
* Arch handbook and articles: Reword sentences beginning with 'Because...'Daniel Ebdrup Jensen2021-01-081-1/+1
| | | | | | | | | | | | These sentences can either be or be mistaken for being sentence fragments. While it is perfectly reasonable to use subordinate conjunctions conversationally, as long as both clauses are explicitly used in the same sentence, the handbook or articles are not written in this style. PR: 252493 Submitted by: Ceri Davies (ceri AT submonkey.net) Reviewed by: 0mp, pauamma (pauamma AT gundo.com)
* Expand changes possible without maintainer approval a bit.Mathieu Arnold2021-01-041-0/+6
|
* Fix the ports origin of the OpenSSH portMateusz Piotrowski2020-11-071-1/+1
| | | | Notes: svn path=/head/; revision=54676
* RIP bde@.Mark Linimon2020-10-101-12/+0
| | | | Notes: svn path=/head/; revision=54586
* Add a timeline for completion of mentorshipMuhammad Moinur Rahman2020-09-021-0/+9
| | | | | | | | | | | Committing with core-secretary@ hat on Submitted by: brooks Approved by: core Differential Revision: https://reviews.freebsd.org/D24246 Notes: svn path=/head/; revision=54458
* Add 2020 to copyrightGanbold Tsagaankhuu2020-08-101-0/+1
| | | | Notes: svn path=/head/; revision=54419
* Fix typos.Christian Brueffer2020-07-071-2/+2
| | | | Notes: svn path=/head/; revision=54315
* Improve wording to be more precise and clear.Hans Petter Selasky2020-06-201-1/+1
| | | | | | | | | | s/master repository/main repository/ Approved by: gjb@ Sponsored by: Mellanox Technologies Notes: svn path=/head/; revision=54285
* Passify igor: use tabs not spaces, wrap one line.Brooks Davis2020-03-311-77/+78
| | | | | | | | | It's now feasible to use igor to spellcheck this document. There are still a few reported issues, but I belive they are false positives due to nested <step>s. Notes: svn path=/head/; revision=54028
* Fix a typoMateusz Piotrowski2020-03-181-2/+1
| | | | | | | | Approved by: bcr (mentor) Differential Revision: https://reviews.freebsd.org/D24106 Notes: svn path=/head/; revision=53990
* Rewrite the platform Tier definitions.John Baldwin2019-11-211-137/+299
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Rewrite the prose description of Tiers to be structured as bullet lists of guarantees to users from the Project, guarantees to developers from the Project, and obligations on developers. This includes definitions of userland and kernel ABIs as well as documenting our current practice of ABI stability. The committments for ports are still vague and will require further refinement. Move the Tier status of architectures out of the committers guide and into a table on the platforms page the website listing the Tier for each architecture across currently supported stable branches as well as the projected Tiers for the next stable branch (in this case, 13.x). The table also lists individual TARGET_ARCH values to permit more granularity in Tier definitions (e.g. hard-float vs soft-float). Update the Unsupported Platforms table to only list removed architectures and include the last supported release of these architectures. This required adding anchors for relevant releases on the releases page. Reviewed by: bcr Discussed with: developers@ Differential Revision: https://reviews.freebsd.org/D22439 Notes: svn path=/head/; revision=53619
* Remove blanket exception for teamsSteve Wills2019-09-171-11/+0
| | | | | | | | | | | | | Summary: This rule doesn't seem to make sense any more. Let's remove it. Reviewers: #portmgr, adamw, mat Reviewed By: #portmgr, adamw, mat Differential Revision: https://reviews.freebsd.org/D21158 Notes: svn path=/head/; revision=53417
* Cleanup some textproc/igor warnings.Benedict Reuschling2019-09-051-26/+34
| | | | | | | Event: vBSDcon FreeBSD Hackathon Notes: svn path=/head/; revision=53374
* Wiki account issues have been delegated to wiki-admin@FreeBSD.org.Mark Linimon2019-09-021-1/+1
| | | | | | | Approved by: "just fix it" Notes: svn path=/head/; revision=53362
* Add a description on how to configure a local postfix to forwardMathieu Arnold2019-03-281-0/+55
| | | | | | | emails to the FreeBSD smtp servers. Notes: svn path=/head/; revision=52898
* Refer to the license policy document as the source of truth.Brooks Davis2019-03-121-0/+6
| | | | | | | | | | | | 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 Notes: svn path=/head/; revision=52861
* Committers Guide: Add a section encouraging pre-commit review.Brooks Davis2019-02-121-0/+95
| | | | | | | | | | | | 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 Notes: svn path=/head/; revision=52815
* Fix typo.Sergey Kandaurov2019-02-081-1/+1
| | | | Notes: svn path=/head/; revision=52802
* Add a note about direct commits for ports that have been removed from head.Mathieu Arnold2019-01-261-0/+6
| | | | Notes: svn path=/head/; revision=52783
* - add instructions for FreeBSD.org SMTP access setupDaniel Gerzo2019-01-111-0/+78
| | | | | | | | Reviewed by: bcr, mat, rpokala, allanjude Differential Revision: https://reviews.freebsd.org/D18708 Notes: svn path=/head/; revision=52763
* Move portmgr's blanket approval definition to the Committer's Guide, andMathieu Arnold2018-12-061-0/+47
| | | | | | | | | | shuffle a few things around. Reviewed by: bcr, adamw Differential Revision: https://reviews.freebsd.org/D18308 Notes: svn path=/head/; revision=52611
* Reword the quarterly blanket approvals so that it is less vague aboutMathieu Arnold2018-12-061-4/+4
| | | | | | | | | | what is getting authorized. Reviewed by: bcr, adamw Differential Revision: https://reviews.freebsd.org/D18308 Notes: svn path=/head/; revision=52610
* Make sure your new GPG key has a FreeBSD user ID.Rene Ladan2018-10-091-1/+1
| | | | Notes: svn path=/head/; revision=52346
* Minor cleanups of the committer guide from the textproc/igor output.Benedict Reuschling2018-08-171-27/+25
| | | | Notes: svn path=/head/; revision=52146
* [committer guide] update rules for contrib software.Eitan Adler2018-08-161-49/+28
| | | | | | | | | | | | - 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 Notes: svn path=/head/; revision=52130
* Committer guide: avoid confusing maintainers with hatsEitan Adler2018-07-261-6/+0
| | | | | | | | | | | | 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 Notes: svn path=/head/; revision=52061
* Address problems reported by John O'Brien in 228353. My changes differWarren Block2018-07-221-1/+18
| | | | | | | | | | | 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> Notes: svn path=/head/; revision=52048
* Clarify wording when warning about unauthorized MFHsMichael Gmelin2018-07-201-3/+3
| | | | | | | | Approved by: adamw Differential Revision: https://reviews.freebsd.org/D16355 Notes: svn path=/head/; revision=52036
* Add a tip about how to ask for a MFH when using a blanket approval.Mathieu Arnold2018-07-101-0/+14
| | | | | | | Sponsored by: Absolight Notes: svn path=/head/; revision=51985
* Committer guide: expand ports-secteam blanketEitan Adler2018-07-021-0/+5
| | | | | | | | | | | | This approves two additional blankets: - security issues version bumps - crash version bumps Reviewed by: feld With hat: ports-secteam Notes: svn path=/head/; revision=51942
* Committers guide: remove about hrs being maintainer of relnotesEitan Adler2018-06-301-6/+0
| | | | | | | | We now use 'relnotes: yes' instead of a manual email to an individual. Catch up to this. Notes: svn path=/head/; revision=51937
* Committers guide: simplification of the vendor merge sectionEitan Adler2018-06-301-8/+4
| | | | | | | | | - Remove comparison to CVS as we no longer use it - correct location of `--parents` - always quote and simplify admonition about zsh Notes: svn path=/head/; revision=51935
* Committers guide: pet igorEitan Adler2018-06-301-4/+5
| | | | Notes: svn path=/head/; revision=51934
* Committers guide: wordsmith the section on maintainersEitan Adler2018-06-301-12/+11
| | | | | | | | | | | | | | | - 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 Notes: svn path=/head/; revision=51933
* Committer's guide: update the ssh_configEitan Adler2018-06-301-1/+1
| | | | | | | | | Since committers need to login to freefall or other project resources, just always suggest using `*.freebsd.org` instead of making it a comment. Notes: svn path=/head/; revision=51932
* Committer guide: restore some information about svnsyncEitan Adler2018-06-171-29/+63
| | | | | | | | | | | | | 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 Notes: svn path=/head/; revision=51854
* Committer guide: generalise reviewEitan Adler2018-06-161-1/+1
| | | | | | | Some reviews go to other places. Just mention review in general. Notes: svn path=/head/; revision=51851
* Committer guide: remove non-exististant seed referenceEitan Adler2018-06-161-51/+8
| | | | | | | The seed file referenced does not exist anymore. Notes: svn path=/head/; revision=51850
* Committer guide: further remove merge information older branchesEitan Adler2018-06-161-44/+2
| | | | | | | | | | | 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). Notes: svn path=/head/; revision=51849
* Properly break some overflowing lines that textproc/igor was reporting.Benedict Reuschling2018-06-141-112/+117
| | | | | | | No visible content changes. Notes: svn path=/head/; revision=51831
* Fix links to the dogs of FreeBSD and IRC nicks links on the wiki.Benedict Reuschling2018-06-021-4/+4
| | | | | | | | | | Capitalize IRC. PR: 228457 Submitted by: 0mp@ Notes: svn path=/head/; revision=51767
* Committer guide: remove merge information for branches older than 10.xEitan Adler2018-05-281-143/+0
| | | | | | | | There are no such supported branches. Those that need to merge to such branches can get the information from the documentation archive. Notes: svn path=/head/; revision=51736
* Committer guide: be more generic about noteworthy branchesEitan Adler2018-05-281-3/+1
| | | | | | | | | 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. Notes: svn path=/head/; revision=51735
* Remove references to Perforce from the website.Gordon Tetlow2018-05-201-3/+3
| | | | | | | | | | | 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 Notes: svn path=/head/; revision=51679
* Fix preferred license.Warner Losh2018-05-201-1/+0
| | | | | | | | | 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. Notes: svn path=/head/; revision=51669
* Chase bugzilla product rename to just Services.Sean Chittenden2018-04-231-1/+1
| | | | | | | | Approved by: bcr Differential Revision: https://reviews.freebsd.org/D15163 Notes: svn path=/head/; revision=51585
* Typo in URL.Mathieu Arnold2018-04-201-1/+1
| | | | | | | Sponsored by: Absolight Notes: svn path=/head/; revision=51578
* Add a missing xml:id on the Phabricator section.Mathieu Arnold2018-04-201-1/+1
| | | | | | | Sponsored by: Absolight Notes: svn path=/head/; revision=51577
* whitespace fixes.Mathieu Arnold2018-04-201-26/+25
| | | | | | | Sponsored by: Absolight Notes: svn path=/head/; revision=51576
generated by cgit v1.2.3 (git 2.25.1) at 2025-08-25 00:32:53 +0000