head	1.11;
access;
symbols
	TIGRIS_1_1_0RC2:1.4.2.1.4.1
	TIGRIS_1_1_0RC1:1.4.2.1.4.1
	TIGRIS_1_1:1.4.2.1.4.1.0.2
	TIGRIS_1_0_8:1.4.2.1.4.1
	TIGRIS_1_0_8RC3:1.4.2.1.4.1
	TIGRIS_1_0_8RC2:1.4.2.1.4.1
	TIGRIS_1_0_8RC1:1.4.2.1.4.1
	TIGRIS_1_0_7:1.4.2.1.4.1
	TIGRIS_1_0_7RC3:1.4.2.1.4.1
	TIGRIS_1_0_7RC2:1.4.2.1.4.1
	TIGRIS_1_0_7RC1:1.4.2.1.4.1
	TIGRIS_1_0_6:1.4.2.1.4.1
	TIGRIS_1_0_6RC5:1.4.2.1.4.1
	TIGRIS_1_0_6RC4:1.4.2.1.4.1
	TIGRIS_1_0_6RC3:1.4.2.1
	TIGRIS_1_0_6RC2:1.4.2.1
	TIGRIS_1_0_6RC1:1.4.2.1
	TIGRIS_1_0_5:1.4.2.1
	TIGRIS_1_0_5RC6:1.4.2.1
	TIGRIS_1_0_5RC5:1.4.2.1
	TIGRIS_1_0_5RC4:1.4.2.1
	TIGRIS_1_0_5RC3:1.4.2.1
	TIGRIS_1_0_5RC2:1.4.2.1
	TIGRIS_1_0_5RC1:1.4.2.1
	TIGRIS_1_0_4:1.4.2.1
	TIGRIS_1_0_3:1.4.2.1
	TIGRIS_1_0_2:1.4.2.1
	TIGRIS_1_0_1:1.4.2.1
	TIGRIS_1_0:1.4.2.1.0.4
	TIGRIS_1_0_0:1.4.2.1
	TIGRIS_1_0_0_RC1:1.4.0.2;
locks; strict;
comment	@# @;


1.11
date	2001.07.26.23.34.40;	author csjank;	state Exp;
branches;
next	1.10;

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

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

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

1.7
date	2001.04.17.23.25.58;	author tberry;	state Exp;
branches;
next	1.6;

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

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

1.4
date	2001.03.23.02.10.24;	author lori;	state Exp;
branches
	1.4.2.1;
next	1.3;

1.3
date	2001.03.15.03.29.21;	author lori;	state Exp;
branches;
next	1.2;

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

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

1.4.2.1
date	2001.03.31.01.49.25;	author leonardr;	state Exp;
branches
	1.4.2.1.4.1;
next	;

1.4.2.1.4.1
date	2001.06.13.00.31.24;	author lori;	state Exp;
branches;
next	;


desc
@@


1.11
log
@added info on nested Project Groups per IZ3470.
@
text
@  <div class="docs" id="domadminprojectgroups">
   <h2>Creating and editing project groups and categories</h2>

   <div class="toc">
    <h3>Help for domain administration: Index</h3>

    <ul>
     <li>
      <a href="DomAdminOverview.html">Domain administration overview</a> 

      <ul>
       <li><a href="DomAdminAddUsers.html">Adding and editing user accounts</a></li>

       <li><a href="DomAdminRoles.html">Administering roles and permissions</a></li>

       <li><a href="DomAdminUserGroups.html">Creating and editing user groups</a></li>

       <li>
        <strong>You are here:</strong> Creating and editing project groups 

            <ul>
              <li><a href="#whatis"><b>What are project groups and categories?</b></a></li>
              <li><a href="#defaultgroups"><b>About default project groups</b></a></li>
              <li><a href="#createprojgroup"><b>Creating project groups</b></a></li>
              <li><a href="#nesting"><b>Nesting project groups</b></a></li>
              <li><a href="#addtoprojgroup"><b>Adding user groups to project groups</b></a></li>
              <li><a href="#editprojgroup"><b>Editing project groups</b></a></li>
              <li><a href="#manageroles"><b>Managing user group roles for project 
                groups</b></a></li>
            </ul>
       </li>

       <li><a href="DomAdminProjectApproval.html">Approving, disapproving, or deferring projects</a></li>

       <li><a href="DomAdminAuditLogs.html">Using domain administration tools</a></li>
      </ul>
     </li>
    </ul>
   </div>

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

   <h3><a id="whatis" name="whatis">What are project groups and categories?</a></h3>

   <p>A project group is set of projects grouped together for administrative purposes. As the Domain Administrator, you define the basis upon which project groups are created. You can elect to group projects by technologies, by departments, by clients--or by any other criteria your development environment may require. Regardless of how you set up your project groups, any given project on you site may belong to more than one project group.</p>

   <p>Project groups enable you to perform administrative actions to affect multiple projects and users simultaneously. User membership in project groups can happen two different ways:</p>

   <ol>
    <li>When the projects a user belongs to are added to the project group.</li>

    <li>When users are associated with <i>user groups</i> you have created and then added to the project group. You can read more about this in <a href="DomAdminUserGroups.html">Creating and editing user groups</a>.</li>
   </ol>

   <p>The "project categories" listed on your <b>Start Page</b> are special kinds of project groups. Categories enable projects on this site to be cataloged <i>publicly</i> by development type as a way of organizing project information for browsing. Because project groups are an administrative feature, they are not visible to site users, but project categories appear on every user's <b>Start Page</b> and in the <b>Hosted Projects</b> page. The <b>Project Group Add</b> screen lets you choose whether to make a new project group be an administrative group or a public category. See <a href="#editprojgroup">Editing project groups</a> for more information about this.</p>

   <p>Both project groups and categories can be managed as projects themselves as an administrative feature. Like individual hosted projects, every project group/category has its own home page, CVS repository, issue tracker, and web pages for news, file uploads/downloads, and project documentation.</p>

   <h3><a id="defaultgroups" name="defaultgroups">About default project groups</a></h3>

   <p>There are already two existing project groups for this site:</p>

   <ul>
    <li>All projects in this domain</li>

    <li>All public projects in this domain</li>
   </ul>

   <p>All projects created on this site automatically belong to one or both of these groups. If you want to special modifications changes across multiple projects, you must create your own additional project groups. These groups become subsets of one or both of these default project groups, which cannot be edited.</p>

   <p>Continue through this document to follow the examples of how to create project groups and make changes across multiple projects within that group. In the <a href="#createprojgroup">Creating project groups</a> section, the hypothetical example shows creating a project group for all the projects in your domain that are using contract content contributors. In the <a href="#manageroles">Managing user group roles for project groups</a> section, the example assigns the "content developer" role to a certain user group that belongs to the contract project group.</p>

   
  <h3><a id="createprojgroup" name="createprojgroup">Creating project groups</a></h3>

   <p>To create a project group:</p>

   <ul>
    <li>In the "Admin Options" section of your <b>Start Page</b>, click the <i>Administer Project Groups</i> link to display the <b>All Project Groups</b> page.</li>

    <li>Click the <i>Add New Group</i> link in the top right corner to display the <b>Add a Project Group</b> screen.</li>
   </ul>

   <p>Input fields:</p>

   <dl>
    <dt>Group Name</dt>

    <dd>Choose a one-word name to identify this new group. Do not use spaces in the name. Example: <i>contractprojects</i></dd>

    <dt>Summary</dt>

    <dd>Use the summary description field to include a few qualifying words about the nature of the group. Information in this field is included in the <b>Project Group Add</b> screen where all project groups are listed. Example: <i>projects using contractors</i></dd>

    <dt>Description</dt>

    <dd>This text box enables you to include further detail about the project group. Example: <i>Several projects require outsourcing to handle content development. Any projects using independent contractors must be tracked separately for cost accounting purposes.</i></dd>

    <dt>Category</dt>

    <dd>Check this box to make the newly created project group a category. A category is a unique kind of project group for organizing how project listings appear on the <b>Start Page</b> and <b>Hosted Projects</b> page. Each category has a category home page listing all projects associated with it. The default categories on this site group projects by types of applications being developed, i.e. communication, education, games, etc., but you may wish to categorize projects differently. Both categories and project groups may be edited; see the following <a href="#editprojgroup">Editing project groups</a> section for more information.</dd>

    <dt>Initial Projects</dt>

    <dd>List the projects you wish to include in this group. Identify projects by their one-word names, one entry per line. These projects become <i>elements</i> of the project group you are creating.</dd>
   </dl>

   
  <p>When you are finishing entering project group information, click the <i>Create 
    Group</i> button to submit the new group. The <b>All Project Groups</b> page 
    displays with the new group included.</p>
  <h3><a name="nesting"></a>Nesting Project Groups</h3>
  <p>Project Groups can be nested to create subgroups. Nested groups have a parent/child 
    relationship. When you create a Project Group, you can specify another Project 
    Group as its parent. You can change the parent Project Groups by editing the 
    child Project Group. The parent is shown on Project home page and other project-related 
    servlets. Any children of the project are visible on that project's home page. 
  </p>
  <p><em>Note: This same process can be used with project categories and individual 
    projects. </em></p>
  <h3><a id="editprojgroup" name="editprojgroup">Editing project groups</a></h3>

   <p>You can modify project group information through the <b>Project Group Edit</b> screen. This is also the page you must use to add users or user groups to a project group, and to assign or modify the roles of those users.</p>

   <p>To access the <b>Project Group Edit</b> screen:</p>

   <ul>
    <li>In the "Admin Options" section of your <b>Start Page</b>, click the <i>Administer Project Groups</i> link to display the <b>All Project Groups</b> page.</li>

    <li>Click on the project group name link to display the <b>Project Group Edit</b> screen.</li>
   </ul>

   <p>This screen contains three sections containing separate editing actions that affect the project group. The top and middle sections are explained here. The bottom section of the <b>Project Group Edit</b> screen is covered in <a href="#manageroles">Managing user group roles in project groups</a>.</p>

   <p>In the first section of the <b>Project Group Edit</b> page, you can modify the summary and description fields, then use the <b><i>Submit Changes</i></b> button to save your changes.</p>

   <p>The middle "Group Elements" section of the page displays those projects that are included in this project group. <i>Elements</i> refer to the individual projects that make up the project group. Here you can:</p>

   <ul>
    <li>Click the project name link to view the <b>Project Home</b> page.</li>

    <li>Remove a project by placing a checkmark in the "Remove From Group" column and clicking the <b><i>Remove Elements</i></b> button. This action disassociates the project from the project group, but does not remove or delete the project itself from the site.</li>

    <li>Use the <i>Add New Project to Group</i> link to display the <b>Add Projects</b> screen listing all hosted projects. You can select one or more projects and add them to the project group in one action.</li>
   </ul>

   <h3><a id="addtoprojgroup" name="addtoprojgroup">Adding user groups to project groups</a></h3>

   <p>To add one or more user groups to a project group:</p>

   <ul>
    <li>In the "Admin Options" section of your <b>Start Page</b>, click the <i>Administer Project Groups</i> link to display the <b>All Project Groups</b> page.</li>

    <li>Click on the project group name link to display the <b>Project Group Edit</b> screen.</li>

    <li>In the "Other Options" section at the bottom of the screen, click on the <i>Grant User Roles</i> link.</li>

    <li>This displays the <b>Add Members</b> screen listing existing user groups at the top followed by individual users.</li>

    <li>Make your user group selections by checking the appropriate box or boxes. Highlighting the role or roles you wish to grant to the user group <i>to be effective only within the project group</i>.</li>

    <li>Finish adding the user group(s) by clicking the <b><i>Grant Roles</i></b> button. The user groups you have designated become <i>members</i> of the project group.</li>
   </ul>

   <h3><a id="manageroles" name="manageroles">Managing user groups and roles for project groups</a></h3>

   <p>To view and modify user group roles for project groups:</p>

   <ul>
    <li>In your <b>Start Page</b>, click the <i>List All Project Groups</i> link to display the <b>All Project Groups</b> page.</li>

    <li>Click on the project group name link you wish to edit, which displays the <b>Project Group Edit</b> screen.</li>

    <li>
     The bottom "Other Options" section of this page features links for managing user groups' roles pertaining to the current project group. 

     <dl>
      <dt>View User Roles in this Group</dt>

        <dd> Click this link to display the <b>Project Members</b> screen listing 
          all users and user groups associated with this project group. Remember 
          that project groups function as separate projects themselves, therefore 
          adding user groups equates to make those user groups <i>members</i> 
          of the project named "project group." 
          <p>If no user groups are affiliated with the project group yet (or you wish to add additional users or user groups), you can use the <i>Add New Member</i> link in the top right corner. The <b>Project Member Add</b> page is displayed with both user groups and users listed.</p>

       <p>To add users to a project group:</p>

       <ul>
        <li>Place checkmarks next to the user groups and/or users you wish to add to the project group.</li>

        <li>Select the role(s) you to assign to the users you have flagged.</li>

        <li>Click the <b><i>Grant Roles</i></b> button to complete the member adds. Notice the checkbox labeled "Done granting roles" is checked by default. This means that once you add the designated users, you will be returned to the <b>Project Group Edit</b> screen. If you wish to add additional users or user groups with different roles, removing this checkmark will redisplay the <b>Add Members</b> page and confirm your most recent action.</li>
       </ul>

       <p>If the project group contains any users and/or user groups, the <b>Project Member List</b> page displays these along with their real names and any roles they hold in the project group. The <i>View Issues</i> link applies only when you have assigned issues to these users specifically related to the project group. This is not a link to any project-specific issues.</p>
      </dd>

      <dt>Grant User Roles in this Group</dt>

      <dd>
       Click this link also displays the <b>Add Members</b> screen. User groups are listed first, followed by individual users. Place checkmarks in the boxes next to those users and/or groups whose roles you wish to modify. 

       <p>Example: Continuing with the <i>contractprojects</i> scenario, suppose you have created a user group called <i>contractwriters</i> for users who are contractors contributing content to projects hosted on this site.</p>

       <ol>
        <li>You would select the <i>contractwriters</i> user group using the <i>Add New Member</i> link.</li>

        <li>After reloading the <b>Project Members</b> screen for the <i>contractprojects</i> project group, you would place a check in the box next to <i>contractwriters</i>.</li>

        <li>Then you would designate the role you wish to grant these users specifically for all projects in the <i>contractprojects</i> project group. In this example, you would highlight "content developer" in the roles field.</li>

        <li>Pressing the <b><i>Grant Roles</i></b> button completes the action of adding the selected user group. You are returned to the <b>Project Group Edit</b> screen if the "Done granting roles" box is left checked. If you wish to make further role modifications for other users or user groups, remove this checkmark before clicking the <b>Grant Roles</b> button.</li>
       </ol>
      </dd>

      <dt>Delete Group</dt>

      <dd>Click this link to remove the entire project group completely. This eradicates only the project group; it does not delete any user groups associated with the deleted project group.</dd>
     </dl>
    </li>
   </ul>

   <div class="courtesylinks">
    <p><a href="DomAdminOverview.html">Back to Help for domain administration</a><br />
    <a href="/servlets/HelpTOC">Back to main Help index</a></p>
   </div>
  </div>
 


@


1.10
log
@html usage revision
@
text
@d21 10
a30 13
        <ul>
         <li><a href="#whatis"><b>What are project groups and categories?</b></a></li>

         <li><a href="#defaultgroups"><b>About default project groups</b></a></li>

         <li><a href="#createprojgroup"><b>Creating project groups</b></a></li>

         <li><a href="#addtoprojgroup"><b>Adding user groups to project groups</b></a></li>

         <li><a href="#editprojgroup"><b>Editing project groups</b></a></li>

         <li><a href="#manageroles"><b>Managing user group roles for project groups</b></a></li>
        </ul>
d75 2
a76 1
   <h3><a id="createprojgroup" name="createprojgroup">Creating project groups</a></h3>
d110 14
a123 3
   <p>When you are finishing entering project group information, click the <i>Create Group</i> button to submit the new group. The <b>All Project Groups</b> page displays with the new group included.</p>

   <h3><a id="editprojgroup" name="editprojgroup">Editing project groups</a></h3>
d182 6
a187 4
      <dd>
       Click this link to display the <b>Project Members</b> screen listing all users and user groups associated with this project group. Remember that project groups function as seperate projects themselves, therefore adding user groups equates to make those user groups <i>members</i> of the project named "project group." 

       <p>If no user groups are affiliated with the project group yet (or you wish to add additional users or user groups), you can use the <i>Add New Member</i> link in the top right corner. The <b>Project Member Add</b> page is displayed with both user groups and users listed.</p>
@


1.9
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>Creating and editing project groups and categories</title>
<style type="text/css">
 dt.c2 {font-style: italic; font-weight: bold}
 div.c1 {margin-left: 2em}
</style>
 </head>

 <body>
  <div class="docs" id="docid">
<h2>Creating and editing project groups and categories</h2> 
d4 2
a5 1
  <p><b>Help for domain administration: Index</b></p>
d7 3
a9 3
  <div>
   <dl>
    <dt><a href="DomAdminOverview.html">Domain administration overview</a></dt>
d11 2
a12 1
    <dd><a href="DomAdminAddUsers.html">Adding and editing user accounts</a></dd>
d14 1
a14 1
    <dd><a href="DomAdminRoles.html">Administering roles and permissions</a></dd>
d16 1
a16 1
    <dd><a href="DomAdminUserGroups.html">Creating and editing user groups</a></dd>
d18 2
a19 2
    <dd>
     <b>You are here: Creating and editing project groups</b> 
d21 2
a22 2
     <ul>
      <li><a href="#whatis"><b>What are project groups and categories?</b></a></li>
d24 1
a24 1
      <li><a href="#defaultgroups"><b>About default project groups</b></a></li>
d26 1
a26 1
      <li><a href="#createprojgroup"><b>Creating project groups</b></a></li>
d28 1
a28 1
      <li><a href="#addtoprojgroup"><b>Adding user groups to project groups</b></a></li>
d30 1
a30 1
      <li><a href="#editprojgroup"><b>Editing project groups</b></a></li>
d32 3
a34 3
      <li><a href="#manageroles"><b>Managing user group roles for project groups</b></a></li>
     </ul>
    </dd>
d36 1
a36 1
    <dd><a href="DomAdminProjectApproval.html">Approving, disapproving, or deferring projects</a></dd>
d38 5
a42 5
    <dd><a href="DomAdminAuditLogs.html">Using domain administration tools</a></dd>

    <dt><a href="/servlets/HelpTOC">Back to main Help index</a></dt>
   </dl>
  </div>
d44 3
a46 3
  
  
  <h3><a id="whatis" name="whatis">What are project groups and categories?</a></h3> 
d48 1
a48 1
  <p>A project group is set of projects grouped together for administrative purposes. As the Domain Administrator, you define the basis upon which project groups are created. You can elect to group projects by technologies, by departments, by clients--or by any other criteria your development environment may require. Regardless of how you set up your project groups, any given project on you site may belong to more than one project group.</p>
d50 1
a50 1
  <p>Project groups enable you to perform administrative actions to affect multiple projects and users simultaneously. User membership in project groups can happen two different ways:</p>
d52 1
a52 2
  <ol>
   <li>When the projects a user belongs to are added to the project group.</li>
d54 2
a55 2
   <li>When users are associated with <i>user groups</i> you have created and then added to the project group. You can read more about this in <a href="DomAdminUserGroups.html">Creating and editing user groups</a>.</li>
  </ol>
d57 2
a58 1
  <p>The "project categories" listed on your <b>Start Page</b> are special kinds of project groups. Categories enable projects on this site to be cataloged <i>publicly</i> by development type as a way of organizing project information for browsing. Because project groups are an administrative feature, they are not visible to site users, but project categories appear on every user's <b>Start Page</b> and in the <b>Hosted Projects</b> page. The <b>Project Group Add</b> screen lets you choose whether to make a new project group be an administrative group or a public category. See <a href="#editprojgroup">Editing project groups</a> for more information about this.</p>
d60 1
a60 1
  <p>Both project groups and categories can be managed as projects themselves as an administrative feature. Like individual hosted projects, every project group/category has its own home page, CVS repository, issue tracker, and web pages for news, file uploads/downloads, and project documentation.</p>
d62 1
a62 3
  
  
  <h3><a id="defaultgroups" name="defaultgroups">About default project groups</a></h3> 
d64 1
a64 1
  <p>There are already two existing project groups for this site:</p>
d66 1
a66 2
  <ul>
   <li>All projects in this domain</li>
d68 2
a69 2
   <li>All public projects in this domain</li>
  </ul>
d71 2
a72 1
  <p>All projects created on this site automatically belong to one or both of these groups. If you want to special modifications changes across multiple projects, you must create your own additional project groups. These groups become subsets of one or both of these default project groups, which cannot be edited.</p>
d74 1
a74 1
  <p>Continue through this document to follow the examples of how to create project groups and make changes across multiple projects within that group. In the <a href="#createprojgroup">Creating project groups</a> section, the hypothetical example shows creating a project group for all the projects in your domain that are using contract content contributors. In the <a href="#manageroles">Managing user group roles for project groups</a> section, the example assigns the "content developer" role to a certain user group that belongs to the contract project group.</p>
d76 1
a76 1
  
d78 1
a78 3
  
  
  <h3><a id="createprojgroup" name="createprojgroup">Creating project groups</a></h3> 
d80 1
a80 1
  <p>To create a project group:</p>
d82 2
a83 2
  <ul>
   <li>In the "Admin Options" section of your <b>Start Page</b>, click the <i>Administer Project Groups</i> link to display the <b>All Project Groups</b> page.</li>
d85 2
a86 2
   <li>Click the <i>Add New Group</i> link in the top right corner to display the <b>Add a Project Group</b> screen.</li>
  </ul>
d88 1
a88 1
  <p>Input fields:</p>
d90 2
a91 2
  <dl>
   <dt class="c2">Group Name</dt>
d93 1
a93 1
   <dd>Choose a one-word name to identify this new group. Do not use spaces in the name. Example: <i>contractprojects</i></dd>
d95 1
a95 1
   <dt class="c2">Summary</dt>
d97 1
a97 1
   <dd>Use the summary description field to include a few qualifying words about the nature of the group. Information in this field is included in the <b>Project Group Add</b> screen where all project groups are listed. Example: <i>projects using contractors</i></dd>
d99 1
a99 1
   <dt class="c2">Description</dt>
d101 1
a101 1
   <dd>This text box enables you to include further detail about the project group. Example: <i>Several projects require outsourcing to handle content development. Any projects using independent contractors must be tracked separately for cost accounting purposes.</i></dd>
d103 1
a103 1
   <dt class="c2">Category</dt>
d105 1
a105 1
   <dd>Check this box to make the newly created project group a category. A category is a unique kind of project group for organizing how project listings appear on the <b>Start Page</b> and <b>Hosted Projects</b> page. Each category has a category home page listing all projects associated with it. The default categories on this site group projects by types of applications being developed, i.e. communication, education, games, etc., but you may wish to categorize projects differently. Both categories and project groups may be edited; see the following <a href="#editprojgroup">Editing project groups</a> section for more information.</dd>
d107 1
a107 1
   <dt class="c2">Initial Projects</dt>
d109 2
a110 8
   <dd>List the projects you wish to include in this group. Identify projects by their one-word names, one entry per line. These projects become <i>elements</i> of the project group you are creating.</dd>
  </dl>

  <p>When you are finishing entering project group information, click the <i>Create Group</i> button to submit the new group. The <b>All Project Groups</b> page displays with the new group included.</p>

  
  
  <h3><a id="editprojgroup" name="editprojgroup">Editing project groups</a></h3> 
d112 1
a112 1
  <p>You can modify project group information through the <b>Project Group Edit</b> screen. This is also the page you must use to add users or user groups to a project group, and to assign or modify the roles of those users.</p>
d114 1
a114 1
  <p>To access the <b>Project Group Edit</b> screen:</p>
d116 1
a116 2
  <ul>
   <li>In the "Admin Options" section of your <b>Start Page</b>, click the <i>Administer Project Groups</i> link to display the <b>All Project Groups</b> page.</li>
d118 1
a118 2
   <li>Click on the project group name link to display the <b>Project Group Edit</b> screen.</li>
  </ul>
d120 2
a121 1
  <p>This screen contains three sections containing separate editing actions that affect the project group. The top and middle sections are explained here. The bottom section of the <b>Project Group Edit</b> screen is covered in <a href="#manageroles">Managing user group roles in project groups</a>.</p>
d123 2
a124 1
  <p>In the first section of the <b>Project Group Edit</b> page, you can modify the summary and description fields, then use the <b><i>Submit Changes</i></b> button to save your changes.</p>
d126 1
a126 1
  <p>The middle "Group Elements" section of the page displays those projects that are included in this project group. <i>Elements</i> refer to the individual projects that make up the project group. Here you can:</p>
d128 1
a128 2
  <ul>
   <li>Click the project name link to view the <b>Project Home</b> page.</li>
d130 1
a130 1
   <li>Remove a project by placing a checkmark in the "Remove From Group" column and clicking the <b><i>Remove Elements</i></b> button. This action disassociates the project from the project group, but does not remove or delete the project itself from the site.</li>
d132 2
a133 2
   <li>Use the <i>Add New Project to Group</i> link to display the <b>Add Projects</b> screen listing all hosted projects. You can select one or more projects and add them to the project group in one action.</li>
  </ul>
d135 1
a135 3
  
  
  <h3><a id="addtoprojgroup" name="addtoprojgroup">Adding user groups to project groups</a></h3> 
d137 2
a138 1
  <p>To add one or more user groups to a project group:</p>
d140 1
a140 2
  <ul>
   <li>In the "Admin Options" section of your <b>Start Page</b>, click the <i>Administer Project Groups</i> link to display the <b>All Project Groups</b> page.</li>
d142 1
a142 1
   <li>Click on the project group name link to display the <b>Project Group Edit</b> screen.</li>
d144 2
a145 1
   <li>In the "Other Options" section at the bottom of the screen, click on the <i>Grant User Roles</i> link.</li>
d147 1
a147 1
   <li>This displays the <b>Add Members</b> screen listing existing user groups at the top followed by individual users.</li>
d149 1
a149 1
   <li>Make your user group selections by checking the appropriate box or boxes. Highlighting the role or roles you wish to grant to the user group <i>to be effective only within the project group</i>.</li>
d151 1
a151 2
   <li>Finish adding the user group(s) by clicking the <b><i>Grant Roles</i></b> button. The user groups you have designated become <i>members</i> of the project group.</li>
  </ul>
d153 1
a153 3
  
  
  <h3><a id="manageroles" name="manageroles">Managing user groups and roles for project groups</a></h3> 
d155 2
a156 1
  <p>To view and modify user group roles for project groups:</p>
d158 1
a158 2
  <ul>
   <li>In your <b>Start Page</b>, click the <i>List All Project Groups</i> link to display the <b>All Project Groups</b> page.</li>
d160 1
a160 1
   <li>Click on the project group name link you wish to edit, which displays the <b>Project Group Edit</b> screen.</li>
d162 2
a163 2
   <li>
    The bottom "Other Options" section of this page features links for managing user groups' roles pertaining to the current project group. 
d165 1
a165 2
    <dl>
     <dt class="c2">View User Roles in this Group</dt>
d167 2
a168 2
     <dd>
      Click this link to display the <b>Project Members</b> screen listing all users and user groups associated with this project group. Remember that project groups function as seperate projects themselves, therefore adding user groups equates to make those user groups <i>members</i> of the project named "project group." 
d170 2
a171 1
      <p>If no user groups are affiliated with the project group yet (or you wish to add additional users or user groups), you can use the <i>Add New Member</i> link in the top right corner. The <b>Project Member Add</b> page is displayed with both user groups and users listed.</p>
d173 2
a174 1
      <p>To add users to a project group:</p>
d176 1
a176 9
      <ul>
       <li>Place checkmarks next to the user groups and/or users you wish to add to the project group.</li>

       <li>Select the role(s) you to assign to the users you have flagged.</li>

       <li>Click the <b><i>Grant Roles</i></b> button to complete the member adds. Notice the checkbox labeled "Done granting roles" is checked by default. This means that once you add the designated users, you will be returned to the <b>Project Group Edit</b> screen. If you wish to add additional users or user groups with different roles, removing this checkmark will redisplay the <b>Add Members</b> page and confirm your most recent action.</li>
      </ul>

      <p>If the project group contains any users and/or user groups, the <b>Project Member List</b> page displays these along with their real names and any roles they hold in the project group. The <i>View Issues</i> link applies only when you have assigned issues to these users specifically related to the project group. This is not a link to any project-specific issues.</p>
d178 1
a178 2
      
     </dd>
d180 2
a181 1
     <dt class="c2">Grant User Roles in this Group</dt>
d183 1
a183 2
     <dd>
      Click this link also displays the <b>Add Members</b> screen. User groups are listed first, followed by individual users. Place checkmarks in the boxes next to those users and/or groups whose roles you wish to modify. 
d185 2
a186 1
      <p>Example: Continuing with the <i>contractprojects</i> scenario, suppose you have created a user group called <i>contractwriters</i> for users who are contractors contributing content to projects hosted on this site.</p>
d188 2
a189 1
      
d191 1
a191 3
      <ol>
       <li>
        You would select the <i>contractwriters</i> user group using the <i>Add New Member</i> link. 
d193 2
a194 2
        
       </li>
d196 1
a196 2
       <li>
        After reloading the <b>Project Members</b> screen for the <i>contractprojects</i> project group, you would place a check in the box next to <i>contractwriters</i>. 
d198 2
a199 2
        
       </li>
d201 1
a201 2
       <li>
        Then you would designate the role you wish to grant these users specifically for all projects in the <i>contractprojects</i> project group. In this example, you would highlight "content developer" in the roles field. 
d203 1
a203 2
        
       </li>
d205 3
a207 2
       <li>Pressing the <b><i>Grant Roles</i></b> button completes the action of adding the selected user group. You are returned to the <b>Project Group Edit</b> screen if the "Done granting roles" box is left checked. If you wish to make further role modifications for other users or user groups, remove this checkmark before clicking the <b>Grant Roles</b> button.</li>
      </ol>
d209 1
a209 2
      
     </dd>
d211 4
a214 1
     <dt class="c2">Delete Group</dt>
d216 6
a221 12
     <dd>Click this link to remove the entire project group completely. This eradicates only the project group; it does not delete any user groups associated with the deleted project group.</dd>
    </dl>
   </li>
  </ul>

  
  
  <div class="courtesylinks"><a href="DomAdminOverview.html">Back to Help for domain administration</a><br />
<a href="/servlets/HelpTOC">Back to main Help index</a></div> 
 </div>
</body>
</html>
@


1.8
log
@removed referenced links to project quotas and hosted db help docs in index; changed reference to title of DomAdminAuditLogs.html doc
@
text
@d1 2
d4 7
a10 1
<head>
d12 3
a14 1
<title>Creating and editing project groups and categories</title>
d16 1
a16 205
</head>
<body>
   
<span class="Header">Creating and editing project groups and categories</span>
<p>

<span class="PlainText"><b>Help for domain administration: Index</b>
<p>
<ul>
	<dl>
	<dt><a href="DomAdminOverview.html">Domain administration overview</a>
		<dd><a href="DomAdminAddUsers.html">Adding and editing user accounts</a>
		<dd><a href="DomAdminRoles.html">Administering roles and permissions</a>
		<dd><a href="DomAdminUserGroups.html">Creating and editing user groups</a>
		<dd><b>You are here: Creating and editing project groups</b>
			<ul>
			<li><a href="#whatis"><b>What are project groups and categories?</b></a>
			<li><a href="#defaultgroups"><b>About default project groups</b></a>
			<li><a href="#createprojgroup"><b>Creating project groups</b></a>
			<li><a href="#addtoprojgroup"><b>Adding user groups to project groups</b></a>
			<li><a href="#editprojgroup"><b>Editing project groups</b></a>
			<li><a href="#manageroles"><b>Managing user group roles for project groups</b></a>
			</ul>
		<dd><a href="DomAdminProjectApproval.html">Approving, disapproving, or deferring projects</a>
		<dd><a href="DomAdminAuditLogs.html">Using domain administration tools</a>
    <dt><a href="/servlets/HelpTOC">Back to main Help index</a>
	</dl>
</ul>
<p>

<hr noshade size=1>
<a name="whatis"></a><span class="InputHeader">What are project groups and categories?</span>
<p>
A project group is set of projects grouped together for administrative purposes. As the Domain Administrator, you define the basis upon which project groups are created. You can elect to group projects by technologies, by departments, by clients--or by any other criteria your development environment may require. Regardless of how you set up your project groups, any given project on you site may belong to more than one project group.
<p>
Project groups enable you to perform administrative actions to affect multiple projects and users simultaneously. User membership in project groups can happen two different ways:
<ol>
<li>When the projects a user belongs to are added to the project group.
<p>
<li>When users are associated with <i>user groups</i> you have created and then added to the project group. You can read more about this in <a href="DomAdminUserGroups.html">Creating and editing user groups</a>. 
</ol>
<p>
The "project categories" listed on your <b>Start Page</b> are special kinds of project groups. Categories enable projects on this site to be cataloged <i>publicly</i> by development type as a way of organizing project information for browsing. Because project groups are an administrative feature, they are not visible to site users, but project categories appear on every user's <b>Start Page</b> and in the <b>Hosted Projects</b> page. The <b>Project Group Add</b> screen lets you choose whether to make a new project group be an administrative group or a public category. See <a href="#editprojgroup">Editing project groups</a> for more information about this.
<p>
Both project groups and categories can be managed as projects themselves as an administrative feature. Like individual hosted projects, every project group/category has its own home page, CVS repository, issue tracker, and web pages for news, file uploads/downloads, and project documentation.
<p>


<hr noshade size=1>
<a name="defaultgroups"></a><span class="InputHeader">About default project groups</span>
<p>
There are already two existing project groups for this site:
<p>
<ul>
<li>All projects in this domain
<li>All public projects in this domain
</ul>
<p>
All projects created on this site automatically belong to one or both of these groups. If you want to special modifications changes across multiple projects, you must create your own additional project groups. These groups become subsets of one or both of these default project groups, which cannot be edited.
<p>
Continue through this document to follow the examples of how to create project groups and make changes across multiple projects within that group. In the <a href="#createprojgroup">Creating project groups</a> section, the hypothetical example shows creating a project group for all the projects in your domain that are using contract content contributors. In the <a href="#manageroles">Managing user group roles for project groups</a> section, the example assigns the "content developer" role to a certain user group that belongs to the contract project group.
<p>

<p>

<hr noshade size=1>
<a name="createprojgroup"></a><span class="InputHeader">Creating project groups</span>
<p>
To create a project group:
<p>
<ul>
<li>In the "Admin Options" section of your <b>Start Page</b>, click the <i>Administer Project Groups</i> link to display the <b>All Project Groups</b> page.
<p>
<li>Click the <i>Add New Group</i> link in the top right corner to display the <b>Add a Project Group</b> screen.
</ul>
<p>
Input fields:
<p>
<dl>
<dt><b><i>Group Name</i></b>
<dd>Choose a one-word name to identify this new group. Do not use spaces in the name. Example: <i>contractprojects</i>
<p>
<dt><b><i>Summary</i></b>
<dd>Use the summary description field to include a few qualifying words about the nature of the group. Information in this field is included in the <b>Project Group Add</b> screen where all project groups are listed. Example: <i>projects using contractors</i>
<p>
<dt><b><i>Description</i></b>
<dd>This text box enables you to include further detail about the project group. Example: <i>Several projects require outsourcing to handle content development. Any projects using independent contractors must be tracked separately for cost accounting purposes. </i>
<p>
<dt><b><i>Category</i></b>
<dd>Check this box to make the newly created project group a category. A category is a unique kind of project group for organizing how project listings appear on the <b>Start Page</b> and <b>Hosted Projects</b> page. Each category has a category home page listing all projects associated with it. The default categories on this site group projects by types of applications being developed, i.e. communication, education, games, etc., but you may wish to categorize projects differently. Both categories and project groups may be edited; see the following <a href="#editprojgroup">Editing project groups</a> section for more information.
<p>
<dt><b><i>Initial Projects</i></b>
<dd>List the projects you wish to include in this group. Identify projects by their one-word names, one entry per line. These projects become <i>elements</i> of the project group you are creating.
</dl>
<p>
When you are finishing entering project group information, click the <i>Create Group</i> button to submit the new group. The <b>All Project Groups</b> page displays with the new group included. 
<p>

<hr noshade size=1>
<a name="editprojgroup"></a><span class="InputHeader">Editing project groups</span>
<p>
You can modify project group information through the <b>Project Group Edit</b> screen. This is also the page you must use to add users or user groups to a project group, and to assign or modify the roles of those users.
<p>
To access the <b>Project Group Edit</b> screen:
<p>
<ul>
<li>In the "Admin Options" section of your <b>Start Page</b>, click the <i>Administer Project Groups</i> link to display the <b>All Project Groups</b> page.
<p>
<li>Click on the project group name link to display the <b>Project Group Edit</b> screen.
</ul>
<p>
This screen contains three sections containing separate editing actions that affect the project group. The top and middle sections are explained here. The bottom section of the <b>Project Group Edit</b> screen is covered in <a href="#manageroles">Managing user group roles in project groups</a>.
<p>
In the first section of the <b>Project Group Edit</b> page, you can modify the summary and description fields, then use the <b><i>Submit Changes</i></b> button to save your changes.
<p>
The middle "Group Elements" section of the page displays those projects that are included in this project group. <i>Elements</i> refer to the individual projects that make up the project group. Here you can:
<p>
<ul>
<li>Click the project name link to view the <b>Project Home</b> page.
<p>
<li>Remove a project by placing a checkmark in the "Remove From Group" column and clicking the <b><i>Remove Elements</i></b> button. This action disassociates the project from the project group, but does not remove or delete the project itself from the site.
<p>
<li>Use the <i>Add New Project to Group</i> link to display the <b>Add Projects</b> screen listing all hosted projects. You can select one or more projects and add them to the project group in one action.
</ul>
<p>

<hr noshade size=1>
<a name="addtoprojgroup"></a><span class="InputHeader">Adding user groups to project groups</span>

<p>To add one or more user groups to a project group:
<p>
<ul>
<li>In the "Admin Options" section of your <b>Start Page</b>, click the <i>Administer Project Groups</i> link to display the <b>All Project Groups</b> page.
<p>
<li>Click on the project group name link to display the <b>Project Group Edit</b> screen.
<p>
<li>In the "Other Options" section at the bottom of the screen, click on the <i>Grant User Roles</i> link.
<p>
<li>This displays the <b>Add Members</b> screen listing existing user groups at the top followed by individual users.
<p>
<li>Make your user group selections by checking the appropriate box or boxes. Highlighting the role or roles you wish to grant to the user group <i>to be effective only within the project group</i>. 
<p>
<li>Finish adding the user group(s) by clicking the <b><i>Grant Roles</i></b> button. The user groups you have designated become <i>members</i> of the project group.
</ul>
<p>



<hr noshade size=1>
<a name="manageroles"></a><span class="InputHeader">Managing user groups and roles for project groups</span>
<p>
To view and modify user group roles for project groups:
<p>
<ul>
<li>In your <b>Start Page</b>, click the <i>List All Project Groups</i> link to display the <b>All Project Groups</b> page.
<p>
<li>Click on the project group name link you wish to edit, which displays the <b>Project Group Edit</b> screen.
<p>
<li>The bottom "Other Options" section of this page features links for managing user groups' roles pertaining to the current project group.
<p>
<dl>
<dt><b><i>View User Roles in this Group</i></b>
<dd>Click this link to display the <b>Project Members</b> screen listing all users and user groups associated with this project group. Remember that project groups function as seperate projects themselves, therefore adding user groups equates to make those user groups <i>members</i> of the project named "project group."
<p>
If no user groups are affiliated with the project group yet (or you wish to add additional users or user groups), you can use the <i>Add New Member</i> link in the top right corner. The <b>Project Member Add</b> page is displayed with both user groups and users listed.
<p>
To add users to a project group:
<ul>
<li>Place checkmarks next to the user groups and/or users you wish to add to the project group.
<p>
<li>Select the role(s) you to assign to the users you have flagged.
<p>
<li>Click the <b><i>Grant Roles</i></b> button to complete the member adds. Notice the checkbox labeled "Done granting roles" is checked by default. This means that once you add the designated users, you will be returned to the <b>Project Group Edit</b> screen. If you wish to add additional users or user groups with different roles, removing this checkmark will redisplay the <b>Add Members</b> page and confirm your most recent action.
</ul>
<p>
If the project group contains any users and/or user groups, the <b>Project Member List</b> page displays these along with their real names and any roles they hold in the project group. The <i>View Issues</i> link applies only when you have assigned issues to these users specifically related to the project group. This is not a link to any project-specific issues.
<p>

<dt><b><i>Grant User Roles in this Group</i></b>
<dd>Click this link also displays the <b>Add Members</b> screen. User groups are listed first, followed by individual users. Place checkmarks in the boxes next to those users and/or groups whose roles you wish to modify.
<p>
Example: Continuing with the <i>contractprojects</i> scenario, suppose you have created a user group called <i>contractwriters</i> for users who are contractors contributing content to projects hosted on this site.
	<p>
	<ol>
	<li>You would select the <i>contractwriters</i> user group using the <i>Add New Member</i> link.
	<p>
	<li>After reloading the <b>Project Members</b> screen for the <i>contractprojects</i> project group, you would place a check in the box next to <i>contractwriters</i>.
	<p>
	<li>Then you would designate the role you wish to grant these users specifically for all projects in the <i>contractprojects</i> project group. In this example, you would highlight "content developer" in the roles field.
	<p>
	<li>Pressing the <b><i>Grant Roles</i></b> button completes the action of adding the selected user group. You are returned to the <b>Project Group Edit</b> screen if the "Done granting roles" box is left checked. If you wish to make further role modifications for other users or user groups, remove this checkmark before clicking the <b>Grant Roles</b> button.
	</ol>
<p>

<dt><b><i>Delete Group</i></b>
<dd>
Click this link to remove the entire project group completely. This eradicates only the project group; it does not delete any user groups associated with the deleted project group.
</dl>
</ul>
<p>

<hr noshade size=1>
<a href="DomAdminOverview.html">Back to Help for domain administration</a><br>
<a href="/servlets/HelpTOC">Back to main Help index</a>
</span>
d18 241
d261 2
@


1.7
log
@added info to the top toc
PR:
Obtained from:
Submitted by:
Reviewed by:
@
text
@d30 2
a31 5
		<dd><a href="DomAdminAuditLogs.html">Using administrative audit logs</a>
	 <dd> <a href="/project/www/docs/ProjectQuotas.html" >Administering project 
      quotas</a> </dd>
    <dd> <a href="/project/www/docs/DomAdminAuditLogs.html" >Using a project database</a> 
    </dd><dt><a href="/servlets/HelpTOC">Back to main Help index</a>
@


1.6
log
@additional edits to clarify distinction between 'elements' and 'members' terminology
@
text
@d31 4
a34 1
	<dt><a href="/servlets/HelpTOC">Back to main Help index</a>
@


1.5
log
@minor edits to reflect changes due to addition of ProjectAddElement
@
text
@d98 1
a98 1
<dd>List the projects you wish to include in this group. Identify projects by their one-word names, one entry per line.
d121 1
a121 1
The middle section of the page displays those projects that are included in this project group. Here you can:
d148 1
a148 1
<li>Finish adding the user group(s) by clicking the <b><i>Grant Roles</i></b> button.
d168 1
a168 1
<dd>Click this link to display the <b>Project Members</b> screen listing all users and user groups associated with this project group.
d213 1
a213 1
</html>@


1.4
log
@removed bug comments from text and updated info
@
text
@d25 1
d79 1
a79 1
<li>Click the <i>Add New Group</i> link in the top right corner to display the <b>Project Group Add</b> screen.
d126 1
a126 1
<li>Remove a project by placing a checkmark in the "Remove From Group" column and clicking the <b><i>Remove Members</i></b> button. This action disassociates the project from the project group, but does not remove or delete the project itself from the site.
d128 1
a128 1
<li>Use the <i>Add New Project to Group</i> link to display a list of hosted projects. You can select one or more projects and add them to the project group in one action.
d131 22
@


1.4.2.1
log
@Ported over Lori's new and changed help documents.
@
text
@a24 1
			<li><a href="#addtoprojgroup"><b>Adding user groups to project groups</b></a>
d78 1
a78 1
<li>Click the <i>Add New Group</i> link in the top right corner to display the <b>Add a Project Group</b> screen.
d97 1
a97 1
<dd>List the projects you wish to include in this group. Identify projects by their one-word names, one entry per line. These projects become <i>elements</i> of the project group you are creating.
d120 1
a120 1
The middle "Group Elements" section of the page displays those projects that are included in this project group. <i>Elements</i> refer to the individual projects that make up the project group. Here you can:
d125 1
a125 1
<li>Remove a project by placing a checkmark in the "Remove From Group" column and clicking the <b><i>Remove Elements</i></b> button. This action disassociates the project from the project group, but does not remove or delete the project itself from the site.
d127 1
a127 1
<li>Use the <i>Add New Project to Group</i> link to display the <b>Add Projects</b> screen listing all hosted projects. You can select one or more projects and add them to the project group in one action.
a131 22
<a name="addtoprojgroup"></a><span class="InputHeader">Adding user groups to project groups</span>

<p>To add one or more user groups to a project group:
<p>
<ul>
<li>In the "Admin Options" section of your <b>Start Page</b>, click the <i>Administer Project Groups</i> link to display the <b>All Project Groups</b> page.
<p>
<li>Click on the project group name link to display the <b>Project Group Edit</b> screen.
<p>
<li>In the "Other Options" section at the bottom of the screen, click on the <i>Grant User Roles</i> link.
<p>
<li>This displays the <b>Add Members</b> screen listing existing user groups at the top followed by individual users.
<p>
<li>Make your user group selections by checking the appropriate box or boxes. Highlighting the role or roles you wish to grant to the user group <i>to be effective only within the project group</i>. 
<p>
<li>Finish adding the user group(s) by clicking the <b><i>Grant Roles</i></b> button. The user groups you have designated become <i>members</i> of the project group.
</ul>
<p>



<hr noshade size=1>
d145 1
a145 1
<dd>Click this link to display the <b>Project Members</b> screen listing all users and user groups associated with this project group. Remember that project groups function as seperate projects themselves, therefore adding user groups equates to make those user groups <i>members</i> of the project named "project group."
d190 1
a190 1
</html>
@


1.4.2.1.4.1
log
@updating branch with latest help files
@
text
@d30 2
a31 2
		<dd><a href="DomAdminAuditLogs.html">Using domain administration tools</a>
    <dt><a href="/servlets/HelpTOC">Back to main Help index</a>
@


1.3
log
@clarified distinction between project groups and categories
@
text
@d1 2
a2 2
<HTML>
<HEAD>
d4 1
a4 1
<TITLE>Creating and editing project groups and categories</TITLE>
d6 2
a7 2
</HEAD>
<BODY>
d9 2
a10 2
<SPAN CLASS="Header">Creating and editing project groups and categories</SPAN>
<P>
d12 26
a37 26
<SPAN CLASS="PlainText"><B>Help for domain administration: Index</B>
<P>
<UL>
	<DL>
	<DT><A HREF="DomAdminOverview.html">Domain administration overview</A>
		<DD><A HREF="DomAdminAddUsers.html">Adding and editing user accounts</A>
		<DD><A HREF="DomAdminRoles.html">Administering roles and permissions</A>
		<DD><A HREF="DomAdminUserGroups.html">Creating and editing user groups</A>
		<DD><B>You are here: Creating and editing project groups</B>
			<UL>
			<LI><A HREF="#whatis"><B>What are project groups and categories?</B></A>
			<LI><A HREF="#defaultgroups"><B>About default project groups</B></A>
			<LI><A HREF="#createprojgroup"><B>Creating project groups</B></A>
			<LI><A HREF="#editprojgroup"><B>Editing project groups</B></A>
			<LI><A HREF="#manageroles"><B>Managing user group roles for project groups</B></A>
			</UL>
		<DD><A HREF="DomAdminProjectApproval.html">Approving, disapproving, or deferring projects</A>
		<DD><A HREF="DomAdminAuditLogs.html">Using administrative audit logs</A>
	<DT><A HREF="/servlets/HelpTOC">Back to main Help index</A>
	</DL>
</UL>
<P>

<HR NOSHADE SIZE=1>
<A NAME="whatis"></A><SPAN CLASS="InputHeader">What are project groups and categories?</SPAN>
<P>
d39 10
a48 3
<P>
The "project categories" listed on your <B>Start Page</B> are special kinds of project groups. Categories enable projects on this site to be cataloged <i>publicly</i> by development type as a way of organizing project information for browsing. Because project groups are an administrative feature, they are not visible to site users, but project categories appear on every user's <b>Start Page</b> and in the <b>Hosted Projects</b> page. The <B>Project Group Add</B> screen lets you choose whether to make a new project group be an administrative group or a public category. See <A HREF="#editprojgroup">Editing project groups</A> for more information about this.
<P>
d50 1
a50 1
<P>
d53 3
a55 3
<HR NOSHADE SIZE=1>
<A NAME="defaultgroups"></A><SPAN CLASS="InputHeader">About default project groups</SPAN>
<P>
d57 6
a62 6
<P>
<UL>
<LI>All projects in this domain
<LI>All public projects in this domain
</UL>
<P>
d64 9
a72 9
<P>
Continue through this document to follow the examples of how to create project groups and make changes across multiple projects within that group. In the <A HREF="#createprojgroup">Creating project groups</A> section, the hypothetical example shows creating a project group for all the projects in your domain that are using contract content contributors. In the <A HREF="#manageroles">Managing user group roles for project groups</A> section, the example assigns the "content developer" role to a certain user group that belongs to the contract project group.
<P>

<P>

<HR NOSHADE SIZE=1>
<A NAME="createprojgroup"></A><SPAN CLASS="InputHeader">Creating project groups</SPAN>
<P>
d74 7
a80 7
<P>
<UL>
<LI>In the "Admin Options" section of your <B>Start Page</B>, click the <I>Administer Project Groups</I> link to display the <B>All Project Groups</B> page.
<P>
<LI>Click the <I>Add New Group</I> link in the top right corner to display the <B>Project Group Add</B> screen.
</UL>
<P>
d82 38
a119 38
<P>
<DL>
<DT><B><I>Group Name</I></B>
<DD>Choose a one-word name to identify this new group. Do not use spaces in the name. Example: <I>contractprojects</I>
<P>
<DT><B><I>Summary</I></B>
<DD>Use the summary description field to include a few qualifying words about the nature of the group. Information in this field is included in the <B>Project Group Add</B> screen where all project groups are listed. Example: <I>projects using contractors</I>
<P>
<DT><B><I>Description</I></B>
<DD>This text box enables you to include further detail about the project group. Example: <I>Several projects require outsourcing to handle content development. Any projects using independent contractors must be tracked separately for cost accounting purposes. </I>
<P>
<DT><B><I>Category</I></B>
<DD>Check this box to make the newly created project group a category. A category is a unique kind of project group for organizing how project listings appear on the <B>Start Page</B> and <B>Hosted Projects</B> page. Each category has a category home page listing all projects associated with it. The default categories on this site group projects by types of applications being developed, i.e. communication, education, games, etc., but you may wish to categorize projects differently. Both categories and project groups may be edited; see the following <A HREF="#editprojgroup">Editing project groups</A> section for more information.
<P>
<DT><B><I>Initial Projects</I></B>
<DD>List the projects you wish to include in this group. Identify projects by their one-word names, one entry per line.
</DL>
<P>
When you are finishing entering project group information, click the <I>Create Group</I> button to submit the new group. The <B>All Project Groups</B> page displays with the new group included. 
<P>

<HR NOSHADE SIZE=1>
<A NAME="editprojgroup"></A><SPAN CLASS="InputHeader">Editing project groups</SPAN>
<P>
You can modify project group information through the <B>Project Group Edit</B> screen. This is also the page you must use to associate user groups to a project group, and to assign or modify the user group's roles.
<P>
To access the <B>Project Group Edit</B> screen:
<P>
<UL>
<LI>In the "Admin Options" section of your <B>Start Page</B>, click the <I>Administer Project Groups</I> link to display the <B>All Project Groups</B> page.
<P>
<LI>Click on the project group name link to display the <B>Project Group Edit</B> screen.
</UL>
<P>
This screen contains three sections containing separate editing actions that affect the project group. The top and middle sections are explained here. The bottom section of the <B>Project Group Edit</B> screen is covered in <A HREF="#manageroles">Managing user group roles in project groups</A>.
<P>
In the first section of the <B>Project Group Edit</B> page, you can modify the summary and description fields, then use the <B><I>Submit Changes</I></B> button to save your changes.
<P>
d121 13
a133 13
<P>
<UL>
<LI>Click the project name link to view the <B>Project Home</B> page.
<P>
<LI>Remove a project by placing a checkmark in the "Remove From Group" column and clicking the <B><I>Remove Members</I></B> button. This action disassociates the project from the project group, but does not remove or delete the project itself from the site.
<P>
<LI>Use the <I>Add New Project to Group</I> link to display a list of hosted projects. You can select one or more projects and add them to the project group in one action.
</UL>
<P>

<HR NOSHADE SIZE=1>
<A NAME="manageroles"></A><SPAN CLASS="InputHeader">Managing user group roles for project groups</SPAN>
<P>
d135 44
a178 38
<P>
<UL>
<LI>In your <B>Start Page</B>, click the <I>List All Project Groups</I> link to display the <B>All Project Groups</B> page.
<P>
<LI>Click on the project group name link you wish to edit, which displays the <B>Project Group Edit</B> screen.
<P>
<LI>The bottom "Other Options" section of this page features links for managing user groups' roles pertaining to the current project group.
<P>
<DL>
<DT><B><I>View User Roles in this Group</I></B>
<DD>Click this link to display the <B>Project Members</B> screen listing all user groups associated with this project group.
<P>
If no user groups are affiliated with the project group yet or you wish to add other user groups, use the <I>Add New Member</I> link in the top right corner. The <B>Project Member Add</B> page is displayed with user groups listed first.
<P>
<B>[NOTE: BUG REPORTED ON THIS PROCESS (ISSUE #2489). Should return dom admin to the ProjectGroupEdit screen but does not, so navigation is confusing. Need to add more info here about how user group adds are confirmed.]</B>

<P>

<DT><B><I>Grant User Roles in this Group</I></B>
<DD>Click this link also displays the <B>Add Members</B> screen. User groups are listed first, followed by individual users. Place checkmarks in the boxes next to those user groups you wish to add to the current project group.
<P>
Example: Continuing with the <I>contractprojects</I> scenario, suppose you have created a user group called <I>contractwriters</I> for users who are contractors contributing content to projects hosted on this site.
	<P>
	<OL>
	<LI>You would select the <I>contractwriters</I> user group using the <I>Add New Member</I> link.
	<P>
	<LI>After reloading the <B>Project Members</B> screen for the <I>contractprojects</I> project group, you would place a check in the box next to <I>contractwriters</I>.
	<P>
	<LI>Then you would designate the role you wish to grant these users specifically for all projects in the <I>contractprojects</I> project group. In this example, you would highlight "content developer" in the roles field.
	<P>
	<LI>Pressing the <B><I>Grant Roles</I></B> button completes the action of adding the selected user group.
	</OL>
<P>

<B>[NOTE: THE CONFIRMATION FOR THIS ACTION IS NOT CORRECT. Should return to ProjectMembers screen with role changes displayed. Instead, it displays the ProjectMemberAdd screen again with no confirmation whatsoever. Additional info about added/modified user group roles needs to be added here when the UI is fixed.]</B>
<P>
<DT><B><I>Delete Group</I></B>
<DD>
d180 8
a187 8
</DL>
</UL>
<P>

<HR NOSHADE SIZE=1>
<A HREF="DomAdminOverview.html">Back to help for domain administration</A><BR>
<A HREF="/servlets/HelpTOC">Back to main Help index</A>
</SPAN>
d189 2
a190 2
</BODY>
</HTML>@


1.2
log
@changed page index; added info about editing categories
@
text
@d38 1
a38 1
A project group is set of projects. As the Domain Administrator, you determine the basis upon which project groups are created. You can elect to group projects by technologies, by departments, by clients--or by any other criteria your development environment may require. Regardless of how you set up your project groups, any given project on you site may belong to more than one project group.
d40 1
a40 1
The "project categories" listed on your <B>Start Page</B> are special kinds of project groups. Categories enable projects on this site to be cataloged by development type as a way of organizing project information for browsing. The <B>Project Group Add</B> screen lets you choose to create a project group as a new category. See <A HREF="#editprojgroup">Editing project groups</A> for more information about this.
d42 1
a42 1
Both project groups and categories can be managed as projects themselves as an administrative feature. Like individual hosted projects, every project group/category has its own home page, cvs repository, issue tracker, and web pages for news, file uploads/downloads, and project documentation.
@


1.1
log
@project group help documentation for domain admins
@
text
@d1 7
a7 2
<TABLE BORDER="0" CELLSPACING="1" CELLPADDING="3" BORDER="0" WIDTH="100%">
  <TR>
d9 1
a9 1
<SPAN CLASS="Header">Creating and editing project groups</SPAN>
d18 1
d22 1
a22 1
			<LI><A HREF="#whatis"><B>What is a project group?</B></A>
a28 2
		<DD><A HREF="DomAdminSource.html">Administering domain source code repositories</A> 
		<DD><A HREF="DomAdminUserSessions.html">Monitoring user sessions</A> 
d36 1
a36 1
<A NAME="whatis"></A><SPAN CLASS="InputHeader">What is a project group?</SPAN>
d38 1
a38 1
A project group is set of designated projects. As the Domain Administrator, you determine the basis upon which project groups are created. You can elect to group projects by technologies, by departments, by clients--or by any other criteria your development environment may require. Regardless of how you set up your project groups, any given project on you site may belong to more than one project group.
d42 3
d52 2
a53 2
<LI>All site projects
<LI>All public projects
d56 1
a56 1
These groups enable you to make administrative modifications that are enforced either in all projects hosted here, or just in all public projects. For example, if you want to .... <B>[ADD EXAMPLE HERE]</B>
d58 3
a60 1
If you want to make changes to smaller sets of projects, you can create your own additional project groups. These groups become subsets of one or both of the default project groups.
d69 1
a69 1
<LI>In the "Admin Options" section of your <B>Start Page</B>, click the <I>List All Project Groups</I> link to display the <B>All Project Groups</B> page.
d78 1
a78 1
<DD>Choose a one-word name to identify this new group. Do not use spaces in the name. 
d81 1
a81 1
<DD>Use the summary description field to include a few qualifying words about the nature of the group. Information in this field is included in the <B>Project Group Add</B> screen where all project groups are listed.
d84 1
a84 1
<DD>This text box enables you to include further detail about the project group.
d87 1
a87 1
<DD>Check this box to make the newly created project group also a category. This adds the new category to the <B>Start Page</B> and <B>Hosted Projects</B> page, while also automatically creating a category home page. Categories can be edited like project groups; see the following <A HREF="#editprojgroup">Editing project groups</A> section for more information.
d104 1
a104 1
<LI>In the "Admin Options" section of your <B>Start Page</B>, click the <I>List All Project Groups</I> link to display the <B>All Project Groups</B> page.
a141 4
Select a user group by placing a checkmark in the adjacent box. Then you must select the role(s) you wish to grant this user group.
<P>
Pressing the <B><I>Grant Roles</I></B> button completes the action of adding the selected user group.
<P>
d143 1
d145 1
d149 11
a159 3
At the bottom of this page, you can select one or more roles you wish to grant to the designated user groups.
<P>
Finally, click the <B><I>Grant Roles</I></B> button to complete the action. You are returned to  ... 
d161 1
d175 3
a177 2
</TR>
</TABLE>
@

