head	1.14;
access;
symbols
	TIGRIS_1_1_0RC2:1.9.6.1
	TIGRIS_1_1_0RC1:1.9.6.1
	TIGRIS_1_1:1.9.6.1.0.2
	TIGRIS_1_0_8:1.9
	TIGRIS_1_0_8RC3:1.9
	TIGRIS_1_0_8RC2:1.9
	TIGRIS_1_0_8RC1:1.9
	TIGRIS_1_0_7:1.9
	TIGRIS_1_0_7RC3:1.9
	TIGRIS_1_0_7RC2:1.9
	TIGRIS_1_0_7RC1:1.9
	TIGRIS_1_0_6:1.9
	TIGRIS_1_0_6RC5:1.9
	TIGRIS_1_0_6RC4:1.9
	TIGRIS_1_0_6RC3:1.9
	TIGRIS_1_0_6RC2:1.9
	TIGRIS_1_0_6RC1:1.9
	TIGRIS_1_0_5:1.9
	TIGRIS_1_0_5RC6:1.9
	TIGRIS_1_0_5RC5:1.9
	TIGRIS_1_0_5RC4:1.9
	TIGRIS_1_0_5RC3:1.9
	TIGRIS_1_0_5RC2:1.9
	TIGRIS_1_0_5RC1:1.9
	TIGRIS_1_0_4:1.9
	TIGRIS_1_0_3:1.9
	TIGRIS_1_0_2:1.9
	TIGRIS_1_0_1:1.9
	TIGRIS_1_0:1.9.0.6
	TIGRIS_1_0_0:1.9
	TIGRIS_1_0_0_RC1:1.9.0.2;
locks; strict;
comment	@# @;


1.14
date	2001.08.20.17.54.08;	author tberry;	state Exp;
branches;
next	1.13;

1.13
date	2001.08.17.01.11.47;	author tberry;	state Exp;
branches;
next	1.12;

1.12
date	2001.07.03.00.02.39;	author tberry;	state Exp;
branches;
next	1.11;

1.11
date	2001.06.21.07.07.40;	author jefflove;	state Exp;
branches;
next	1.10;

1.10
date	2001.06.11.03.14.33;	author jefflove;	state Exp;
branches;
next	1.9;

1.9
date	2001.03.12.08.32.26;	author lori;	state Exp;
branches
	1.9.6.1;
next	1.8;

1.8
date	2001.03.10.02.03.46;	author lori;	state Exp;
branches;
next	1.7;

1.7
date	2001.02.22.01.00.55;	author lori;	state Exp;
branches;
next	1.6;

1.6
date	2001.02.15.21.43.49;	author lori;	state Exp;
branches;
next	1.5;

1.5
date	2001.02.15.21.24.26;	author lori;	state Exp;
branches;
next	1.4;

1.4
date	2001.02.11.18.29.47;	author jrobbins;	state Exp;
branches;
next	1.3;

1.3
date	2001.02.09.00.59.20;	author susank;	state Exp;
branches;
next	1.2;

1.2
date	2001.02.05.16.40.26;	author lori;	state Exp;
branches;
next	1.1;

1.1
date	2001.01.29.19.44.19;	author lori;	state Exp;
branches;
next	;

1.9.6.1
date	2001.07.31.18.38.13;	author tberry;	state Exp;
branches;
next	;


desc
@@


1.14
log
@added info in on deleting archived mail items.
Issue number:
Obtained from:
Submitted by:
Reviewed by:
@
text
@  <div class="docs" id="projectownermailinglists">
   <h2>Managing project mailing lists</h2>

   <div class="toc">
    <h3>Project help for project owner administration: Index</h3>

    <ul>
     <li>
      <a href="ProjectOwnerAdmin.html">Project owner administration</a> 

      <ul>
       <li><a href="ProjectOwnerEdit.html">Editing and maintaining the Project Home page</a></li>

       <li><a href="ProjectOwnerNews.html">Managing project site news</a></li>

       <li><a href="ProjectOwnerFiles.html">Managing project files</a></li>

       <li><a href="ProjectOwnerMembers.html">Adding project members and approving roles</a></li>

       <li>
        <strong>You are here:</strong> Configuring and managing project mailing lists 

            <ul>
              <li><a href="#aboutlists">About default project mailing lists</a></li>
              <li><a href="#addlists">Adding and deleting mailing lists</a></li>
              <li><a href="#archivedel">Deleting archived mail items</a></li>
              <li><a href="#mailadmin">Mailing list administration and policies</a></li>
              <li><a href="#editsubscribers">Editing subscribers and moderators</a></li>
            </ul>
       </li>

       <li><a href="ProjectOwnerDocuments.html">Managing project documentation</a></li>

       <li><a href="ProjectOwnerSource.html">Managing project source code</a></li>

       <li><a href="ProjectOwnerIssues.html">Tracking project issues</a></li>

       <li><a href="/servlets/HelpTOC">Back to the main Help index</a></li>
      </ul>
     </li>
    </ul>
   </div>

   <h3><a id="aboutlists" name="aboutlists">About default project mailing lists</a></h3>

   <p>All project mailing lists are created with <a href="http://anzu.tigris.org/">anzu</a>, an open source mail alias and list management extension of qmail simple mail transfer protocol (smtp). Anzu supports multiple domains, enabling each project to define and manage its own unique set of mailing lists for the project domain.</p>

   <p>If you created your project as a standard development project, your project begins its life with five built-in, pre-configured mailing lists:</p>

   <dl>
    <dt>dev@@projectname.domain.com</dt>

    <dd>The main list for developers to discuss specific project development issues and requirements for version control in the project.</dd>

    <dt>cvs@@projectname.domain.com</dt>

    <dd>Automated notifications of file version control changes and discussion of those changes.</dd>

    <dt>announce@@projectname.domain.com</dt>

    <dd>Announcements of new releases and other major project events.</dd>

    <dt>issues@@projectname@@domain.com</dt>

    <dd>Automated notifications and discussions of the project's reported issues (defects, enhancements, features, tasks, and patches) and changes made to issues, such as reassignment, comments, or resolution.</dd>

    <dt>users@@projectname.domain.com</dt>

    <dd>A more general discussion list for the project's end users.</dd>
   </dl>

   <p>Discussion-only projects are set up with one discussion mailing list initially.</p>

   <p>You can access your project's existing mailing lists in two different ways:</p>

   <ul>
    <li>Clicking the <i>Mailing Lists</i> link in the Project Resources tool bar displays your project's <b>Mailing Lists</b> page. An edit link appears for each mailing list that opens a <b>Mailing List Edit</b> screen for that particular list.</li>

    <li>In the <b>Project Edit</b> page (reached by clicking the <i>Admin</i> link in the Project Resources tool bar), links at the bottom of the page lead to a <b>Mailing List Edit</b> screen for each list.</li>
   </ul>

   <p>For an explanation of fields and options on the <b>Mailing List Edit</b> page, see <a href="#mailadmin">Mailing list administration and policies</a> below.</p>

   <h3><a id="addlists" name="addlists">Adding and deleting mailing lists</a></h3>

   <p>Your project's growth and progression may warrant adding mailing lists at some point ... or perhaps deleting lists. The default mailing lists created along with your project are "top-level" lists. Should traffic relating to a particular module or component becomes too high for one or more of these lists, you can splinter that discussion off into its own arena by create a separate new mailing list.</p>

   <p>Add a new mailing list by going to the <b>Project Edit</b> page and clicking the "new" link in the bottom Mailing Lists section. This action leads you to the <b>Add New Mailing List</b> page to set up and configure your newest list. See the following section about list administration and policies for more information about the fields and settings in this screen.</p>

   
  <p>To delete a mailing list, click the mailing list link in the <b>Project Edit</b> 
    page to open <b>Edit Mailing List</b> page. Click the <i>Delete Mailing List</i> 
    link just above the buttons on this screen. Another page displays asking for 
    delete confirmation before the action is completed.</p>
  <h3><a name="archivedel"></a>Deleting archived mail items</h3>
  <p>Periodically, you may find a need to delete obsoleted archived messages from a mail list.  To do this, navigate to the archive of the mail list in which the item appears.  Select the time period and then find the item you want to delete. Click the <i>Delete</i> link.  You will need to verify the delete on the next screen by selecting either the yes or no radio button and clicking on the <em>Submit Query</em> button.
  </p>
  <p><!--See MS notes for more info. --> 
  </p>
  <h3><a id="mailadmin" name="mailadmin">Mailing list administration and policies</a></h3>

   <p>As the project owner you can choose to modify your project's default mailing list settings, add new lists, delete unnecessary lists, add and remove subscribers, designate moderators, and set other mailing list parameters.</p>

   <p>Both the <b>Add Mailing List</b> and <b>Edit Mailing List</b> page settings include:</p>

   <ul>
    <li>a list description text field,</li>

    <li>a prefix to appear on the subject line of all messages,</li>

    <li>an automatically generated trailer with subscribe/unsubscribe instructions which can be toggled on or off.</li>
   </ul>

   <p>The "List Type" options refer to how you want to set the mailing list policies for handling subscriptions and posting.</p>

   <ul>
    <li><b>Private checkbox:</b> If your project is under proprietary licensing, your mailing lists are restricted to project members only and the list archives are also private by default. Only users who are members of your private project have the necessary permissions to view these mailing lists and the associated archives.</li>

    <li>If your project is under open source licensing, you can select among several different combination of these policies, depending upon the purpose of the list.</li>
   </ul>

   <dl>
    <dt>Posting policy</dt>

    <dd>
     This determines how the list handles posts from non-subscribers and subscribers. For open source projects, mailing lists can be configured to handle message posts at three different levels: 

     <ul>
      <li>"<b>Discuss</b>" allows subscribers to post, and moderates posts (requires approval) from non-subscribers.</li>

      <li>"<b>Moderated</b>" moderates <i>all</i> posts.</li>

      <li>"<b>Unmoderated</b>" allows anyone to post messages without moderation.</li>
     </ul>
    </dd>

    <dt>Subscription moderation</dt>

    <dd>
     This determines whether subscription to the list is "open" or "-private." Anyone can subscribe to open lists. Marking a list as "private" has two implications: 

     <ul>
      <li>Subscribers must be approved by the list moderator.</li>

      <li>List archives are not publicly viewable. Users who do not have permission to see the archives do not see links to subscribe to these lists either.</li>
     </ul>

     <p>By default, subscriptions to proprietary project mailing lists are on an approval basis because these lists are always private. This means that even members of a private project must be approved by a list moderator to subscribe to project mailing lists.</p>
    </dd>
   </dl>

   <h3><a id="editsubscribers" name="editsubscribers">Editing subscribers and moderators</a></h3>

   <p>You can add and remove mailing list subscribers, designate list moderators, and suppress certain users from posting messages using the links in the "Members" section of the <b>Edit Mailing List</b> page: <i>Edit Subscribers</i>, <i>Edit Digest Subscribers</i>, <i>Edit Moderators</i>, <i>Edit Allowed Posters</i>.</p>

   
  <p>These links display an edit screen where you can designate users by email 
    address for the desired action. You may also alter the Private component; 
    on to allow only project members to see the contents of the maillist archive, 
    off to allow anyone who can see the project access to the archive.</p>

   
  <p>For those mailing lists designated as unmoderated, you always have control 
    over who may post messages to any of your project mailing lists as the project 
    owner. If someone abuses list privileges or fails to comply with mailing list 
    etiquette on an unmoderated list, you must be able to disallow further postings 
    from this person. For moderated lists, your designated moderator has the permissions 
    to edit list subscribers.</p>

   <p><!--
      <P>Other pre-set mailing list features include:
     <ul>
     <li>Indexing 
     <li>Archiving 
     <li>List digest setup
     *** <li>No archive guards, enabling any user to retrieve archived list messages in the case of open mailing lists.
     *** <li>Public          = true (the list will respond to admin commands like
                             subscribe)

     *** <li>request_address = true (makes life easier for people who are used to majordomo)
     *** <li>Remote administration, allowing list moderators to subscribe people to the list via e-mail  (other useful things***)
     </ul>

      <p>Discussion lists include two addition features when the posting policy is set for either "announce" or "automated-notification":

     <ul>
     ***<li>Message "extras" are disallowed, stripping messages of certain mime types.
     ***<li>Posted message size restrictions requiring messages to be a minimum of 2 bytes and a maximum of 400 kb. This restriction is not applied to the other types of mailing lists by default but can be set up through domain level administration.
     </ul>
     -->
   </p>

   <div class="courtesylinks">
    <p><a href="/servlets/HelpTOC">Back to main Help index</a></p>
   </div>
  </div>
 


@


1.13
log
@started adding info in on deleting archived items.
Issue number:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d96 1
a96 1
  <p>You may find a need to delete obsoleted archived messages from a mail list. 
d98 1
a98 1
  <p><!--go to the archive.  Select month.  Select item you want to delete.  Click delete link.  Confirm delete using radio butons (yes/no).  Click submit query button.  See MS notes for more info. --> 
@


1.12
log
@edited for clearer identification of private checkbox.
Issue number:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d23 7
a29 9
        <ul>
         <li><a href="#aboutlists">About default project mailing lists</a></li>

         <li><a href="#addlists">Adding and deleting mailing lists</a></li>

         <li><a href="#mailadmin">Mailing list administration and policies</a></li>

         <li><a href="#editsubscribers">Editing subscribers and moderators</a></li>
        </ul>
d90 11
a100 3
   <p>To delete a mailing list, click the mailing list link in the <b>Project Edit</b> page to open <b>Edit Mailing List</b> page. Click the <i>Delete Mailing List</i> link just above the buttons on this screen. Another page displays asking for delete confirmation before the action is completed.</p>

   <h3><a id="mailadmin" name="mailadmin">Mailing list administration and policies</a></h3>
d156 13
a168 4
   <p>These links display an edit screen where you can designate users by email address for the desired action. You may also imposed list filters in this screen. <!-- parameters for filters? -->
   </p>

   <p>Even for those mailing lists you have designated as unmoderated, you always have control over who may post messages to any of your project mailing lists as the project owner. If someone abuses list privileges or fails to comply with mailing list etiquette on an unmoderated list, you must be able to disallow further postings from this person. For moderated lists, your designated moderator has the permissions to edit list subscribers.</p>
@


1.11
log
@html usage revision
@
text
@d111 1
a111 1
    <li>If your project is under proprietary licensing, your mailing lists are restricted to project members only and the list archives are also private by default. Only users who are members of your private project have the necessary permissions to view these mailing lists and the associated archives.</li>
@


1.10
log
@extensive markup rework - first pass toward house xhtmlification
@
text
@d1 2
a2 14
<!DOCTYPE html PUBLIC "-//CollabNet//DTD XHTML 1.0 Transitional//EN"
"http://collabnet.com/dtds/collabnet_transitional_10.dtd">
<html>
 <head>
  <title>Managing project mailing lists</title>
<style type="text/css">
 dt.c2 {font-weight: bold}
 div.c1 {margin-left: 2em}
</style>
 </head>

 <body>
  <div class="docs" id="docid">
<h2>Managing project mailing lists</h2> 
d4 2
a5 1
  <p><b>Project help for project owner administration: Index</b></p>
d7 6
a12 3
  <div>
   <dl>
    <dt><a href="ProjectOwnerAdmin.html">Project owner administration</a></dt>
d14 1
a14 1
    <dd><a href="ProjectOwnerEdit.html">Editing and maintaining the Project Home page</a></dd>
d16 1
a16 1
    <dd><a href="ProjectOwnerNews.html">Managing project site news</a></dd>
d18 1
a18 1
    <dd><a href="ProjectOwnerFiles.html">Managing project files</a></dd>
d20 2
a21 1
    <dd><a href="ProjectOwnerMembers.html">Adding project members and approving roles</a></dd>
d23 2
a24 2
    <dd>
     <b>You are here: Configuring and managing project mailing lists</b>
d26 1
a26 2
     <ul>
      <li><b><a href="#aboutlists">About default project mailing lists</a></b></li>
d28 1
a28 1
      <li><b><a href="#addlists">Adding and deleting mailing lists</a></b></li>
d30 3
a32 1
      <li><b><a href="#mailadmin">Mailing list administration and policies</a></b></li>
d34 1
a34 3
      <li><b><a href="#editsubscribers">Editing subscribers and moderators</a></b></li>
     </ul>
    </dd>
d36 1
a36 1
    <dd><a href="ProjectOwnerDocuments.html">Managing project documentation</a></dd>
d38 1
a38 1
    <dd><a href="ProjectOwnerSource.html">Managing project source code</a></dd>
d40 5
a44 1
    <dd><a href="ProjectOwnerIssues.html">Tracking project issues</a></dd>
d46 1
a46 5
    <dt><a href="/servlets/HelpTOC">Back to the main Help index</a></dt>
   </dl>
  </div>
  
  <h3><a id="aboutlists" name="aboutlists">About default project mailing lists</a></h3> 
d48 1
a48 1
  <p>All project mailing lists are created with <a href="http://anzu.tigris.org/">anzu</a>, an open source mail alias and list management extension of qmail simple mail transfer protocol (smtp). Anzu supports multiple domains, enabling each project to define and manage its own unique set of mailing lists for the project domain.</p>
d50 1
a50 1
  <p>If you created your project as a standard development project, your project begins its life with five built-in, pre-configured mailing lists:</p>
a51 1
  <blockquote>
d53 1
a53 1
    <dt class="c2">dev@@projectname.domain.com</dt>
d55 1
a55 2
    <dd>
     The main list for developers to discuss specific project development issues and requirements for version control in the project. 
d57 1
a57 2
     
    </dd>
d59 1
a59 1
    <dt class="c2">cvs@@projectname.domain.com</dt>
d61 1
a61 2
    <dd>
     Automated notifications of file version control changes and discussion of those changes. 
d63 1
a63 2
     
    </dd>
d65 1
a65 1
    <dt class="c2">announce@@projectname.domain.com</dt>
d67 1
a67 2
    <dd>
     Announcements of new releases and other major project events. 
d69 1
a69 2
     
    </dd>
d71 2
a72 1
    <dt class="c2">issues@@projectname@@domain.com</dt>
d74 1
a74 2
    <dd>
     Automated notifications and discussions of the project's reported issues (defects, enhancements, features, tasks, and patches) and changes made to issues, such as reassignment, comments, or resolution. 
d76 1
a76 2
     
    </dd>
d78 2
a79 1
    <dt class="c2">users@@projectname.domain.com</dt>
d81 2
a82 3
    <dd>A more general discussion list for the project's end users.</dd>
   </dl>
  </blockquote>
d84 1
a84 1
  <p>Discussion-only projects are set up with one discussion mailing list initially.</p>
d86 1
a86 1
  <p>You can access your project's existing mailing lists in two different ways:</p>
d88 1
a88 2
  <ul>
   <li>Clicking the <i>Mailing Lists</i> link in the Project Resources tool bar displays your project's <b>Mailing Lists</b> page. An edit link appears for each mailing list that opens a <b>Mailing List Edit</b> screen for that particular list.</li>
d90 1
a90 2
   <li>In the <b>Project Edit</b> page (reached by clicking the <i>Admin</i> link in the Project Resources tool bar), links at the bottom of the page lead to a <b>Mailing List Edit</b> screen for each list.</li>
  </ul>
d92 1
a92 3
  <p>For an explanation of fields and options on the <b>Mailing List Edit</b> page, see <a href="#mailadmin">Mailing list administration and policies</a> below.</p>
  
  <h3><a id="addlists" name="addlists">Adding and deleting mailing lists</a></h3> 
d94 1
a94 1
  <p>Your project's growth and progression may warrant adding mailing lists at some point ... or perhaps deleting lists. The default mailing lists created along with your project are "top-level" lists. Should traffic relating to a particular module or component becomes too high for one or more of these lists, you can splinter that discussion off into its own arena by create a separate new mailing list.</p>
d96 1
a96 1
  <p>Add a new mailing list by going to the <b>Project Edit</b> page and clicking the "new" link in the bottom Mailing Lists section. This action leads you to the <b>Add New Mailing List</b> page to set up and configure your newest list. See the following section about list administration and policies for more information about the fields and settings in this screen.</p>
d98 1
a98 3
  <p>To delete a mailing list, click the mailing list link in the <b>Project Edit</b> page to open <b>Edit Mailing List</b> page. Click the <i>Delete Mailing List</i> link just above the buttons on this screen. Another page displays asking for delete confirmation before the action is completed.</p>
  
  <h3><a id="mailadmin" name="mailadmin">Mailing list administration and policies</a></h3> 
d100 2
a101 1
  <p>As the project owner you can choose to modify your project's default mailing list settings, add new lists, delete unnecessary lists, add and remove subscribers, designate moderators, and set other mailing list parameters.</p>
d103 1
a103 1
  <p>Both the <b>Add Mailing List</b> and <b>Edit Mailing List</b> page settings include:</p>
d105 2
a106 2
  <ul>
   <li>a list description text field,</li>
d108 1
a108 1
   <li>a prefix to appear on the subject line of all messages,</li>
d110 2
a111 2
   <li>an automatically generated trailer with subscribe/unsubscribe instructions which can be toggled on or off.</li>
  </ul>
d113 2
a114 1
  <p>The "List Type" options refer to how you want to set the mailing list policies for handling subscriptions and posting.</p>
d116 2
a117 2
  <ul>
   <li>If your project is under proprietary licensing, your mailing lists are restricted to project members only and the list archives are also private by default. Only users who are members of your private project have the necessary permissions to view these mailing lists and the associated archives.</li>
d119 2
a120 2
   <li>If your project is under open source licensing, you can select among several different combination of these policies, depending upon the purpose of the list.</li>
  </ul>
d122 2
a123 1
  
d125 1
a125 2
  <dl>
   <dt class="c2">Posting policy</dt>
d127 3
a129 2
   <dd>
    This determines how the list handles posts from non-subscribers and subscribers. For open source projects, mailing lists can be configured to handle message posts at three different levels: 
d131 1
a131 1
    
d133 2
a134 3
    <ul>
     <li>
      "<b>Discuss</b>" allows subscribers to post, and moderates posts (requires approval) from non-subscribers. 
d136 2
a137 2
      
     </li>
d139 2
a140 2
     <li>
      "<b>Moderated</b>" moderates <i>all</i> posts. 
d142 3
a144 2
      
     </li>
d146 1
a146 2
     <li>"<b>Unmoderated</b>" allows anyone to post messages without moderation.</li>
    </ul>
d148 1
a148 2
    
   </dd>
d150 2
a151 1
   <dt class="c2">Subscription moderation</dt>
d153 1
a153 2
   <dd>
    This determines whether subscription to the list is "open" or "-private." Anyone can subscribe to open lists. Marking a list as "private" has two implications: 
d155 9
a163 1
    
d165 3
a167 3
    <ul>
     <li>
      Subscribers must be approved by the list moderator. 
d169 1
a169 2
      
     </li>
d171 6
a176 2
     <li>List archives are not publicly viewable. Users who do not have permission to see the archives do not see links to subscribe to these lists either.</li>
    </ul>
d178 5
a182 46
    <p>By default, subscriptions to proprietary project mailing lists are on an approval basis because these lists are always private. This means that even members of a private project must be approved by a list moderator to subscribe to project mailing lists.</p>
   </dd>
  </dl>

  
  
  <h3><a id="editsubscribers" name="editsubscribers">Editing subscribers and moderators</a></h3> 

  <p>You can add and remove mailing list subscribers, designate list moderators, and suppress certain users from posting messages using the links in the "Members" section of the <b>Edit Mailing List</b> page: <i>Edit Subscribers</i>, <i>Edit Digest Subscribers</i>, <i>Edit Moderators</i>, <i>Edit Allowed Posters</i>.</p>

  <p>These links display an edit screen where you can designate users by email address for the desired action. You may also imposed list filters in this screen. <!-- parameters for filters? -->
  </p>

  <p>Even for those mailing lists you have designated as unmoderated, you always have control over who may post messages to any of your project mailing lists as the project owner. If someone abuses list privileges or fails to comply with mailing list etiquette on an unmoderated list, you must be able to disallow further postings from this person. For moderated lists, your designated moderator has the permissions to edit list subscribers.</p>

  <p><!--
   <P>Other pre-set mailing list features include:
  <ul>
  <li>Indexing 
  <li>Archiving 
  <li>List digest setup
  *** <li>No archive guards, enabling any user to retrieve archived list messages in the case of open mailing lists.
  *** <li>Public          = true (the list will respond to admin commands like
                          subscribe)

  *** <li>request_address = true (makes life easier for people who are used to majordomo)
  *** <li>Remote administration, allowing list moderators to subscribe people to the list via e-mail  (other useful things***)
  </ul>

   <p>Discussion lists include two addition features when the posting policy is set for either "announce" or "automated-notification":

  <ul>
  ***<li>Message "extras" are disallowed, stripping messages of certain mime types.
  ***<li>Posted message size restrictions requiring messages to be a minimum of 2 bytes and a maximum of 400 kb. This restriction is not applied to the other types of mailing lists by default but can be set up through domain level administration.
  </ul>
  -->
  </p>
  
<div class="courtesylinks">
  <a href="Help.html">Back to main Help index</a>
</div>

   
 </div>
</body>
</html>
@


1.9
log
@fixed index; added link for ProjectOwnerDocuments.html
@
text
@d1 10
a10 151
<HTML>
<HEAD>
<TITLE>Managing project mailing lists</TITLE>
</HEAD>

<BODY>
<SPAN CLASS="Header">Managing project mailing lists</SPAN> 
<P>  
<SPAN CLASS="PlainText"><B>Project help for project owner administration: Index</B>
<P>
<UL>
<DL>
<DT><A HREF="ProjectOwnerAdmin.html">Project owner administration</A>
<DD><A HREF="ProjectOwnerEdit.html">Editing and maintaining the Project Home page</A>
<DD><A HREF="ProjectOwnerNews.html">Managing project site news</A>
<DD><A HREF="ProjectOwnerFiles.html">Managing project files</A>
<DD><A HREF="ProjectOwnerMembers.html">Adding project members and approving roles</A>
<DD><B>You are here: Configuring and managing project mailing lists
	<UL>
	<LI><A HREF="#aboutlists">About default project mailing lists</A>
	<LI><A HREF="#addlists">Adding and deleting mailing lists</A>
	<LI><A HREF="#mailadmin">Mailing list administration and policies</A>
	<LI><A HREF="#editsubscribers">Editing subscribers and moderators</A>
    </UL></B>
<dd><a href="ProjectOwnerDocuments.html">Managing project documentation</a>
<DD><A HREF="ProjectOwnerSource.html">Managing project source code</A>
<DD><A HREF="ProjectOwnerIssues.html">Tracking project issues</A>
<DT><A HREF="/servlets/HelpTOC">Back to the main Help index</A>
</DL>
</UL>

<P>
<HR NOSHADE SIZE=1>
<A NAME="aboutlists"></A><SPAN CLASS="InputHeader">About default project mailing lists</SPAN>
<P>
All project mailing lists are created with <A HREF="http://anzu.tigris.org/" TARGET="_new">anzu</A>, an open source mail alias and list management extension of qmail simple mail transfer protocol (smtp). Anzu supports multiple domains, enabling each project to define and manage its own unique set of mailing lists for the project domain.

<P>
If you created your project as a standard development project, your project begins its life with five built-in, pre-configured mailing lists:

<BLOCKQUOTE>
    <DL>
	<DT><B>dev@@projectname.domain.com</B> <DD>The main list for developers to discuss specific project development issues and requirements for version control in the project.
<P>
	<DT><B>cvs@@projectname.domain.com</B> <DD>Automated notifications of file version control changes and discussion of those changes.
<P>
    <DT><B>announce@@projectname.domain.com</B> <DD>Announcements of new releases and other major project events.
<P>
	<DT><B>issues@@projectname@@domain.com</B> <DD>Automated notifications and discussions of the project's reported issues (defects, enhancements, features, tasks, and patches) and changes made to issues, such as reassignment, comments, or resolution.
<P>
    <DT><B>users@@projectname.domain.com</B> <DD>A more general discussion list for the project's end users.
    </DL>
    </BLOCKQUOTE> 
<P>
Discussion-only projects are set up with one discussion mailing list initially.
<P>
You can access your project's existing mailing lists in two different ways:
<UL>
<LI>Clicking the <I>Mailing Lists</I> link in the Project Resources tool bar displays your project's <B>Mailing Lists</B> page. An edit link appears for each mailing list that opens a <B>Mailing List Edit</B> screen for that particular list.
<P>
<LI>In the <B>Project Edit</B> page (reached by clicking the <I>Admin</I> link in the Project Resources tool bar), links at the bottom of the page lead to a <B>Mailing List Edit</B> screen for each list.
</UL>
<P>
For an explanation of fields and options on the <B>Mailing List Edit</B> page, see <A HREF="#mailadmin">Mailing list administration and policies</A> below.
<P>
<HR NOSHADE SIZE=1>
<A NAME="addlists"></A><SPAN CLASS="InputHeader">Adding and deleting mailing lists</SPAN>
<P>
Your project's growth and progression may warrant adding mailing lists at some point ... or perhaps deleting lists. The default mailing lists created along with your project are "top-level" lists. Should traffic relating to a particular module or component becomes too high for one or more of these lists, you can splinter that discussion off into its own arena by create a separate new mailing list.
<P>
Add a new mailing list by going to the <B>Project Edit</B> page and clicking the "new" link in the bottom Mailing Lists section. This action leads you to the <B>Add New Mailing List</B> page to set up and configure your newest list. See the following section about list administration and policies for more information about the fields and settings in this screen.
<P>
To delete a mailing list, click the mailing list link in the <B>Project Edit</B> page to open <B>Edit Mailing List</B> page. Click the <I>Delete Mailing List</I> link just above the buttons on this screen. Another page displays asking for delete confirmation before the action is completed.

<P>
<HR NOSHADE SIZE=1>
<SPAN CLASS="InputHeader"><A NAME="mailadmin">Mailing list administration and policies</A></SPAN>
	
<P>
As the project owner you can choose to modify your project's default mailing list settings, add new lists, delete unnecessary lists, add and remove subscribers, designate moderators, and set other mailing list parameters.
<P>
Both the <B>Add Mailing List</B> and <B>Edit Mailing List</B> page settings include:
<UL>
<LI>a list description text field,
<LI>a prefix to appear on the subject line of all messages,
<LI>an automatically generated trailer with subscribe/unsubscribe instructions which can be toggled on or off.
</UL>
<P>The "List Type" options refer to how you want to set the mailing list policies for handling subscriptions and posting.
<UL>
<LI>If your project is under proprietary licensing, your mailing lists are restricted to project members only and the list archives are also private by default. Only users who are members of your private project have the necessary permissions to view these mailing lists and the associated archives. 
<P>
<LI>If your project is under open source licensing, you can select among several different combination of these policies, depending upon the purpose of the list. 
</UL>
<P>
	<DL>
	<DT><B>Posting policy</B>
	<DD>This determines how the list handles posts from non-subscribers and subscribers. For open source projects, mailing lists can be configured to handle message posts at three different levels:
<P>
		<UL>
		<LI>"<B>Discuss</B>" allows subscribers to post, and moderates posts (requires approval) from non-subscribers.
		<P>
		<LI>"<B>Moderated</B>" moderates <I>all</I> posts.
		<P>
		<LI>"<B>Unmoderated</B>" allows anyone to post messages without moderation.
		</UL>
	<P>
	<DT><B>Subscription moderation</B>
	<DD>This determines whether subscription to the list is "open" or "-private." Anyone can subscribe to open lists. Marking a list as "private" has two implications:
<P>
		<UL>
		<LI>Subscribers must be approved by the list moderator.
		<P>
		<LI>List archives are not publicly viewable. Users who do not have permission to see the archives do not see links to subscribe to these lists either.
		</UL>
<P>
By default, subscriptions to proprietary project mailing lists are on an approval basis because these lists are always private. This means that even members of a private project must be approved by a list moderator to subscribe to project mailing lists.
	</DL>
<P>

<HR NOSHADE SIZE=1>
<SPAN CLASS="InputHeader"><A NAME="editsubscribers">Editing subscribers and moderators</A></SPAN>

<P>
You can add and remove mailing list subscribers, designate list moderators, and suppress certain users from posting messages using the links in the "Members" section of the <B>Edit Mailing List</B> page: <I>Edit Subscribers</I>, <I>Edit Digest Subscribers</I>, <I>Edit Moderators</I>, <I>Edit Allowed Posters</I>.
<P>
These links display an edit screen where you can designate users by email address for the desired action. You may also imposed list filters in this screen. <!-- parameters for filters? -->
<P>
Even for those mailing lists you have designated as unmoderated, you always have control over who may post messages to any of your project mailing lists as the project owner. If someone abuses list privileges or fails to comply with mailing list etiquette on an unmoderated list, you must be able to disallow further postings from this person. For moderated lists, your designated moderator has the permissions to edit list subscribers.
<P>

<!--
	<P>Other pre-set mailing list features include:
<ul>
<li>Indexing 
<li>Archiving 
<li>List digest setup
*** <li>No archive guards, enabling any user to retrieve archived list messages in the case of open mailing lists.
*** <li>Public          = true (the list will respond to admin commands like
                        subscribe)

*** <li>request_address = true (makes life easier for people who are used to majordomo)
*** <li>Remote administration, allowing list moderators to subscribe people to the list via e-mail  (other useful things***)
</ul>

	<p>Discussion lists include two addition features when the posting policy is set for either "announce" or "automated-notification":

<ul>
***<li>Message "extras" are disallowed, stripping messages of certain mime types.
***<li>Posted message size restrictions requiring messages to be a minimum of 2 bytes and a maximum of 400 kb. This restriction is not applied to the other types of mailing lists by default but can be set up through domain level administration.
</ul>
-->
d12 3
d16 218
a233 2
<HR NOSHADE SIZE=1>
<A HREF="Help.html">Back to main Help index</A></P></SPAN>
a234 1
</SPAN>
a235 2
</BODY>
</HTML>
@


1.9.6.1
log
@fixed link to Help.html
Issue number:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d155 1
a155 1
<A HREF="/servlets/HelpTOC">Back to main Help index</A></P></SPAN>
@


1.8
log
@added info about private mailing list archives (issue 2280)
@
text
@d25 1
@


1.7
log
@revising document index and links
@
text
@d7 1
a7 3
<TABLE BORDER="0" CELLSPACING="1" CELLPADDING="3" BORDER="0" WIDTH="100%">
  <TR>
    <SPAN CLASS="Header">Managing project mailing lists</SPAN> 
d21 1
a21 1
	<LI><A HREF="#addlists">Adding new mailing lists</A>
d33 1
a33 1
<A NAME="aboutlists"></A><SPAN CLASS="InputHeader"><B>About default project mailing lists</B></SPAN>
d55 9
a63 4

	<P>You can customize your project mailing lists through your <I>Project Edit</I> page. Mailing list links at the bottom of the page display an <B>Edit Mailing List</B> screen for each list. For an explanation of fields and options, see <A HREF="#mailadmin">Mailing list administration and policies</A> below.


d66 1
a66 1
<A NAME="addlists"></A><SPAN CLASS="InputHeader"><B>Adding and deleting mailing lists</B></SPAN>
d70 1
a70 1
Add a new mailing list in the <B>Project Edit</B> page by clicking the "new" link in the bottom Mailing Lists section. This action leads you to the <B>Add New Mailing List</B> page to set up and configure your newest list. See the following section about list administration and policies for more information about the fields and settings in this screen.
d79 1
a79 1
As the project owner you can choose to modify your project's default mailing list settings, add new lists, delete unnecessary lists, add and remove subscribers, designate moderators, and set other mailing list parameters. 
d87 6
a92 1
<P>The "List Type" options refer to how you want to set the mailing list policies for handling subscriptions and posting. Because mailing lists for projects with proprietary licensing are limited to project members, the lists are already private by default. If your project is under open source licensing, you can select among several different combination of these policies, depending upon the purpose of the list. 
d97 1
d100 1
d102 1
d107 1
a107 1
	<DD>This determines whether subscription to the list is "open" or "-private." Anyone can subscribe to open lists. Private lists require subscribers to be approved. By default, subscriptions to proprietary project mailing lists are on an approval basis because these lists are always private, that is, limited to project members.
d109 7
a115 1
	
a118 1

d157 1
a157 2
</TR>
</TABLE>
@


1.6
log
@html edits; revised doc index
@
text
@d3 2
a5 3
<TITLE>Managing Project Mailing Lists</TITLE>

</HEAD>
d9 1
a9 1
    <SPAN CLASS="Header" NOWRAP>Managing project mailing lists</SPAN> 
d20 1
a20 1
<DD><B>You are here: Configuring and managing project mailing lists</B>
d26 1
a26 1
    </UL>
d78 1
a78 1
The Edit Mailing List screen settings include:
d84 1
a84 1
<P>The "List Type" options refer to setting mailing list policy for subscriptions and posting. Whether your project is under open source or proprietary licensing determines the default list policies.
a86 3
	<DT><B>Subscription moderation</B>
	<DD>Subscriptions to mailing lists can be either open or private, that is, on an approval basis. Subscriptions to proprietary project mailing lists are on an approval basis by default because these lists are always private, that is, limited to project members. 
<P>
d88 1
a88 1
	<DD>If you are leading an open source project, mailing lists can be configured to handle message posts at three different levels:
d94 5
d100 2
a102 1
<P>
a137 1
<A HREF="ProjectOwnerAdmin.html">Back to Project Owner Administration help</A><BR>
a142 1

@


1.5
log
@resolved merge conflicts due to added header tags
@
text
@d12 1
a12 1
<SPAN CLASS="PlainText">Project help for project owner administration: Index
@


1.4
log
@added <title> tags to all files
@
text
@d136 1
@


1.3
log
@removed window's nasty line breaks, and corrected more links in HelpBox files
PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d1 7
d142 2
@


1.2
log
@updated for new help format
@
text
@d1 134
a134 134
<TABLE BORDER="0" CELLSPACING="1" CELLPADDING="3" BORDER="0" WIDTH="100%">
  <TR>
    <SPAN CLASS="Header" NOWRAP>Managing project mailing lists</SPAN> 
<P>  
<SPAN CLASS="PlainText">Project help for project owner administration: Index
<P>
<UL>
<DL>
<DT><A HREF="ProjectOwnerAdmin.html">Project owner administration</A>
<DD><A HREF="ProjectOwnerEdit.html">Editing and maintaining the Project Home page</A>
<DD><A HREF="ProjectOwnerNews.html">Managing project site news</A>
<DD><A HREF="ProjectOwnerFiles.html">Managing project files</A>
<DD><A HREF="ProjectOwnerMembers.html">Adding project members and approving roles</A>
<DD><B>You are here: Configuring and managing project mailing lists</B>
	<UL>
	<LI><A HREF="#aboutlists">About default project mailing lists</A>
	<LI><A HREF="#addlists">Adding new mailing lists</A>
	<LI><A HREF="#mailadmin">Mailing list administration and policies</A>
	<LI><A HREF="#editsubscribers">Editing subscribers and moderators</A>
    </UL>
<DD><A HREF="ProjectOwnerSource.html">Managing project source code</A>
<DD><A HREF="ProjectOwnerIssues.html">Tracking project issues</A>
<DT><A HREF="/servlets/HelpTOC">Back to the main Help index</A>
</DL>
</UL>

<P>
<HR NOSHADE SIZE=1>
<A NAME="aboutlists"></A><SPAN CLASS="InputHeader"><B>About default project mailing lists</B></SPAN>
<P>
All project mailing lists are created with <A HREF="http://anzu.tigris.org/" TARGET="_new">anzu</A>, an open source mail alias and list management extension of qmail simple mail transfer protocol (smtp). Anzu supports multiple domains, enabling each project to define and manage its own unique set of mailing lists for the project domain.

<P>
If you created your project as a standard development project, your project begins its life with five built-in, pre-configured mailing lists:

<BLOCKQUOTE>
    <DL>
	<DT><B>dev@@projectname.domain.com</B> <DD>The main list for developers to discuss specific project development issues and requirements for version control in the project.
<P>
	<DT><B>cvs@@projectname.domain.com</B> <DD>Automated notifications of file version control changes and discussion of those changes.
<P>
    <DT><B>announce@@projectname.domain.com</B> <DD>Announcements of new releases and other major project events.
<P>
	<DT><B>issues@@projectname@@domain.com</B> <DD>Automated notifications and discussions of the project's reported issues (defects, enhancements, features, tasks, and patches) and changes made to issues, such as reassignment, comments, or resolution.
<P>
    <DT><B>users@@projectname.domain.com</B> <DD>A more general discussion list for the project's end users.
    </DL>
    </BLOCKQUOTE> 
<P>
Discussion-only projects are set up with one discussion mailing list initially.

	<P>You can customize your project mailing lists through your <I>Project Edit</I> page. Mailing list links at the bottom of the page display an <B>Edit Mailing List</B> screen for each list. For an explanation of fields and options, see <A HREF="#mailadmin">Mailing list administration and policies</A> below.


<P>
<HR NOSHADE SIZE=1>
<A NAME="addlists"></A><SPAN CLASS="InputHeader"><B>Adding and deleting mailing lists</B></SPAN>
<P>
Your project's growth and progression may warrant adding mailing lists at some point ... or perhaps deleting lists. The default mailing lists created along with your project are "top-level" lists. Should traffic relating to a particular module or component becomes too high for one or more of these lists, you can splinter that discussion off into its own arena by create a separate new mailing list.
<P>
Add a new mailing list in the <B>Project Edit</B> page by clicking the "new" link in the bottom Mailing Lists section. This action leads you to the <B>Add New Mailing List</B> page to set up and configure your newest list. See the following section about list administration and policies for more information about the fields and settings in this screen.
<P>
To delete a mailing list, click the mailing list link in the <B>Project Edit</B> page to open <B>Edit Mailing List</B> page. Click the <I>Delete Mailing List</I> link just above the buttons on this screen. Another page displays asking for delete confirmation before the action is completed.

<P>
<HR NOSHADE SIZE=1>
<SPAN CLASS="InputHeader"><A NAME="mailadmin">Mailing list administration and policies</A></SPAN>
	
<P>
As the project owner you can choose to modify your project's default mailing list settings, add new lists, delete unnecessary lists, add and remove subscribers, designate moderators, and set other mailing list parameters. 
<P>
The Edit Mailing List screen settings include:
<UL>
<LI>a list description text field,
<LI>a prefix to appear on the subject line of all messages,
<LI>an automatically generated trailer with subscribe/unsubscribe instructions which can be toggled on or off.
</UL>
<P>The "List Type" options refer to setting mailing list policy for subscriptions and posting. Whether your project is under open source or proprietary licensing determines the default list policies.
<P>
	<DL>
	<DT><B>Subscription moderation</B>
	<DD>Subscriptions to mailing lists can be either open or private, that is, on an approval basis. Subscriptions to proprietary project mailing lists are on an approval basis by default because these lists are always private, that is, limited to project members. 
<P>
	<DT><B>Posting policy</B>
	<DD>If you are leading an open source project, mailing lists can be configured to handle message posts at three different levels:
		<UL>
		<LI>"<B>Discuss</B>" allows subscribers to post, and moderates posts (requires approval) from non-subscribers.
		<LI>"<B>Moderated</B>" moderates <I>all</I> posts.
		<LI>"<B>Unmoderated</B>" allows anyone to post messages without moderation.
		</UL>
	</DL>

<P>
<HR NOSHADE SIZE=1>
<SPAN CLASS="InputHeader"><A NAME="editsubscribers">Editing subscribers and moderators</A></SPAN>

<P>
You can add and remove mailing list subscribers, designate list moderators, and suppress certain users from posting messages using the links in the "Members" section of the <B>Edit Mailing List</B> page: <I>Edit Subscribers</I>, <I>Edit Digest Subscribers</I>, <I>Edit Moderators</I>, <I>Edit Allowed Posters</I>.
<P>
These links display an edit screen where you can designate users by email address for the desired action. You may also imposed list filters in this screen. <!-- parameters for filters? -->
<P>
Even for those mailing lists you have designated as unmoderated, you always have control over who may post messages to any of your project mailing lists as the project owner. If someone abuses list privileges or fails to comply with mailing list etiquette on an unmoderated list, you must be able to disallow further postings from this person. For moderated lists, your designated moderator has the permissions to edit list subscribers.
<P>

<!--
	<P>Other pre-set mailing list features include:
<ul>
<li>Indexing 
<li>Archiving 
<li>List digest setup
*** <li>No archive guards, enabling any user to retrieve archived list messages in the case of open mailing lists.
*** <li>Public          = true (the list will respond to admin commands like
                        subscribe)

*** <li>request_address = true (makes life easier for people who are used to majordomo)
*** <li>Remote administration, allowing list moderators to subscribe people to the list via e-mail  (other useful things***)
</ul>

	<p>Discussion lists include two addition features when the posting policy is set for either "announce" or "automated-notification":

<ul>
***<li>Message "extras" are disallowed, stripping messages of certain mime types.
***<li>Posted message size restrictions requiring messages to be a minimum of 2 bytes and a maximum of 400 kb. This restriction is not applied to the other types of mailing lists by default but can be set up through domain level administration.
</ul>
-->


<HR NOSHADE SIZE=1>
<A HREF="Help.html">Back to main Help index</A></P></SPAN>

</SPAN>
</TR>
</TABLE>

@


1.1
log
@new and revised help documentation for v1.0
@
text
@d3 5
a7 7
    <TD CLASS="Header" NOWRAP>Managing project mailing lists</TD> 
  </TR>
</TABLE>

<TABLE BORDER="0" CELLSPACING="2" CELLPADDING="2" BORDER="0" WIDTH="100%">
  <TR>
<SPAN CLASS="PlainText">
d9 6
d16 4
a19 4
	<DT><A HREF="#aboutlists">About default project mailing lists</A>
	<DT><A HREF="#addlists">Adding new mailing lists</A>
	<DT><A HREF="#mailadmin">Mailing list administration and policies</A>
	<DT><A HREF="#editsubscribers">Editing subscribers and moderators</A>
d21 3
d25 1
a25 1
	<P>
d28 1
a28 1
<HR noShade SIZE=1>
d31 1
a31 1
All project mailing lists are created with <A HREF="http://anzu.tigris.org/" target="_new">anzu</A>, an open source mail alias and list management extension of qmail simple mail transfer protocol (smtp). Anzu supports multiple domains, enabling each project to define and manage its own unique set of mailing lists for the project domain.
d56 1
a56 1
<HR noShade SIZE=1>
d66 2
a67 2
<HR noShade SIZE=1>
<span class="InputHeader"><A NAME="mailadmin">Mailing list administration and policies</A></span>
d81 1
a81 1
	<DT><b>Subscription moderation</b>
d84 1
a84 1
	<DT><b>Posting policy</b>
d86 5
a90 5
		<ul>
		<li>"<B>Discuss</B>" allows subscribers to post, and moderates posts (requires approval) from non-subscribers.
		<li>"<B>Moderated</B>" moderates <I>all</I> posts.
		<li>"<B>Unmoderated</B>" allows anyone to post messages without moderation.
		</ul>
d94 2
a95 2
<HR noShade SIZE=1>
<span class="InputHeader"><A NAME="editsubscribers">Editing subscribers and moderators</A></SPAN>
d128 2
a129 2
<HR noShade SIZE=1>
<a href="Help.html">Back to main Help index</a></p></span>
@

