<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "/usr/share/sgml/docbook/xml-dtd-4.1.2/docbookx.dtd">

<article id="index">
  <articleinfo>
    <title>gnome.org Account Policy</title>

    <copyright>
      <year>2001</year>
      <holder>The GNOME Foundation</holder>
    </copyright>
  </articleinfo>

  <sect1 id="introduction">
    <title>Introduction</title>

    <para>
      The machines at gnome.org host different services like WWW, FTP,
      CVS, and mail aliases.  This document describes the policies for
      getting the necessary accounts to modify the content of these
      services.  You should read this document if:

      <itemizedlist>
	<listitem>
	  <para>
	    You wish to have CVS write access to work on a GNOME
	    module.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    You are a module maintainer and wish to upload new
	    versions to the FTP site.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    You are going to maintain a section of the gnome.org web
	    pages.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    You wish to have an @gnome.org mail alias.
	  </para>
	</listitem>
      </itemizedlist>
    </para>
  </sect1>

  <sect1 id="requesting">
    <title>Requesting Accounts</title>

    <para>
      People who wish to obtain accounts at the gnome.org machines
      should send mail to <email>accounts@gnome.org</email> with the
      following information:

      <itemizedlist>
	<listitem>
	  <para>
	    The type of account they want.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Any qualifying information, such as "I need a CVS account
	    because the maintainer of module gnome-foo wants me to
	    commit my patches directly".
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Full name.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Permanent email address.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Requested account name.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Encrypted password as per <function>crypt(3)</function>.
	    <footnote>
	      <para>
		You can create a crypt()ed password by using Perl like
		this:

		<programlisting>
perl -e 'print (crypt ("password", "salt"), "\n")'
		</programlisting>

		Substitute "password" for your actual password and
		"salt" by a two-character string from the set
		[a-zA-Z0-9./].  For instance, you could use

		<programlisting>
perl -e 'print (crypt ("supersecret", "xy"), "\n")'
		</programlisting>
	      </para>
	    </footnote>
	  </para>
	</listitem>
      </itemizedlist>
    </para>

    <para>
      The <email>accounts@gnome.org</email> address is a small private
      mailing list composed of people who can approve account requests
      and will take care of physically creating the accounts.
    </para>

    <para>
      The following sections describe what qualifications you must
      have for the different types of accounts we can grant.
    </para>
  </sect1>

  <sect1 id="CVS">
    <title>CVS Accounts</title>

    <para>
      If you have been contributing to a project that is already
      hosted in cvs.gnome.org and the module maintainer approves it,
      you may request for an account in the GNOME CVS repository.
      That way you can commit your patches directly.
    </para>

    <para>
      Also, you may have a number of scattered patches to several
      GNOME modules and people may have put you on their hit list of
      "good hacker".  This is common for people who have been fixing
      bugs in GNOME here and there, and such people are very good
      candidates for CVS access.
    </para>

    <para>
      Translators who are making frequent changes and updates to
      translations may be granted a CVS account.  In any case, you
      should contact the coordinator of your language team so that
      there is no duplicated effort for translations.
    </para>

    <para>
      Finally, you may have a GNOME program that you have written and
      you may want to have it hosted in the GNOME CVS repository.  If
      the accounts committee and generally the people on the
      gnome-hackers mailing list agree that your program is a major
      contribution to GNOME, you may get access to the CVS repository
      to put your program there.
    </para>

    <para>
      Having a CVS account implies certain responsibilities, because
      you are modifying the master copy of the GNOME source code.
      Please read the <ulink
      url="http://developer.gnome.org/doc/guides/programming-guidelines/">GNOME
      Programming Guidelines</ulink> for the details.
    </para>

    <para>
      To ensure that maintainers and project leaders know who has been
      granted CVS access with their blessing, please include them on
      the list of recipients of your CVS account request.
    </para>

    <para>
      People with CVS accounts will automatically get a
      <email>username@cvs.gnome.org</email> mail alias so that they
      can be contacted easily in case they quickly need to fix
      something they did on CVS.
    </para>
  </sect1>

  <sect1 id="shell">
    <title>Shell Accounts</title>

    <para>
      Module maintainers need a shell account on the master.gnome.org
      machine so that they can upload their packages for distribution
      in the FTP site.  Unfortunately we cannot give out shell
      accounts to random people because of lack of resources.
    </para>

    <para>
      People who get a shell account will get added to the ftpadmin
      group so that they have write access to the FTP directory
      hierarchy.  When you get such an account, we will send you
      instructions on how to upload and set up your packages for
      distributions; we have some shell scripts on master.gnome.org to
      aid you in doing this.
    </para>
  </sect1>

  <sect1 id="web">
    <title>Web Page Maintenance</title>

    <para>
      If the maintainer of the GNOME web pages decides that you are a
      useful and frequent contributor, you can ask for a web
      administration account.  This involves a shell account and
      knowledge of the relevant CVS modules.
    </para>

    <para>
      The developer web pages on developer.gnome.org are maintained on
      the web-devel-2 module on CVS, so you only need a CVS account to
      contribute to them.
    </para>
  </sect1>

  <sect1 id="mail">
    <title>Mail Aliases</title>

    <para>
      Any member of the GNOME Foundation is eligible for a
      <email>@gnome.org</email> mail alias.  We cannot host real mail
      spools for everyone as resources are limited.  However, we will
      be happy to assign mail aliases to people who request them.
    </para>

    <para>
      If you are not a member of the GNOME Foundation please visit
      http://foundation.gnome.org and read the application guidelines.
    </para>

    <para>
      gnome.org email aliases are provided for the convenience of
      GNOME Foundation members and to facilitate the operation of the
      GNOME Project.  The GNOME Board has the right to revoke aliases
      at any time for any reason.  Types of mail that it is
      inappropriate to use a gnome.org alias in include:

      <itemizedlist>
	<listitem>
	  <para>
	    Mail sent for commercial purposes.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Mail that reflects badly on the GNOME project, including,
	    but not limited to harassing mail, offensive mail,
	    personal attacks, and attacks on competing projects.
	  </para>
	</listitem>

	<listitem>
	  <para>
	    Mail that misleadingly attempts to portray the official
	    positions of the GNOME project.
	  </para>
	</listitem>
      </itemizedlist>
    </para>

    <para>
      Use common sense. If you have doubts whether you should send
      mail from your gnome.org account, use a different account. If
      your mail might be interpreted as an official statement about
      GNOME positions, include a disclaimer.
    </para>
  </sect1>

  <sect1 id="misc">
    <title>Miscellanea</title>

    <para>
      People who already have accounts can mail
      <email>gnome-sysadmin@gnome.org</email> for assistance with
      technical issues.  We also have an
      <email>cvsmaster@gnome.org</email> for people who want to
      request CVS surgery, such as moving files around or removing
      stale CVS locks.  Please feel free to ask the sysadmins for
      information.
    </para>
  </sect1>

  <appendix id="not-contemplated">
    <title>Accounts not contemplated here</title>

    <para>
      There are other services in the gnome.org machines that may
      require an account.  The <ulink
      url="http://bugzilla.gnome.org">Bugzilla</ulink> bug tracking
      system is one of them.  However, you do not need permission to
      create an account there; simply visit the Bugzilla page and
      create an account if you wish to report bugs.
    </para>
  </appendix>
</article>
