Committer's Guide

The FreeBSD Documentation Project

Revision: 53619
Legal Notice
Last modified on 2019-11-21 17:38:49 by jhb.
Abstract

This document provides information for the FreeBSD committer community. All new committers should read this document before they start, and existing committers are strongly encouraged to review it from time to time.

Almost all FreeBSD developers have commit rights to one or more repositories. However, a few developers do not, and some of the information here applies to them as well. (For instance, some people only have rights to work with the Problem Report database). Please see Section 21, “Issues Specific to Developers Who Are Not Committers” for more information.

This document may also be of interest to members of the FreeBSD community who want to learn more about how the project works.

[ Split HTML / Single HTML ]

Table of Contents
1. Administrative Details
2. OpenPGP Keys for FreeBSD
3. Kerberos and LDAP web Password for FreeBSD Cluster
4. Commit Bit Types
5. Subversion Primer
6. Setup, Conventions, and Traditions
7. Pre-Commit Review
8. Commit Log Messages
9. Preferred License for New Files
10. Keeping Track of Licenses Granted to the FreeBSD Project
11. Developer Relations
12. If in Doubt...
13. Bugzilla
14. Phabricator
15. Who's Who
16. SSH Quick-Start Guide
17. Coverity® Availability for FreeBSD Committers
18. The FreeBSD Committers' Big List of Rules
19. Support for Multiple Architectures
20. Ports Specific FAQ
21. Issues Specific to Developers Who Are Not Committers
22. Information About Google Analytics
23. Miscellaneous Questions
24. Benefits and Perks for FreeBSD Committers

1. Administrative Details

Login Methodsssh(1), protocol 2 only
Main Shell Hostfreefall.FreeBSD.org
SMTP Host smtp.FreeBSD.org:587 (see also Section 6.2.1, “SMTP Access Setup”).
src/ Subversion Rootsvn+ssh://repo.FreeBSD.org/base (see also Section 5.2.2, “RELENG_* Branches and General Layout”).
doc/ Subversion Rootsvn+ssh://repo.FreeBSD.org/doc (see also Section 5.2.3, “FreeBSD Documentation Project Branches and Layout”).
ports/ Subversion Rootsvn+ssh://repo.FreeBSD.org/ports (see also Section 5.2.4, “FreeBSD Ports Tree Branches and Layout”).
Internal Mailing Listsdevelopers (technically called all-developers), doc-developers, doc-committers, ports-developers, ports-committers, src-developers, src-committers. (Each project repository has its own -developers and -committers mailing lists. Archives for these lists can be found in the files /local/mail/repository-name-developers-archive and /local/mail/repository-name-committers-archive on the FreeBSD.org cluster.)
Core Team monthly reports/home/core/public/monthly-reports on the FreeBSD.org cluster.
Ports Management Team monthly reports/home/portmgr/public/monthly-reports on the FreeBSD.org cluster.
Noteworthy src/ SVN Branches stable/n (n-STABLE), head (-CURRENT)

ssh(1) is required to connect to the project hosts. For more information, see Section 16, “SSH Quick-Start Guide”.

Useful links:

All FreeBSD documents are available for download at https://download.freebsd.org/ftp/doc/

Questions that are not answered by the documentation may be sent to <freebsd-questions@FreeBSD.org>.
Send questions about this document to <freebsd-doc@FreeBSD.org>.