Differential D18708 Diff 52783 head/en_US.ISO8859-1/articles/committers-guide/article.xml

Changeset View

Standalone View

head/en_US.ISO8859-1/articles/committers-guide/article.xml

Show All 30 Lines	<copyright>
<year>2011</year>		<year>2011</year>
<year>2012</year>		<year>2012</year>
<year>2013</year>		<year>2013</year>
<year>2014</year>		<year>2014</year>
<year>2015</year>		<year>2015</year>
<year>2016</year>		<year>2016</year>
<year>2017</year>		<year>2017</year>
<year>2018</year>		<year>2018</year>
		<year>2019</year>
<holder>The &os; Documentation Project</holder>		<holder>The &os; Documentation Project</holder>
</copyright>		</copyright>

<legalnotice xml:id="trademarks" role="trademarks">		<legalnotice xml:id="trademarks" role="trademarks">
&tm-attrib.freebsd;		&tm-attrib.freebsd;
&tm-attrib.coverity;		&tm-attrib.coverity;
&tm-attrib.ibm;		&tm-attrib.ibm;
&tm-attrib.intel;		&tm-attrib.intel;
Show All 39 Lines	<tbody>

<row>		<row>
<entry><emphasis>Main Shell Host</emphasis></entry>		<entry><emphasis>Main Shell Host</emphasis></entry>
<entry><systemitem		<entry><systemitem
class="fqdomainname">freefall.FreeBSD.org</systemitem></entry>		class="fqdomainname">freefall.FreeBSD.org</systemitem></entry>
</row>		</row>

<row>		<row>
		<entry><emphasis>SMTP Host</emphasis></entry>
		<entry><literal><systemitem
		class="fqdomainname">smtp.FreeBSD.org</systemitem>:587</literal>
		(see also <xref linkend="smtp-setup"/>).</entry>
		</row>

		<row>
<entry><emphasis><literal>src/</literal> Subversion		<entry><emphasis><literal>src/</literal> Subversion
Root</emphasis></entry>		Root</emphasis></entry>
<entry><literal>svn+ssh://</literal><systemitem		<entry><literal>svn+ssh://</literal><systemitem
class="fqdomainname">repo.FreeBSD.org</systemitem><filename>/base</filename>		class="fqdomainname">repo.FreeBSD.org</systemitem><filename>/base</filename>
(see also <xref		(see also <xref
linkend="svn-getting-started-base-layout"/>).</entry>		linkend="svn-getting-started-base-layout"/>).</entry>
</row>		</row>

▲ Show 20 Lines • Show All 2,128 Lines • ▼ Show 20 Lines	<para>Log into <systemitem>freefall.FreeBSD.org</systemitem>
forwarded. This includes all of the commit messages as		forwarded. This includes all of the commit messages as
well as any other mail addressed to the &a.committers; and		well as any other mail addressed to the &a.committers; and
the &a.developers;. Really large mailboxes which have		the &a.developers;. Really large mailboxes which have
taken up permanent residence on		taken up permanent residence on
<systemitem>freefall</systemitem> may get truncated		<systemitem>freefall</systemitem> may get truncated
without warning if space needs to be freed, so forward it		without warning if space needs to be freed, so forward it
or save it elsewhere.</para>		or save it elsewhere.</para>

		<note>
		<para>If your e-mail system uses SPF with strict rules, you
		should whitelist <systemitem
		class="fqdomainname">mx2.FreeBSD.org</systemitem> from
		SPF checks.</para>
		</note>

<para>Due to the severe load dealing with SPAM places on the		<para>Due to the severe load dealing with SPAM places on the
central mail servers that do the mailing list processing,		central mail servers that do the mailing list processing,
the front-end server does do some basic checks and will		the front-end server does do some basic checks and will
drop some messages based on these checks. At the moment		drop some messages based on these checks. At the moment
proper DNS information for the connecting host is the only		proper DNS information for the connecting host is the only
check in place but that may change. Some people blame		check in place but that may change. Some people blame
these checks for bouncing valid email. To have these		these checks for bouncing valid email. To have these
checks turned off for your email, create a file		checks turned off for your email, create a file
named <filename>~/.spam_lover</filename>		named <filename>~/.spam_lover</filename>
on <systemitem		on <systemitem
class="fqdomainname">freefall.FreeBSD.org</systemitem>.</para>		class="fqdomainname">freefall.FreeBSD.org</systemitem>.</para>
</step>		</step>
</procedure>		</procedure>

<note>		<note>
<para>Those who are developers but not committers will		<para>Those who are developers but not committers will
not be subscribed to the committers or developers mailing		not be subscribed to the committers or developers mailing
lists. The subscriptions are derived from the access		lists. The subscriptions are derived from the access
rights.</para>		rights.</para>
</note>		</note>

		<sect3 xml:id="smtp-setup">
		<title>SMTP Access Setup</title>

		<para>For those willing to send e-mail messages through the
		FreeBSD.org infrastructure, follow the instructions
		below:</para>

		<procedure>
		<step>
		<para>Point your mail client at <literal><systemitem
		class="fqdomainname">smtp.FreeBSD.org</systemitem>:587</literal>.</para>
		</step>

		<step>
		<para>Enable STARTTLS.</para>
		</step>

		<step>
		<para>Ensure your <literal>From:</literal> address is set
		to
		<literal><replaceable>yourusername</replaceable>@FreeBSD.org</literal>.</para>
		</step>

		<step>
		<para>For authentication, you can use your &os; Kerberos
		username and password (see <xref
		linkend="kerberos-ldap"/>). The
		<literal><replaceable>yourusername</replaceable>/mail</literal>
		principal is preferred, as it is only valid for
		authenticating to mail resources.</para>

		<note>
		<para>Do not include <literal>@FreeBSD.org</literal>
		when entering in your username.</para>
		</note>
		</step>
		</procedure>

		<note>
		<title>Additional notes</title>

		<itemizedlist>
		<listitem>
		<para>Will only accept mail from
		<literal><replaceable>yourusername</replaceable>@FreeBSD.org</literal>.
		If you are authenticated as one user, you are not
		permitted to send mail from another.</para>
		</listitem>

		<listitem>
		<para>A header will be appended with the SASL username:
		(<literal>Authenticated sender:
		<replaceable>username</replaceable></literal>).</para>
		</listitem>

		<listitem>
		<para>Host has various rate limits in place to cut down
		on brute force attempts.</para>
		</listitem>
		</itemizedlist>
		</note>
		</sect3>
</sect2>		</sect2>

<sect2 xml:id="mentors">		<sect2 xml:id="mentors">
<title>Mentors</title>		<title>Mentors</title>

<para>All new developers have a mentor assigned to them for		<para>All new developers have a mentor assigned to them for
the first few months. A mentor is responsible for teaching		the first few months. A mentor is responsible for teaching
the mentee the rules and conventions of the project and		the mentee the rules and conventions of the project and
▲ Show 20 Lines • Show All 2,987 Lines • Show Last 20 Lines