Creating a New Project

A project is a container for all of the issues, source code, discussions, announcements, and other elements that people work on together to produce a result. In the CollabNet environment, you can define a project, add members to it, configure the way in which project members will track project issues, and allow everyone to share information in a permissions-based, secure manner.

The following paragraphs describe the basics of creating a new project and configuring the project home page.

About project configuration

When you create a new project, you are prompted to provide information such as a name, a description, and so on. The following paragraphs describe the information that you must provide when you create a project.

Project Name - The project name is used throughout the project to organize and distinguish project content. For example, all project discussions have the project name as part of their address. This allows users to quickly tell which project a message comes from. Choose a project name that will uniquely identify the project to current members and to potential participants. Rules for project names:

Once a project has been created, you cannot change the name.

Parent project - If you have permission to create subprojects, you can make the project a child of another project. Creating a child relationship will help you and potential project members to identify projects of interest and to follow the requirements of larger projects.

Summary - Enter a description of your project, sixty four (64) characters maximum, in plain text. HTML and formatted text are not supported. The summary is displayed next to the project name in the list of available projects. You can edit this field at any time.

Public project - Public projects are visible to all users of the domain. While this allows anyone to view your project, you may find that you would prefer to run your project in a private mode. Users can request roles in any public project, but must be invited by the Project owner, to join any private project.

Note: Project templates that use CVS as their versioning component cannot use non-english filenames. For example, if you have a Japanese, Korean or Chinese filename for one of your files in your project template, when CVS is the versioning option in the template.properties file, then the template cannot be used.

Project categories - This field will appear only if categories have been created on the site. Categories are used to organize projects by type. For instance, a game category allows all projects relating to gaming to be grouped together. Categories make it easy for potential project members to identify projects that match their interests. You can assign your project to as many categories as you think are useful.

Project language - This feature will only appear if localization is active for this domain. You can select a default language for email generated by events in your project. For more information see About the default project language.

Tracking component - The tracking component refers to the tool you use to monitor basic project elements such as Defects, Tasks, Requirements documents, and so on. You can select Project Tracker or Issue Tracker:

Artifact code - Only used with Project Tracker, the Artifact code is a unique identifier for all artifacts entered in this project. The Artifact code can be one to four alphanumeric characters in length and cannot contain any numbers, spaces, underscores or other punctuation. Sub-projects can have the same Artifact code as their parent project and top level projects can use the default Artifact code.

Project owner - While this field defaults to your username, you can add or edit project owners based on the needs of the project. The project owner maintains and administers the project, invites and approves new project members and member roles, assigns discussions monitors, approves announcements and project documentation and files, and monitors disk space usage.

Configuring the project

You perform basic configuration when you start a new project.

To configure a new project:

  1. Click the Projects tab.
  2. Click the Start New Project link.
  3. Complete the prompts, as described in the previous paragraphs.
  4. When you are done, click Create project.
    A confirmation page is displayed.
  5. Click the link to the project home page on the confirmation page.

Note that it may take a few minutes for your project to become available for editing. Once it is available, you can customize it. The domain administrator has set defaults for all new projects which you can review and customize through the Project tool configuration page.

Adding content to your project home page

You may want to add content to the home page for your project, such as pictures or instructions for project members. You may also want to build out the project home page. For example, you may want to add links to project documents, plans, spreadsheets, and charts. As with any set of html files, a project home page can be extended to be an entire web site.

You can add content to the project home page either by entering plain text or html in the Description field on the Edit Project page, or by modifying an index.html file that resides in the www directory for the project. The more content you want to add to the project, the more useful the index.html file will be.

If an administrator or another user has created a template for your projects, you can make use of the template files to add structure and content to your project home page and the pages that link to the home page.

Note: The option to use a template must be enabled by a domain administrator, and more than one template must exist for this option to appear. Note that you can only select a template during project creation.

Once the project is available for editing, click the link Edit Project to start configuring your home page.

Description - Information that you enter in this field is displayed on the project home page. Use the Description field to communicate to project members and potential members. For example, you can enter your project's mission, background, methodology and tasks. You can include HTML, as long as it conforms to HTML coding conventions for areas of the application that use an XSS filter. Simple, unformatted text will have a faster loading time. You can edit the description by clicking the Edit project link from the project home page.

Note: If you enter a description in the project index.HTML, that content will take precedence over the description. However, if the index.html file is empty, the text in the Description field will be used instead of the html file.

Use project index.html - If the Description field does not provide enough flexibility for adding content to your project's home page, you can set the default home page for a project to an index.html file that resides in the www directory for the project. You can customize the project home page by editing the www/index.html file. You can add any type of content that is accessible in HTML format, and "build out" the home page by linking to other files in the www folder. Note that the more complex your home page is the longer the load time end users will experience. This setting can be changed at any time. If you enter a description and check the Use Project Index.HTML checkbox, the index.html file takes precedence. However, if the index.html file is empty, the text in the Description field will be used instead of the HTML file.

For more on adding content to your project home page refer to the Project Pages Editor documentation.