Changeset View
Changeset View
Standalone View
Standalone View
documentation/content/en/articles/committers-guide/_index.adoc
Show First 20 Lines • Show All 2,204 Lines • ▼ Show 20 Lines | |||||
[.programlisting] | [.programlisting] | ||||
.... | .... | ||||
yourusername@FreeBSD.org yourlocalusername | yourusername@FreeBSD.org yourlocalusername | ||||
.... | .... | ||||
Where _yourlocalusername_ is the SASL username used to connect to the local instance of Postfix. | Where _yourlocalusername_ is the SASL username used to connect to the local instance of Postfix. | ||||
==== | ==== | ||||
[[smtp-setup-local-opensmtpd]] | |||||
.Using OpenSMTPD | |||||
[example] | |||||
==== | |||||
To tell a local OpenSMTPD instance that anything from `_yourusername_@FreeBSD.org` should be forwarded to the FreeBSD.org servers, add this to your [.filename]#smtpd.conf#: | |||||
[.programlisting] | |||||
.... | |||||
action "freebsd" relay host smtp+tls://freebsd@smtp.freebsd.org:587 auth <secrets> | |||||
match from any auth yourlocalusername mail-from "_yourusername_@freebsd.org" for any action "freebsd" | |||||
.... | |||||
Where _yourlocalusername_ is the SASL username used to connect to the local instance of OpenSMTPD. | |||||
Create [.filename]#/usr/local/etc/mail/secrets# with the following content: | |||||
[.programlisting] | |||||
.... | |||||
freebsd yourusername:yourpassword | |||||
.... | |||||
==== | |||||
[[mentors]] | [[mentors]] | ||||
=== Mentors | === Mentors | ||||
All new developers have a mentor assigned to them for the first few months. | All new developers have a mentor assigned to them for the first few months. | ||||
A mentor is responsible for teaching the mentee the rules and conventions of the project and guiding their first steps in the developer community. | A mentor is responsible for teaching the mentee the rules and conventions of the project and guiding their first steps in the developer community. | ||||
The mentor is also personally responsible for the mentee's actions during this initial period. | The mentor is also personally responsible for the mentee's actions during this initial period. | ||||
For committers: do not commit anything without first getting mentor approval. | For committers: do not commit anything without first getting mentor approval. | ||||
▲ Show 20 Lines • Show All 829 Lines • ▼ Show 20 Lines | |||||
Do not include whitespace changes with content changes in commits to [.filename]#doc/#. | Do not include whitespace changes with content changes in commits to [.filename]#doc/#. | ||||
The extra clutter in the diffs makes the translators' job much more difficult. | The extra clutter in the diffs makes the translators' job much more difficult. | ||||
Instead, make any style or whitespace changes in separate commits that are clearly labeled as such in the commit message. | Instead, make any style or whitespace changes in separate commits that are clearly labeled as such in the commit message. | ||||
=== Deprecating Features | === Deprecating Features | ||||
When it is necessary to remove functionality from software in the base system, follow these guidelines whenever possible: | When it is necessary to remove functionality from software in the base system, follow these guidelines whenever possible: | ||||
. Mention is made in the manual page and possibly the release notes that the option, utility, or interface is deprecated. Use of the deprecated feature generates a warning. | . Mention is made in the manual page and possibly the release notes that the option, utility, or interface is deprecated. Use of the deprecated feature generates a warning. | ||||
crees: Can you make this consistent with _yourusername_ above? Password too. | |||||
Not Done Inline ActionsIf you see the above example of Postfix it has similar alike keywords. Do you think I should change that too in that case? bofh: If you see the above example of Postfix it has similar alike keywords. Do you think I should… | |||||
Not Done Inline ActionsActually, I think this is OK, sorry. crees: Actually, I think this is OK, sorry. | |||||
. The option, utility, or interface is preserved until the next major (point zero) release. | . The option, utility, or interface is preserved until the next major (point zero) release. | ||||
. The option, utility, or interface is removed and no longer documented. It is now obsolete. It is also generally a good idea to note its removal in the release notes. | . The option, utility, or interface is removed and no longer documented. It is now obsolete. It is also generally a good idea to note its removal in the release notes. | ||||
=== Privacy and Confidentiality | === Privacy and Confidentiality | ||||
. Most FreeBSD business is done in public. | . Most FreeBSD business is done in public. | ||||
+ | + | ||||
FreeBSD is an _open_ project. | FreeBSD is an _open_ project. | ||||
▲ Show 20 Lines • Show All 571 Lines • Show Last 20 Lines |
Can you make this consistent with _yourusername_ above? Password too.