blob: fbd9bda535bf7e4c97a38cf3e7f34c773aa9d2cd [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/2000/REC-xhtml1-20000126/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<style type="text/css">
/* <![CDATA[ */ @import "/branding/css/tigris.css"; /* ]]> */
</style>
<script src="/branding/scripts/sc.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="/branding/css/print.css" media="print" />
<title>Editing and maintaining the Project Home page</title>
</head>
<body class="docs" onload="self.focus()">
<div class="docs" id="projectowneredit">
<h2>Editing and maintaining the Project Home page</h2>
<div id="toc">
<ul>
<li><strong><a href="/nonav/servlets/HelpTOC">Help index</a></strong></li>
</ul>
<ul>
<li> <a href="/nonav/docs/ProjectOwnerAdmin.html">Project owner administration</a>
<ul>
<li> Editing and maintaining the Project Home page
<ul>
<li><a href="#updatehome">Maintaining project information</a></li>
<li><a href="#useindex">About the 'Use Project Home Page' option</a></li>
<li><a href="#ownersmessage">Updating the owner's message</a></li>
<li><a href="#other">About other operations</a></li>
<li><a href="#aboutlocking">About project locking</a></li>
</ul>
</li>
<li><a href="/nonav/docs/ProjectOwnerNews.html">Managing project site
news</a></li>
<li><a href="/nonav/docs/ProjectOwnerMembers.html">Adding project members
and approving roles</a></li>
<li><a href="/nonav/docs/ProjectOwnerMailingLists.html">Managing project
mailing lists</a></li>
<li><a href="/nonav/docs/ProjectOwnerDocuments.html">Managing project
documentation</a></li>
<li><a href="/nonav/docs/ProjectOwnerSource.html">Managing project source
code</a></li>
<li><a href="/nonav/docs/ProjectOwnerIssues.html">Tracking and managing
project issues</a></li>
<li><a href="/nonav/docs/ProjectOwnerCustomStyle.html">Managing custom
HTML styling</a></li>
</ul>
</li>
</ul>
</div>
<h3><a id="updatehome" name="updatehome">Maintaining project information</a></h3>
<p>The <strong>Project Home</strong> page is the entry point for all project
users, members as well as potential contributors. The primary role of the
<strong>Project Home</strong> page is to highlight the project's mission,
primary goals, current status, and ongoing needs.</p>
<p><strong>NOTE</strong>: For a good example of summarizing project goals and
status, see the open source <a href="http://subversion.tigris.org/">Subversion
project home page</a>.</p>
<p>Project information can be modified through the <strong>Edit Project</strong> page.
By clicking on the <strong>Edit this Project</strong> link on the <strong>Project
Home </strong>you can modify the information in each of these fields:</p>
<ul>
<li>
<strong>Parent project</strong>: Use this field
to assign a new parent project for your project.
</li>
<li><strong>Summary</strong>: This text appears in project listings viewed by registered
users. </li>
<li><strong>Description:</strong> Because the description field accommodates html formatting
and graphics, you can use this to customize and add information to your project
home page.</li>
<li><strong>Public project</strong>: Make your project visible or invisible to other users
in this domain.</li>
<li><strong>Use project index: </strong>Use to assign an alternative home page for your
project. See the <a href="#useindex">About the 'Use Project Home Page' option
section</a> for further information on this option.</li>
<li><strong>Owner message</strong>: Communicate with your project members and
potential members using this field. See the <a href="#ownersmessage">Updating
the owner's message section</a> for tips on using this section.</li>
<li><strong>Addtional operations</strong>: These options allow you to manage additional
project resources. See the <a href="#other">About other operations section</a>
for an explanaition of each operation.</li>
</ul>
<h3><a id="useindex" name="useindex">About the 'Use Project Home Page' option</a></h3>
<p>Your <strong>Project Home</strong> page by default displays the content that you entered
in the Description field in the <strong>Edit Project</strong> page.</p>
<p>Because some projects require more complex home pages, however, you have
the option to store and display special home page content from a different
file. The "Use Index" flag in the <strong>Edit Project</strong> page indicates that
your project home page should display the contents of the "index.html" file
instead of displaying description field information from the database. This
file is located in:</p>
<p>http://yourprojectname.this domain/www/index.html</p>
<p>This file is part of the project's source code repository under CVS version
control. If you check the "Use Index" flag, this means you must update your
home page content by editing the index.html file, saving it, and then committing
it into CVS to display the newest file revision in your project's home page.
When you use the index.html file, you can include HTML formatting, graphics,
and other more complex elements for your project's home page.</p>
<h3><a id="ownersmessage" name="ownersmessage">Updating the owner's message</a></h3>
<p>Initially you use the field to identify yourself as the project owner and
convey project goals. As the project progresses, use the Owner's Message to
highlight project milestones, list changing requirements, and identify particular
resource needs. For example, you may advertise the types of development expertise
currently being sought:</p>
<blockquote>
<p>"Desperately seeking experienced Java servlet developers with a passion
for creating apps that will change the world."</p>
</blockquote>
<p>Or, you can give updates about the current status of development and what's
coming up next.</p>
<p>However you use this field, your Owner's Message should be updated frequently:
usually once a week, but no less than monthly. Fresh messages convey a sense
of excitement and momentum; critical perceptions to the growth of development
projects.</p>
<h3><a name="other" id="other"></a>About other operations</h3>
<p><strong>Tool configuration</strong>: This link allows you to view and, if you have
the appropriate permission, to edit configuration options that affect your
project. Use this area to determine how project tools are configured.</p>
<p><strong>Edit project roles</strong>: Allows you to view and manage roles
specific to this project. More information on project roles is available in
the <a href="/nonav/docs/ProjectOwnerMembers.html#addroles">Manage project
roles</a> document.</p>
<p><strong>Edit project resource patterns</strong>: Like the project roles,
this allows you to view and manage resources attached to roles in this project.
For more information, review the <a href="/nonav/docs/ProjectOwnerMembers.html#addroles">Manage
project roles</a> document.</p>
<p><strong>Lock and Delete project</strong>: Allows you to remove the project from view
on the domain. For more information on locking projects please see <a href="#aboutlocking">About
project locking</a>. </p>
<h3><a id="aboutlocking" name="aboutlocking">About project locking</a></h3>
<p>If you have received email notification that your project is locked, you
should contact a site administrator immediately for further information. Project
locking means that site administrators have temporarily disabled your project.
This may be due to site policy matters, technical issues, or other reasons.</p>
<p>When you load your <strong>Project Home</strong> or <strong>Project Edit</strong> page, you encounter
the "Locked" flag in red at the top. All site-related project activity is
suspended in locked projects. Your project pages can still be accessed and
all existing project data is intact, however <strong><i>you and your project members
temporarily have read-only access</i></strong> to the source code repository, email
archives, issue database, project files, and documents. No one -- including
you -- can commit source code, enter issues, upload or download files and
documents, change web content, or subscribe to or modify mailing lists. If
your locked project is a public project, other site users can still view your
project's home page but the project is flagged as "locked."</p>
<p>A site administrator must unlock your project to reactivate it. You will
receive email notification when this action is taken also.</p>
<div class="courtesylinks">
<p><a href="#toc">Top</a> | <a href="/nonav/servlets/HelpTOC">Help index</a></p>
</div>
</div>
</body>
</html>