This revision made November 07, 2012 19:13, by nvause
« earlier revision revert to this « later revision

» Project Kenai Documentation and Training    » How Do I ...

Managing a Project

If you created a project or you're an administrator for the project, you can change the project's settings on the Manage page.


Opening the Manage Page

To manage a project:

  1. Open the project page (for example, click My Page and click the project's link) and choose Manage This Project.



  2. The Manage page opens.

On the Manage page, you see the following tabs:

Settings Tab


To open the page this tab is on, see Opening the Manage Page.

This tab enables you to set basic settings for the project, available when the project was first created. You can change any of the settings on this tab. For example, if you just chose defaults or did the bare minimum to get the project created, you can fix that on this tab. You can also use this tab to delete the project. The Delete button is at the bottom of the page.

Note: The project name, which is part of the project URL, is not on the Settings tab because it cannot be changed once the project has been created.

For more information on creating projects, see Creating a Project.

Project Settings

  • Project Owner—Initially, the username of the Project Kenai member who created the project. Project ownership can be assigned by the owner to any administrator of the project.
  • Project Title—A descriptive title that will be shown in lists of projects. Maximum of 40 characters. (for example, Project Kenai)
  • Description—Enter a detailed description of your project, including things like development status. Maximum of 500 characters.
  • Tags—Tags are search terms that users can use to find your project.
  • License—The source code license that you require members of your project to agree to when they participate in, and especially when they contribute to, the project. Choose one or more from the list.
  • Parent Project—If your project is part of another project, you can specify that project here. For example, if your project is a sub-project of a larger project, you would select that larger project as the Parent. Links will be automatically generated between child and parent projects.

Deleting a Project

Only the owner of a project can delete it. To see if you're the owner, check the Project Owner field on the Settings tab of the project's Manage page (see Settings Tab above).

Before you delete a project, be sure to notify all your project members and give them time to move data off the project.

Note: You must remove all members from the project before the Delete button will show.

To delete the project, click the Delete button at the bottom of the Settings tab.

Image Tab


To open the page this tab is on, see Opening the Manage Page.

On this tab you can upload an image for your project. Make sure you have rights to use the image before uploading it.

Since the image will be cropped to a square image and resized to 100 pixels by 100 pixels, you might want to work with the image in a graphics editor to get it close to that size before uploading it. In particular, cropping the image to make it square will make the biggest difference. Also, you might need to resave it as a smaller image if it's bigger than 500 KB.

For example, the following image isn't square. Here's how it looks before uploading:

And here's how it looks after being uploaded to the site and automatically cropped and resized:

One way to make this image look better is to edit it before you upload it. If you crop it to a square image and center the part you think is important, you're more likely to see what you want on the site. For example, the original image was cropped around the frog's face and made into a square. Here's how it looked after uploading:

Links Tab


To open the page this tab is on, see Opening the Manage Page.

You can add links that are relevant to this project as a convenience for your members and others looking at the project page. Click Add Link to add a new link. The link text can be up to 25 characters, and the URI must be a fully formed Web address, such as http://meta.wikimedia.org/wiki/Help.

Members Tab


To open the page this tab is on, see Opening the Manage Page.

You can add members to your project if they have usernames on this site. To see a list of usernames, click the People link (or right-click it and open it in a new tab or window so you don't lose this settings tab). People can also request to become members of the project by signing up on the project page and requesting a role. If someone does that, you as a project administrator will receive a notification of the request.

  • To add a member: Click Add Member and enter the username. Pick an appropriate role (Observer, Software Developer, Content Developer, or Administrator) and status (Active or Inactive).
  • To delete a member: Click the More droplist to the right of the member's name and choose Delete.
    Note: When you delete a member who's in an administrator role, make sure to delete their mailing list subscriptions as well. You have to do this because administrators are automatically subscribed to the project mailing lists when added to a project, but they aren't removed from mailing lists when removed from the project.
  • To change a member's role or status, or to substitute a new member: Click Edit to the right of the member's name, change the settings, and click Update.

Here's a quick guide to the default definitions for project roles:

RoleDescription of Default Permissions
Administrator King of the Mountain. Owns the project and can perform all project administration tasks.
Software Developer  Top level developer. Can do anything with the code and content.
Tester  Someone who's job it is to test the software. Defaults to same permissions as Software Developer.
Content Developer  Second level developer. Typically, can edit the wiki, but not commit code.
Observer Here to watch, comment, and connect.
Unregistered  Logged in as a Project Kenai user, but not watching or otherwise participating in this project.
Unauthenticated  Not logged in as a user of Project Kenai.

Note: The project administrator can set the permissions for all the roles to those that make sense for the project. Each feature described below under Features Tab has its own permissions settings. Also, a single member can have more than one role. For example, if Content Developers have permission to add, delete, and change pages on the project wiki, but someone in a Software Developer role typically does not, a member who is permitted to both check in code and write wiki pages could be given both roles.

For a table showing all the default permissions settings, see Default Project Activity Permissions.

Features Tab

On this tab, you can remove project features, add features, like a source code management system or bug tracker, or manage features, for example, by setting permissions for actions for each user role or by changing the feature's name or description.

Note: To open the page this tab is on, see Opening the Manage Page.

Here's what you can do with each feature.

Issue Tracking

This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.

Issue tracking is a feature that helps you keep track of bugs and feature requests. You can have two issue trackers for a project.

For general information on working with issue tracking, see About Issue Tracking.

There are two issue trackers that are directly supported, Bugzilla and Jira. If you prefer to use an issue tracker external to the site, you can do that by specifying External Issue Tracker when you add an issue tracker (see Adding an Issue Tracker below). The following figure shows the issue tracking section of the Manage page with an existing issue tracker:


Note: The message saying that you cannot add another issue tracker is replaced by Add when there is no issue tracker, as you can see below.

You can do the following management tasks with issue tracking.

Adding an Issue Tracker

If you see Add next to the Issue Tracking feature name, you can add an issue tracker to your project.

Note: If you add an issue tracker, your project automatically gets an Issues mailing list tied to the issue tracking system.

To add an issue tracker:

  1. Click Add next to the Issue Tracking feature name. You see the following inline dialog open:
  2. Add a Display Name for your issue tracker and pick the tracker you want to use from the Issue Tracker droplist.
  3. Optionally add a description.
  4. For the Issue Tracker droplist, if you choose Jira or Bugzilla, click the Add button, and your issue tracker will be hooked up to your project.
  5. For the Issue Tracker droplist, if you choose External Issue Tracker, a URL field opens:

  6. Enter the URL where your issue tracker is located, then click the Add button to add it. For example, as shown in the figure above, if your project is JRuby, you might enter http://jira.codehaus.org/browse/JRUBY.

Deleting an Issue Tracker

Click more to the right of the issue tracker name and click Delete.

Note: After the issue tracker is deleted, Add appears next to the Issue Tacking feature name.

Renaming the Issue Tracker

Click Edit to the right of the issue tracker name.

In the Edit dialog, you can change the Display Name that users of your project see for your issue tracker, as well as the description.

Managing Issue Tracker Roles and Tasks

From the Project Kenai point of view, the tasks users can perform in an issue tracker (like creating bugs, editing bugs, and so on) depend on their roles in the project. You can't change the issue tracker permissions for individual project roles in Project Kenai as you can with other features, but you can move your project members to new Kenai roles. To see how the roles map for each type of issue tracker, see Issue Tracking on the Default Project Activity Permissions page.

Note: In addition to changing your members' roles in your Kenai project, you can change individual users' roles in the Jira issue tracker, and you can change what groups can do in Bugzilla.

For information on the Kenai roles, see the role definitions above.

Mailing Lists

This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.

You can add new mailing lists, delete lists, and manage them here.

Note: If you add an issue tracker, your project automatically gets an Issues mailing list tied to the issue tracking system. If you add a code repository, your project gets a Commits mailing list tied to the source control system.

You can do the following management tasks with mailing lists:

  • Adding a Mailing List—Click Add next to Mailing List and then enter the URI and name of the mailing list. The description is optional, but useful for your members. The URI becomes part of the URL for the mailing list and can consist of letters, numbers, and underscores only.
  • Deleting a Mailing List—Click the more droplist to the right of the mailing list name and choose Delete.
  • Editing a Mailing List's Settings—Click Edit to the right of the mailing list name and change any of the fields described in Adding a Mailing List above.
  • Setting Role Permissions—Click the more droplist to the right of the mailing list name and choose Set Role Permissions.


    You see a table of checkboxes showing roles and actions those roles can take with this mailing list. (For information on the roles, see the role definitions above.)
    • View List—Allowed to see the list online.
    • Administer List—Allowed to add and remove subscribers, rename list, make list moderated or not, add moderators, add list owners, and so on.
    • View Archive—Allowed to see the archive of mailing list messages.
    • Close List—Allowed to shut the list down. The archive remains available, but the mailing list becomes inactive.
    • Moderate Posts—If the list is moderated, receives posts and is responsible for approving them before they go to the list. See Send Scheme below for information on making a list moderated.
    • Compose on Web—Allowed to compose messages on this site with the email editor. Users who aren't allowed to compose on the web must use their own email clients to send emails to the list.
    • Subscribe to List—Allowed to subscribe and receive messages from the list. For example, you could limit this permission to members of the project.
  • Managing a List—Click the list description link (for example, Commits Mailing List) and choose Manage List under that list item. For more information, see Managing a Single Email List.

For general information on using mailing lists, see About Mailing Lists.

Source Code Repository

This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.

You can choose a supported source code management (SCM) system, Subversion, Mercurial, or Git, and your project will be set up with a repository for that SCM. If you choose External Source Code Repository, nothing will be set up for you on this site, and you have to do it yourself as described below under Adding an External Repository.

You can have more than one repository of more than one type. This feature lets you add, delete, and manage repositories, and also lets you determine who can check files in and out and who can browse your repositories.

You can do the following management tasks with source code repositories:

Adding a Subversion, Mercurial, or Git Source Code Repository

Note: If you add a code repository, your project also gets a Commits mailing list tied to the source control system.

To add a Subversion, Mercurial, or Git repository:

  1. Click Add next to Source Code Repository and then enter the Display Name and the Name of the repository.
    The Name is used in the repository URL and has to be unique for this project's repositories. It can contain alphanumeric characters and underscores.
  2. Select which Source Control System type you want this repository to be, Subversion, Mercurial, or Git.
  3. Set the email commit message type, as described below.
  4. Click the Add button.

Adding an External Repository

To add a repository for your project that's external to this site:

  1. Click Add next to Source Code Repository and then enter the Display Name and the Name of the repository as described above.
  2. Select External Link from the Source Control System droplist.
  3. Enter the URL or command line for checking out the source code. This URL is displayed as text that a project member can cut and paste into an SCM client later.
    For example, for the GlassFish project on Java.net, you might enter
    cvs -d :pserver:{username}@cvs.dev.java.net/cvs checkout glassfish
  4. Optionally enter the URL for browsing the source code.
    For example, for java.net, this is usually something like
    https://glassfish.dev.java.net/source/browse/glassfish
  5. Click the Add button.

Setting Size of Email Commit Messages

Click Edit to the right of the repository name.

Change the Commit Message Type (shown in the figure above) to:

  • verbose—With each commit to the repository, send an email that contains a full log of all changes made.
  • compact—With each commit to the repository, send an email that contains basic commit information only.
  • none— Disable commit emails entirely.

Deleting a Source Code Repository

Click the more droplist to the right of the repository name and choose Delete.

You will be asked to confirm the deletion because deleting a repository can destroy a lot of code and code history.

Editing a Source Code Repository's Settings

Click Edit to the right of the repository name.

The fields you can edit are described above under Adding a Subversion, Mercurial, or Git Source Code Repository. You cannot change the type of repository, but you can change the feature name, display name, and commit message type.

Setting Role Permissions

Click the more droplist to the right of the repository name and choose Set Role Permissions.

You see a table of checkboxes showing roles and actions those roles can take with a repository. The tasks you can set for the various roles are simple: Perform Checkouts and Perform Checkins.

Perform Checkouts includes source code browsing, so changing permissions for this task also changes who can browse your source code.

For information on the roles, see the role definitions above.

Note: Changes to repository permission don't take effect immediately, but take about 15 minutes to propagate.

Copying an Existing Subversion Repository Into Your Project's Subversion Repository

If you have an existing external Subversion repository that you would like to begin using in your Kenai project, you can:

  • Point directly to it as an external repository, as described above at Adding an External Repository.
  • If your repository's number of revisions is less than 1,000, you can use Subversion's svnsync command to directly copy your entire existing repository into your Kenai project's svn repository, as described below. You must be a project administrator to use svnsync with your project's repository.
  • If your repository has more than 1,000 revisions, you are encouraged to follow the instructions at Migrating an Existing Subversion Repository to a Kenai Project Repository, which tell you how to set the repository up to be copied and how to contact a Project Kenai administrator to schedule the transfer.

To copy the repository with svnsync:

Note: SSH access is faster and more secure than HTTPS access. Therefore, these instructions assume that you'll use SSH.

  1. If necessary, set up a Kenai repository as described above at Source Code Repository.
  2. If necessary, set up your local system to use Subversion as described at Accessing a Subversion Repository.
  3. To set up SSH:
  4. On your local system, run the following svnsync commands and substitute your username and the URLs for your project repository and your external repository:
       > svnsync init svn+ssh://<your-username>@svn.kenai.com/<project-name>~<project-svn-repos> https://www.<some-site>.org/<your-ext-project>/svn/<your-repos>
       > svnsync sync svn+ssh://<your-username>@svn.kenai.com/<project-name>~<project-svn-repos>
  5. If the transfer is interrupted or there's an error resulting in a hanging lock, use the following command to clean things up:
       > svn propdel 'svn:sync:lock' --revprop -r 0 svn+ssh://<your-username>@svn.kenai.com/<project-name>~<project-svn-repos>
  6. Verify by checking out your project and making sure that history has been preserved. If so, you are done.
       > svn co svn+ssh://<your-username>@svn.kenai.com/<project-name>~<project-svn-repos>

Note: You don't have to set up the pre-revprop-change hook. It's already set up for your Kenai Subversion repositories. The Kenai hook script requires only that you be a project administrator.

For more information on svnsync, see http://svn.collab.net/repos/svn/trunk/notes/svnsync.txt.

For general information on working with source code management and repositories, see Source Code Management.

Wiki

This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.

A project can have one wiki that can have many pages.

You can do the following management tasks with wikis:

  • Adding a Wiki—Click Add in the Wiki heading bar and give the wiki a display name and an optional description. You can also set the name of the home page, which defaults to Home.
  • Renaming a Wiki—Click Edit to the right of the wiki name.

    You can change the name users of your project see on the project page. You can also change the description here, as well as the home page, as described below.
  • Setting the Wiki Home Page—Click Edit to the right of the wiki name and enter a wiki page name in the Wiki Default Page field. This sets the page that displays when the user clicks the wiki's link on the project's home page.
  • Setting Role Permissions—Click the more droplist to the right of the Wiki's name and choose Set Role Permissions.

    You see a table of checkboxes showing roles and actions those roles can take with the wiki. The tasks you can set for the various roles are simple: Delete Pages, View Pages, and Edit Pages. Think about who you want to give access to the wiki and set up roles accordingly. For information on the roles, see the role definitions above.
  • Making the Wiki Home Page Your Project Home Page—See WikiHomePage for more information.

For general information on working with wikis and using wiki formatting tags, see About Wikis.

Message Forums

This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.

Message Forums, or just forums, are message boards where your members can discuss the project.

You can do the following things with forums:

  • Adding a Forum—Click Add next to Message Forum and then enter the URI and display name of the forum. For example, you might want to create a forum for reporting bugs with the URI bugsforum and the display name Bugs and Feature Suggestions. The description is optional, but useful for your members.
  • Deleting a Forum—Click the more droplist to the right of the forum name and choose Delete.
  • Editing a Forum's Settings—Click Edit to the right of the forum name.

    Change any of the fields, which are described above under Adding a Forum.
  • Setting Role Permissions—Click the more droplist to the right of the forum name and choose Set Role Permissions.


    You see a table of checkboxes showing roles and the actions each role can perform. The actions Create Post, Edit Post, and Delete Post allow users to edit and delete only their own posts. The action Edit or Delete Any Post allows a user to edit and delete any post in the forum, and by default applies only to the Administrator role.

    As an example, you might want only project members to be able to add posts, edit them, and delete them, but you'd like everyone to continue to be able to read all posts. Under the Unregistered role, you uncheck Edit Post, Create Post, and Delete Post, and then you click Update. For information on the roles, see the role definitions above.

For general information on using forums, see About Forums.

Downloads

This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.

A project has one Downloads list for project files that you want your members to be able to download, such as the latest build of the project.

You can do the following management tasks with the Downloads list:

  • Renaming the Downloads list—Click Edit to the right of the download list's name.

    You can change the name users of your project see on the project page. You can also enter a description for the list.
  • Deleting the Downloads list—Click the more droplist to the right of the downloads list name and choose Delete.
  • Setting Role Permissions—Click the more droplist to the right of the download list's name and choose Set Role Permissions.

    You see a table of checkboxes showing roles and actions those roles can take with the download area. The tasks you can set for the various roles are simple: Upload Files, Download files, Edit upload, and Delete upload.

    By default, uploading files to the list, deleting a file from the list, and changing the information displayed for a file in the list can only be done by a project administrator. Additionally, by default, anyone can download a project's files. If you want to change these defaults (for example, to limit downloads to project members), you can do that here. For information on the roles, see the role definitions above.

For general information on working with the Downloads list, see About Downloads. This page also tells you how to get a summary of data about your project's downloads.

Project Chat Room

This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.

A chat room is an area where your members can discuss the project with IM (instant messaging). You can have one chat room per project and use the Project Kenai chat client to access it. You can also use your own client, like Pidgin or Adium, or you can use NetBeans 6.7 and later. See About Instant Message (IM) Chat for more information on using IM chat clients.

You can do the following things with chat rooms:

  • Adding a Chat Room—Click Add next to Project Chat Room and then enter the display name of the chat room. The description is optional.
  • Deleting a Chat Room—Click the more droplist to the right of the chat room name and choose Delete.
  • Editing a Chat Room's Settings—Click Edit to the right of the chat room name and change the chat room's display name or its description.
  • Viewing Role Permissions—Click the more droplist to the right of the chat room's name and choose Set Role Permissions.

    You see a read-only table of checkboxes showing roles and actions those roles can take with the chat room. Basically, anyone can use the chat room, but only administrators can create or delete one.

Website

This feature is on the Features tab on the Manage page, as described under Opening the Manage Page.

A Website is a set of web pages that you have uploaded to Project Kenai to use as your project's public home page. This home page is accessed through a web browser at the URL http://your-project-name.kenai.com. The site can be a public face for users of your software and can include multimedia, your own CSS, and your designed HTML pages. Content for the site could include software downloads and release information, upcoming plans, marketing information, and so on. Additionally, a Java-based project could host its Javadoc here.

You can use either a SCM Website Hook or a WebDAV client to upload a set of HTML, CSS, image, and other files for your web site to https://kenai.com/website/your-project-name. For information on uploading files, see Working With Your Project's Website.

If you don't set this feature, the URL http://your-project-name.kenai.com defaults to your project home page, http://kenai.com/projects/your-project-name.

This web site is completely under your control. If you select the "Include Normal Navigation?" option, then you only need to supply the main content, and it will be surrounded by the automatic navigation you see with many pages on this site, like the left navbar that links to your project features, the breadcrumbs list, or search. Otherwise, leaving the option unchecked will require you to supply your own links if you want the user to be able to navigate to your project.

Note: Your project will continue to have a project home page accessible from Project Kenai. The project website does not replace the project home page, making the project website useful as a site for users of your software. The project home page can continue to be used by developers and others who want to participate in the project on Project Kenai. If you want to customize the project home page, see the section, WikiHomePage.

You can do the following things with this feature:

  • Adding a Website—Click Add next to Website and then enter a display name and description for the site. The description is optional.
    Note: This option doesn't add the actual web site, but just turns the feature on so that accessing the URL http://your-project-name.kenai.com shows the web pages you uploaded.
  • Include Normal Navigation?— Select this option to surround your content with the default navbar, header, and footer containing links to your project features.
  • Deleting a Website—Click the more droplist to the right of the website name and choose Delete. (See figure above.)
    Note: Choosing Delete doesn't delete the files you uploaded. It just turns the feature off so that users no longer see your web site.
  • Editing a Website's Display Name and Description—Click Edit to the right of the website name and change the Website's display name or description. (See figure above.)
  • Setting Role Permissions—Click the more droplist to the right of the website name and choose Set Role Permissions. (See figure above.) You see a table of checkboxes showing roles and actions those roles can take with the download area. The tasks you can set for the various roles are simple: View Website and Update Website.

    By default, anyone can see your web site, but only project administrators, software developers, and content developers can add or delete files.

    For information on the roles in this table, see the role definitions table in Managing a Project.

WikiHomePage

This feature is on the Features tab on the Manage page, as described above under Opening the Manage Page.

A Wiki Home Page is a way to provide a customized project home page for your project. You edit your project's wiki Home page to add the content about your project that you want people to see on the Project Kenai site. After you set this feature, project administrators continue to see the default home page. For all other users who are permitted to see your wiki pages, this page replaces the default project home page.

To control who sees your wiki pages, see Setting Role Permission above under Wiki.

Note: You can have both a wiki home page and a project website. The wiki home page replaces your project home page and is for use by developers and other Project Kenai members who want to participate in or learn about your project. The project website is available externally to a wider audience and can be used to provide information to the users of your software, such as information on the latest releases, plans for upcoming releases, marketing information, and so on.

For example, here's how the default project home page for the Bluebird project looks:

And here's the new project home page in the Bluebird wiki:

As you can see, with the customized wiki home page, all the project navigation is still available in the left navigation bar, and you provide the look you want for your project page.

You can do the following things with this feature:

  • Adding a WikiHomePage—Click Add next to WikiHomePage and then enter a description for the page. The description is optional.
    Note: Add doesn't add a page, but simply changes your project home page from the default home page to your wiki Home page.


  • Deleting a WikiHomePage—Click the more droplist to the right of the wikihome name and choose Delete.


    Note: Delete doesn't delete a page, but simply changes your project home page back to the default home page.

  • Editing a WikiHomePage's Description—Click Edit to the right of the wikihome name and change the WikiHomePage's description.

Emails Tab

This feature is on the Emails tab on the Manage page, as described above under Opening the Manage Page.

This tab enables you to customize the email that gets sent when you add a new member in the Members tab. You can edit any of the fields, and you can use a set of predefined template variables in the email, such as {{project_display_name}}, which cause text to be inserted when the email is sent.

The template variables are listed at the bottom of the page with some of the default values filled in. Here's what they would be for the Bluebird project:

  • host:   Kenai.com
  • project_display_name:   Bluebird
  • project_url:  http://kenai.com/projects/bluebird
  • role_display_name:  the member's new role on the project
  • signature:   The Project Kenai Team
  • wiki_home_url:   http://kenai.com/projects/bluebird/pages/Home

Web Hooks Tab

This feature is on the Web Hooks tab on the Manage page, as described above under Opening the Manage Page.

This tab enables you to set a URL, a callback to a page that can accept web hook data from your Project Kenai project. Web hooks provide a way for you to handle data resulting from changes in your Kenai projects on a web page of your choosing (as opposed to using something like an RSS feed). In this tab, you provide the URL of the web page that has code to interpret and handle the JSON data sent by Project Kenai. In addition, you need to click the checkbox next to the features you want to track. At present, there is one feature you can track, source code repository updates.

Note: A web hook is automatically disabled after 10 failed connection attempts. After a web hook is disabled, you must change the URL to re-enable the web hook.

For general information on working with web hooks, see About Web Hooks.

Analytics Tab

This tab enables you to add the tracking code from a profile you have set up on Google Analytics so your project's web page statistics can be gathered by Google. Click Add Analytic, add the tracking code code to that field, and click Add. Within 24 hours you will have data on your project in your Google account. For more information, see Using Analytics With Your Projects.

   

Difference compared to previous revision
<span><span style="text-decoration:line-through;color:red"> </span>[[Home|&raquo; <span style="text-decoration:line-through;color:red">N</span><span style="text-decoration:underline;color:green">Proj</span>e<span style="text-decoration:underline;color:green">c</span>et<span style="text-decoration:line-through;color:red">b</span>t<span style="text-decoration:underline;color:green"> K</span>e<span style="text-decoration:underline;color:green">n</span>a<span style="text-decoration:underline;color:green">i Docume</span>ean<span style="text-decoration:line-through;color:red">s.</span>n<span style="text-decoration:underline;color:green">tati</span>o<span style="text-decoration:underline;color:green">n and T</span>r<span style="text-decoration:underline;color:green">ainin</span>g<span style="text-decoration:underline;color:green">]]</span>org <span style="text-decoration:line-through;color:red">Site</span> <span style="text-decoration:underline;color:green">&nbsp;&nbsp;</span><span style="text-decoration:line-through;color:red">T</span><span style="text-decoration:underline;color:green">[[H</span>o<span style="text-decoration:underline;color:green">wd</span>oo<span style="text-decoration:line-through;color:red">ls</span>o<span style="text-decoration:underline;color:green">i|&raquo;</span> H<span style="text-decoration:line-through;color:red">elp</span><span style="text-decoration:underline;color:green">ow</span> <span style="text-decoration:line-through;color:red">- H</span><span style="text-decoration:underline;color:green">D</span>o<span style="text-decoration:line-through;color:red">me</span> <span style="text-decoration:line-through;color:red">Page</span>o <span style="text-decoration:underline;color:green">I ...</span>]] <span style="text-decoration:underline;color:green"> </span><h1>Managing a Project</h1> <span style="text-decoration:underline;color:green"> </span>If you<span style="text-decoration:underline;color:green"> [[CreateProject|created a project]] or you</span>]] <h1>Managing a Project</h1> If you're an administrator for <span style="text-decoration:line-through;color:red">a</span>'re an administrator for <span style="text-decoration:underline;color:green">the</span> project, you can change the project's settings on the Manage page. __TOC__ ==Opening the Manage Page== ... ==Opening the Manage Page== To manage a project: #<span style="text-decoration:line-through;color:red">Click My Pag</span><span style="text-decoration:underline;color:green">Op</span>e<span style="text-decoration:line-through;color:red"> i</span>n the <span style="text-decoration:line-through;color:red">right navbar.<br/><br/>[[image:my</span>p<span style="text-decoration:line-through;color:red">age-select.png]]<b</span>r<span style="text-decoration:line-through;color:red">/><br/>'''N</span>o<span style="text-decoration:line-through;color:red">t</span>en the pro<span style="text-decoration:underline;color:green">j</span>e<span style="text-decoration:line-through;color:red">:''' If you don'</span><span style="text-decoration:underline;color:green">c</span>t <span style="text-decoration:line-through;color:red">see My P</span><span style="text-decoration:underline;color:green">p</span>age <span style="text-decoration:line-through;color:red">under Navigati</span><span style="text-decoration:underline;color:green">(f</span>o<span style="text-decoration:line-through;color:red">n, click you</span>r <span style="text-decoration:line-through;color:red">us</span>e<span style="text-decoration:line-through;color:red">rn</span>or e<span style="text-decoration:underline;color:green">x</span>am<span style="text-decoration:underline;color:green">pl</span>ame<span style="text-decoration:line-through;color:red"> under Community</span>, <span style="text-decoration:line-through;color:red">then </span>e, click <span style="text-decoration:underline;color:green">''</span>My Page<span style="text-decoration:underline;color:green">''</span>click My Page <span style="text-decoration:line-through;color:red">when the N</span>a<span style="text-decoration:line-through;color:red">vigatio</span> an<span style="text-decoration:underline;color:green">d</span>n <span style="text-decoration:line-through;color:red">sele</span>c<span style="text-decoration:line-through;color:red">t</span> c<span style="text-decoration:underline;color:green">l</span>i<span style="text-decoration:line-through;color:red">ons appear.<br/><br/> #S</span>c<span style="text-decoration:line-through;color:red">roll</span>ic<span style="text-decoration:underline;color:green">k</span> t<span style="text-decoration:line-through;color:red">o t</span> the project<span style="text-decoration:underline;color:green">'s</span> <span style="text-decoration:underline;color:green">link) </span>he project and c<span style="text-decoration:line-through;color:red">lick</span>and c<span style="text-decoration:underline;color:green">hoose</span> <span style="text-decoration:line-through;color:red"> </span> ''Manage<span style="text-decoration:underline;color:green"> This Project</span>''Manage''.<br/><br/>[[image:manage-<span style="text-decoration:line-through;color:red">clickmanage</span>''.<br/><br/>[[image:manage-project<span style="text-decoration:underline;color:green">-select</span>.png]]<br/><br/> #The Manage page opens.<br/><br/>[[image:manage-settings-page.png]] On the Manage page, you see the following tabs: * <a href="#Settings">'''Settings'''</a>&mdash;Basic settings, like title, description, tags, and license. On this tab, you can select more than one license. Each license has a link to a description of the license. ... **<a href="#MailingLists">Mailing Lists</a> **<a href="#SourceCodeRepository">Source Code Repositories</a> **<a href="#Wiki">Wikis</a> **<a href="#<span style="text-decoration:underline;color:green">MessageForums">Message Forums</a> **<a href="#</span>Downloads">Downloads</a> **<a href="#<span style="text-decoration:underline;color:green">Chat_Room">Chat Room</a> **<a href="#</span>Website">Website</a> **<a href="#WikiHomePage">WikiHomePage</a> *<a href="#Emails">'''Emails'''</a>&mdash;Customize the email that is sent automatically to new members of your project. *<a href="#WebHooks">'''Web Hooks'''</a>&mdash;Supply a URL to a web page where you have code to handle JSON output from project events, like commits to a code repository. <span style="text-decoration:underline;color:green">*<a href="#Analytics">'''Analytics'''</a>&mdash;Use Google Analytics to get statistics on your project.</span> <span style="text-decoration:underline;color:green"> </span>project.png]]<br/><br/> #The Manage page opens.<br/><br/>[[image:manage-settings-page.png]] On the Manage page, you see the following tabs: * <a href="#Settings">'''Settings'''</a>&mdash;Basic settings, like title, description, tags, and license. On this tab, you can select more than one license. Each license has a link to a description of the license. ... [[image:manage-proj-settingstab.png]]<br/> ''To open the page this tab is on, see <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' This tab enables you to set basic settings for the project, available when the project was first created. You can change any of the settings on this tab. For example, if you just chose defaults or did the bare minimum to get the project created, you can fix that on this tab. You can also use this tab to delete the project. The ''Delete'' button <span style="text-decoration:line-through;color:red">appear</span><span id="Settings"></span> ==Settings Tab== [[image:manage-proj-settingstab.png]]<br/> ''To open the page this tab is on, see <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' This tab enables you to set basic settings for the project, available when the project was first created. You can change any of the settings on this tab. For example, if you just chose defaults or did the bare minimum to get the project created, you can fix that on this tab. You can also use this tab to delete the project. The ''Delete'' button <span style="text-decoration:underline;color:green">i</span>s at the bottom of the page<span style="text-decoration:line-through;color:red"> if you are the only member of the project</span>s at the bottom of the page. '''Note:''' The project name, which is part of the project URL, is not on the Settings tab because it cannot be changed once the project has been created. <span style="text-decoration:underline;color:green">For more information on creating projects, see [[CreateProject|Creating a Project]]. </span>===Project Settings=== * '''Project Owner'''&mdash;Initially, the username of the <span style="text-decoration:underline;color:green">Project Kenai </span>. '''Note:''' The project name, which is part of the project URL, is not on the Settings tab because it cannot be changed once the project has been created. ... ===Project Settings=== * '''Project Owner'''&mdash;Initially, the username of the member who created the project. Project ownership can be assigned by the owner to any administrator of the project. * '''Project Title'''&mdash;A descriptive title that will be shown in lists of projects. Maximum of 40 characters. (for example, <tt><span style="text-decoration:line-through;color:red">J</span>member who created the project. Project ownership can be assigned by the owner to any administrator of the project. * '''Project Title'''&mdash;A descriptive title that will be shown in lists of projects. Maximum of 40 characters. (for example, <tt><span style="text-decoration:underline;color:green">Project Ken</span>a<span style="text-decoration:line-through;color:red">vaEE</span><span style="text-decoration:underline;color:green">i</span></tt>) * '''Description'''&mdash;Enter a detailed description of your project, including things like development status. Maximum of 500 characters. * '''Tags'''&mdash;Tags are search terms that users can use to find your project. * '''License'''&mdash;The source code license that you require members of your project to agree to when they participate in, and especially when they contribute to, the project. Choose one or more from the list. ... * '''Parent Project'''&mdash;If your project is part of another project, you can specify that project here. For example, if your project is a sub-project of a larger project, you would select that larger project as the Parent. Links will be automatically generated between child and parent projects. ===Deleting a Project=== Only the owner of a project can delete it. To see if you're the owner, check the Project Owner field on the Settings tab <span style="text-decoration:underline;color:green">of the project's Manage page </span></tt>) * '''Description'''&mdash;Enter a detailed description of your project, including things like development status. Maximum of 500 characters. * '''Tags'''&mdash;Tags are search terms that users can use to find your project. * '''License'''&mdash;The source code license that you require members of your project to agree to when they participate in, and especially when they contribute to, the project. Choose one or more from the list. ... Before you delete a project, be sure to notify all your project members and give them time to move data off the project. '''Note:''' You must <span style="text-decoration:line-through;color:red">d</span>(see [[#Settings|Settings Tab]] above). Before you delete a project, be sure to notify all your project members and give them time to move data off the project. '''Note:''' You must <span style="text-decoration:underline;color:green">r</span>e<span style="text-decoration:line-through;color:red">l</span><span style="text-decoration:underline;color:green">mov</span><span style="text-decoration:line-through;color:red">te</span> all members <span style="text-decoration:line-through;color:red">but yoursel</span>f<span style="text-decoration:line-through;color:red"> f</span>rom the project before the Delete button will show. To delete the project, click the <span style="text-decoration:line-through;color:red">''</span>Delete<span style="text-decoration:line-through;color:red">''</span>e all members from the project before the Delete button will show. To delete the project, click the Delete button at the bottom of the <span style="text-decoration:underline;color:green">[[#</span>Settings<span style="text-decoration:underline;color:green">|Settings</span> tab<span style="text-decoration:underline;color:green">]]</span> button at the bottom of the Settings tab. [[image:manage-deleteproject.png]] ... [[image:manage-proj-memberstab.png]]<br/> ''To open the page this tab is on, see <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' You can add members to your project if they have usernames on this site. To se<span style="text-decoration:line-through;color:red">arch for p</span>e<span style="text-decoration:line-through;color:red">ople</span> <span style="text-decoration:line-through;color:red">or see </span>a list of usernames, click the ''People'' link (or right-click it and open it in a new tab or window so you don't lose this settings tab). People can also request to become members of the project by signing up on the project page and requesting a role. If someone does that, you as a project administrator will receive a notification of the request. * '''To add a member:''' Click ''Add Member'' and enter the username. Pick an appropriate role (Observer, Software Developer, Content Developer, or Administrator) and status (Active or Inactive). * '''To delete a member:''' Click the ''More'' droplist to the right of the member's name and choose ''Delete''.<br /><span id="deleteadmin"></span>'''Note:''' When you delete a member who's in an administrator role, make sure to [[MailingLists#Adding_and_removing_subscribers|delete their mailing list subscriptions]] as well. You have to do this because administrators are automatically subscribed to the project mailing lists when added to a project, but they aren't removed from mailing lists when removed from the project. ... |- valign="top" |Software&nbsp;Developer&nbsp;&nbsp; |Top level developer. Can do anything with the code and content. |- valign="top" <span style="text-decoration:line-through;color:red"> </span>. [[image:manage-deleteproject.png]] ... |Software&nbsp;Developer&nbsp;&nbsp; |Top level developer. Can do anything with the code and content. |- valign="top" style="background-color:#F1F1F1;" |<span style="text-decoration:underline;color:green">Tester&nbsp;&nbsp; |Someone who's job it is to test the software. Defaults to same permissions as Software Developer. |- valign="top" |</span>Content&nbsp;Developer&nbsp;&nbsp; |Second level developer. Typically, can edit the wiki, but not commit code. |- valign="top" <span style="text-decoration:underline;color:green">style="background-color:#F1F1F1;"</span>style="background-color:#F1F1F1;" |Content&nbsp;Developer&nbsp;&nbsp; |Second level developer. Typically, can edit the wiki, but not commit code. |- valign="top" ... |- valign="top" |Observer |Here to watch, comment, and connect. |- valign="top" <span style="text-decoration:line-through;color:red">style="background-color:#F1F1F1;"</span> |Unregistered&nbsp;&nbsp; |Logged in as a <span style="text-decoration:line-through;color:red">n</span> |Observer |Here to watch, comment, and connect. |- valign="top" |Unregistered&nbsp;&nbsp; |Logged in as a <span style="text-decoration:underline;color:green">Proj</span>e<span style="text-decoration:underline;color:green">c</span>et<span style="text-decoration:line-through;color:red">b</span>t<span style="text-decoration:underline;color:green"> K</span>e<span style="text-decoration:line-through;color:red">a</span>n<span style="text-decoration:line-through;color:red">s.org</span>en<span style="text-decoration:underline;color:green">ai</span> user, but not watching or otherwise participating in this project. |- valign="top"<span style="text-decoration:underline;color:green"> style="background-color:#F1F1F1;"</span> user, but not watching or otherwise participating in this project. |- valign="top" |Unauthenticated&nbsp;&nbsp; |Not logged in as a user of <span style="text-decoration:line-through;color:red">n</span> |Unauthenticated&nbsp;&nbsp; |Not logged in as a user of <span style="text-decoration:underline;color:green">Proj</span>e<span style="text-decoration:underline;color:green">c</span>et<span style="text-decoration:line-through;color:red">b</span>t<span style="text-decoration:underline;color:green"> K</span>e<span style="text-decoration:line-through;color:red">a</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:line-through;color:red">org</span>. |} '''Note:''' The project administrator can set the permissions for all the roles to those that make sense for the project. Each feature described below under Features Tab has its own permissions settings. <span style="text-decoration:underline;color:green">Also, a single member can have more than one role. For example, if Content Developers have permission to add, delete, and change pages on the project wiki, but someone in a Software Developer role typically does not, a member who is permitted to both check in code and write wiki pages could be given both roles.</span> |} '''Note:''' The project administrator can set the permissions for all the roles to those that make sense for the project. Each feature described below under Features Tab has its own permissions settings. ... ===Issue Tracking=== ''This feature is on the Features tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' Issue tracking is a feature that helps you keep track of bugs and feature requests. <span style="text-decoration:line-through;color:red">T</span> For a table showing all the default permissions settings, see [[Projectpermissions|Default Project Activity Permissions]]. ... ===Issue Tracking=== ''This feature is on the Features tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' Issue tracking is a feature that helps you keep track of bugs and feature requests. <span style="text-decoration:underline;color:green">You can </span>h<span style="text-decoration:underline;color:green">av</span>he <span style="text-decoration:line-through;color:red">s</span>e <span style="text-decoration:underline;color:green">two </span>i<span style="text-decoration:underline;color:green">ssue </span>t<span style="text-decoration:underline;color:green">rack</span>e<span style="text-decoration:underline;color:green">rs</span> <span style="text-decoration:underline;color:green">for a </span>ite pro<span style="text-decoration:line-through;color:red">vid</span>pro<span style="text-decoration:underline;color:green">j</span>e<span style="text-decoration:line-through;color:red">s</span><span style="text-decoration:underline;color:green">ct. For</span> <span style="text-decoration:underline;color:green">general informa</span>t<span style="text-decoration:underline;color:green">ion on working wit</span>h<span style="text-decoration:underline;color:green"> issu</span> the <span style="text-decoration:line-through;color:red">B</span>e <span style="text-decoration:underline;color:green">tracking, see [[Iss</span>u<span style="text-decoration:underline;color:green">eTrackin</span>ug<span style="text-decoration:line-through;color:red">z</span>g<span style="text-decoration:underline;color:green">|About Issue Track</span>i<span style="text-decoration:line-through;color:red">ll</span><span style="text-decoration:underline;color:green">ng]]. There </span>a<span style="text-decoration:underline;color:green">re</span> <span style="text-decoration:underline;color:green">two </span>issue tracker<span style="text-decoration:underline;color:green">s</span>a issue tracker <span style="text-decoration:line-through;color:red">fo</span> <span style="text-decoration:underline;color:green">that a</span>r<span style="text-decoration:underline;color:green">e</span>r <span style="text-decoration:line-through;color:red">p</span> <span style="text-decoration:underline;color:green">di</span>r<span style="text-decoration:line-through;color:red">oj</span>ect<span style="text-decoration:line-through;color:red">s.</span>rect<span style="text-decoration:underline;color:green">ly</span> <span style="text-decoration:line-through;color:red">If, in</span> s<span style="text-decoration:underline;color:green">uppor</span>ste<span style="text-decoration:line-through;color:red">a</span>ted, <span style="text-decoration:underline;color:green">Bugzilla and Jira. If </span>d, you prefer to use an issue tracker external to the site, you can do that by specifying External Issue Tracker when you add an issue tracker (see [[#addinganissuetracker|Adding an Issue Tracker below]]). The following figure shows the issue tracking section of the Manage page with an existing issue tracker: <span id="issuetrackermainfig"></span> [[image:manage-issuetracking.png]]<br/> '''Note:''' The message saying that you cannot add another issue tracker is replaced by Add when there is no issue tracker, as you can see below<span style="text-decoration:line-through;color:red"> under Adding an Issue Tracker</span>. You can do the following management tasks with issue tracking. ... <span id="addinganissuetracker"></span> ====Adding an Issue Tracker==== If you see ''Add'' next to the Issue Tracking feature name, you can add an issue tracker to your project.<br/>[[image:<span style="text-decoration:line-through;color:red">m</span>a<span style="text-decoration:line-through;color:red">nage-a</span>dd-issuetracking.png]]<br/> '''Note:''' If you add an issue tracker, your project automatically gets an Issues mailing list tied to the issue tracking system. '''To add an issue tracker:''' # Click Add next to the Issue Tracking feature name. You see the following inline dialog open:<br/>[[image:<span style="text-decoration:line-through;color:red">m</span>a<span style="text-decoration:line-through;color:red">nage-a</span>you prefer to use an issue tracker external to the site, you can do that by specifying External Issue Tracker when you add an issue tracker (see [[#addinganissuetracker|Adding an Issue Tracker below]]). The following figure shows the issue tracking section of the Manage page with an existing issue tracker: <span id="issuetrackermainfig"></span> [[image:manage-issuetracking.png]]<br/> ... # Click Add next to the Issue Tracking feature name. You see the following inline dialog open:<br/>[[image:add-issuetracker-dialog.png]] # Add a Display Name for your issue tracker and pick the tracker you want to use from the Issue Tracker droplist. # Optionally add a description. # For the '''Issue Tracker''' droplist, if you choose <span style="text-decoration:underline;color:green">Jira or </span>dd-issuetracker-dialog.png]] # Add a Display Name for your issue tracker and pick the tracker you want to use from the Issue Tracker droplist. # Optionally add a description. # For the '''Issue Tracker''' droplist, if you choose Bugzilla, click the Add button, and your issue tracker will be hooked up to your project. # For the '''Issue Tracker''' droplist, if you choose External Issue Tracker, a URL field opens:<br/><br/>[[image:<span style="text-decoration:line-through;color:red">m</span>a<span style="text-decoration:line-through;color:red">nage-a</span>dd-ext-issuetracker-dialog.png]] # Enter the URL where your issue tracker is located, then click the Add button to add it. For example, as shown in the figure above, if your project is JRuby, you might enter <tt><nowiki>http://jira.codehaus.org/browse/JRUBY</nowiki></tt>. ====Deleting an Issue Tracker==== Click ''more'' to the right of the issue tracker name and click Delete. ... In the Edit dialog, you can change the Display Name that users of your project see for your issue tracker, as well as the description. ====Managing Issue Tracker Roles and Tasks==== From the <span style="text-decoration:line-through;color:red">n</span>Bugzilla, click the Add button, and your issue tracker will be hooked up to your project. # For the '''Issue Tracker''' droplist, if you choose External Issue Tracker, a URL field opens:<br/><br/>[[image:add-ext-issuetracker-dialog.png]] # Enter the URL where your issue tracker is located, then click the Add button to add it. For example, as shown in the figure above, if your project is JRuby, you might enter <tt><nowiki>http://jira.codehaus.org/browse/JRUBY</nowiki></tt>. ====Deleting an Issue Tracker==== ... In the Edit dialog, you can change the Display Name that users of your project see for your issue tracker, as well as the description. ====Managing Issue Tracker Roles and Tasks==== From the <span style="text-decoration:underline;color:green">Proj</span>e<span style="text-decoration:underline;color:green">c</span>et<span style="text-decoration:line-through;color:red">b</span>t<span style="text-decoration:underline;color:green"> K</span>e<span style="text-decoration:line-through;color:red">a</span>n<span style="text-decoration:line-through;color:red">s.org</span>en<span style="text-decoration:underline;color:green">ai</span> point of view, the tasks users can perform in an issue tracker (like creating bugs, editing bugs, and so on) depend on their roles in the project. You can't change the issue tracker permissions for individual project roles in <span style="text-decoration:underline;color:green">Projec</span> point of view, the tasks users can perform in an issue tracker (like creating bugs, editing bugs, and so on) depend on their roles in the project. You can't change the issue tracker permissions for individual project roles in t<span style="text-decoration:line-through;color:red">his</span> <span style="text-decoration:line-through;color:red">ma</span>t <span style="text-decoration:underline;color:green">Ke</span>na<span style="text-decoration:line-through;color:red">ge</span><span style="text-decoration:underline;color:green">i</span> <span style="text-decoration:line-through;color:red">p</span>a<span style="text-decoration:line-through;color:red">ge a</span>s you can with other features, but you can move your project members to new <span style="text-decoration:line-through;color:red">n</span> as you can with other features, but you can move your project members to new <span style="text-decoration:underline;color:green">K</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s.org</span>en<span style="text-decoration:underline;color:green">ai</span> roles. To see how the roles map for each type of issue tracker, see [[Projectpermissions#issuetracking|Issue Tracking]] on the Default Project Activity Permissions page. '''Note:''' In addition to [[#Members_Tab|changing your members' roles in your <span style="text-decoration:line-through;color:red">n</span><span style="text-decoration:underline;color:green">K</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s.org</span>en<span style="text-decoration:underline;color:green">ai</span> project]], you can change <span style="text-decoration:underline;color:green">individual users' roles in the Jira issue tracker, and you can change </span>what groups can do in Bugzilla.<span style="text-decoration:underline;color:green"> *</span> In <span style="text-decoration:underline;color:green">Jira, you can change user settings as described in [[JiraManageUsers|Setting User Roles for the Jira Issue Tracker]]. * In </span> project]], you can change what groups can do in Bugzilla. In Bugzilla, you can assign group controls to your project as described on the Bugzilla help page [http://kenai.com/bugzilla/docs/en/html/products.html#product-group-controls Assigning Group Controls to Products]. For information on the <span style="text-decoration:line-through;color:red">n</span>Bugzilla, you can assign group controls to your project as described on the Bugzilla help page [http://kenai.com/bugzilla/docs/en/html/products.html#product-group-controls Assigning Group Controls to Products]. For information on the <span style="text-decoration:underline;color:green">K</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s.org</span>en<span style="text-decoration:underline;color:green">ai</span> roles, see the [[#roledefs|role definitions]] above. <span id="MailingLists"></span> ===Mailing Lists=== ... ** '''Moderate Posts'''&mdash;If the list is moderated, receives posts and is responsible for approving them before they go to the list. See ''Send Scheme'' below for information on making a list moderated. ** '''Compose on Web'''&mdash;Allowed to compose messages on this site with the email editor. Users who aren't allowed to compose on the web must use their own email clients to send emails to the list. ** '''Subscribe to List'''&mdash;Allowed to subscribe and receive messages from the list. For example, you could limit this permission to members of the project. * '''Managing a List'''&mdash;Click the list description link (for example, ''Commits Mailing List'') and choose Manage List under that list item. For more information, see [[Ma<span style="text-decoration:underline;color:green">ili</span> roles, see the [[#roledefs|role definitions]] above. <span id="MailingLists"></span> ===Mailing Lists=== ... ** '''Moderate Posts'''&mdash;If the list is moderated, receives posts and is responsible for approving them before they go to the list. See ''Send Scheme'' below for information on making a list moderated. ** '''Compose on Web'''&mdash;Allowed to compose messages on this site with the email editor. Users who aren't allowed to compose on the web must use their own email clients to send emails to the list. ** '''Subscribe to List'''&mdash;Allowed to subscribe and receive messages from the list. For example, you could limit this permission to members of the project. * '''Managing a List'''&mdash;Click the list description link (for example, ''Commits Mailing List'') and choose Manage List under that list item. For more information, see [[Man<span style="text-decoration:line-through;color:red">a</span>g<span style="text-decoration:line-through;color:red">e</span>ng<span style="text-decoration:underline;color:green">Lists#</span>Ma<span style="text-decoration:underline;color:green">nag</span>Mai<span style="text-decoration:line-through;color:red">l</span>i<span style="text-decoration:underline;color:green">ng_a_S</span>ing<span style="text-decoration:underline;color:green">le_Email_</span>ingList|Managing <span style="text-decoration:line-through;color:red">M</span>List|Managing a<span style="text-decoration:underline;color:green"> S</span>ai<span style="text-decoration:line-through;color:red">li</span>ing<span style="text-decoration:underline;color:green">le</span> <span style="text-decoration:underline;color:green">Email </span>ng List<span style="text-decoration:line-through;color:red">s</span>]]. <span style="text-decoration:line-through;color:red">* </span>For general information on using mailing lists, see [[MailingLists|About <span style="text-decoration:line-through;color:red">Project </span>List]]. For general information on using mailing lists, see [[MailingLists|About Mailing Lists]]. ... ===Source Code Repository=== ''This feature is on the Features tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' You can choose a supported source code management (SCM) system, Subversion<span style="text-decoration:underline;color:green">,</span>Mailing Lists]]. <span id="SourceCodeRepository"></span> ===Source Code Repository=== ... ===Source Code Repository=== ''This feature is on the Features tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' You can choose a supported source code management (SCM) system, Subversion <span style="text-decoration:line-through;color:red">or </span> Mercurial, <span style="text-decoration:underline;color:green">or Git, </span>and your project will be set up with a repository for that SCM. If you choose External Source Code Repository, nothing will be set up for you on this site, and you have to do it yourself as described below under [[#addexternalrepos|Adding an External Repository]]. You can have more than one repository of more than one type. This feature lets you add, delete, and manage repositories, and also lets you determine who can check files in and out and who can browse your repositories. ... You can do the following management tasks with source code repositories: <span id="add_scm_repository"></span> ====Adding a Subversion<span style="text-decoration:underline;color:green">,</span>Mercurial, and your project will be set up with a repository for that SCM. If you choose External Source Code Repository, nothing will be set up for you on this site, and you have to do it yourself as described below under [[#addexternalrepos|Adding an External Repository]]. You can have more than one repository of more than one type. This feature lets you add, delete, and manage repositories, and also lets you determine who can check files in and out and who can browse your repositories. ... You can do the following management tasks with source code repositories: <span id="add_scm_repository"></span> ====Adding a Subversion <span style="text-decoration:line-through;color:red">or </span> Mercurial<span style="text-decoration:underline;color:green">,</span> <span style="text-decoration:underline;color:green">or Git </span>Source Code Repository==== '''Note:''' If you add a code repository, your project also gets a Commits mailing list tied to the source control system. To add a Subversion<span style="text-decoration:underline;color:green">,</span>Mercurial Source Code Repository==== '''Note:''' If you add a code repository, your project also gets a Commits mailing list tied to the source control system. To add a Subversion <span style="text-decoration:line-through;color:red">or </span> Mercurial<span style="text-decoration:underline;color:green">,</span> <span style="text-decoration:underline;color:green">o</span>r<span style="text-decoration:underline;color:green"> Git r</span>epository: # Click ''Add'' next to Source Code Repository and then enter the Display Name and the Name of the repository.<br />The Name is used in the repository URL and has to be unique for this project's repositories. It can contain alphanumeric characters and underscores. <br/><span id="image_add_scm"></span>[[image:manage-add-scm.png]] # Select which Source Control System type you want this repository to be, Subversion<span style="text-decoration:underline;color:green">,</span>Mercurial repository: # Click ''Add'' next to Source Code Repository and then enter the Display Name and the Name of the repository.<br />The Name is used in the repository URL and has to be unique for this project's repositories. It can contain alphanumeric characters and underscores. <br/><span id="image_add_scm"></span>[[image:manage-add-scm.png]] # Select which Source Control System type you want this repository to be, Subversion <span style="text-decoration:line-through;color:red">or </span> Mercurial<span style="text-decoration:underline;color:green">, or Git</span>Mercurial. # Set the email commit message type, as described below. # Click the Add button. <span style="text-decoration:line-through;color:red"><span id="scm_commit_email_settings"></span></span>. # Set the email commit message type, as described below. # Click the Add button. ... # Select ''External Link'' from the Source Control System droplist. # Enter the URL or command line for checking out the source code. This URL is displayed as text that a project member can cut and paste into an SCM client later.<br />For example, for the GlassFish project on Java.net, you might enter<br/><tt>cvs -d :pserver:{username}@cvs.dev.java.net/cvs checkout glassfish</tt> # Optionally enter the URL for browsing the source code. <br/>For example, for java.net, this is usually something like<br/> <tt><nowiki>https://glassfish.dev.java.net/source/browse/glassfish</nowiki></tt> # Click the Add button.<span style="text-decoration:underline;color:green"><span id="scm_commit_email_settings"></span></span> ====Setting Size of Email Commit Messages==== Click ''Edit'' to the right of the repository name. ... :[[image:manage-proj-clickedit.png]] The fields you can edit are described above under [[#add_scm_repository|Adding a Subversion<span style="text-decoration:underline;color:green">,</span> ====Adding an External Repository==== To add a repository for your project that's external to this site: ... :[[image:manage-proj-clickedit.png]] The fields you can edit are described above under [[#add_scm_repository|Adding a Subversion <span style="text-decoration:line-through;color:red">or </span> Mercurial<span style="text-decoration:underline;color:green">,</span> <span style="text-decoration:underline;color:green">or Git </span>Mercurial Source Code Repository]]. You cannot change the type of repository, but you can change the feature name, display name, and commit message type. <span id="scm_role_permissions"></span> ====Setting Role Permissions==== ... '''Note:''' Changes to repository permission don't take effect immediately, but take about 15 minutes to propagate. ====Copying an Existing Subversion Repository Into Your Project's <span style="text-decoration:line-through;color:red"> </span>Source Code Repository]]. You cannot change the type of repository, but you can change the feature name, display name, and commit message type. <span id="scm_role_permissions"></span> ====Setting Role Permissions==== ... '''Note:''' Changes to repository permission don't take effect immediately, but take about 15 minutes to propagate. ====Copying an Existing Subversion Repository Into Your Project's Subversion Repository==== If you have an existing external Subversion repository that you would like to begin using in your <span style="text-decoration:underline;color:green">Kenai </span>project, you can<span style="text-decoration:underline;color:green">: *</span>Subversion Repository==== If you have an existing external Subversion repository that you would like to begin using in your project, you can <span style="text-decoration:line-through;color:red">either p</span> <span style="text-decoration:underline;color:green">P</span>oint directly to it as an external repository, as described above at [[#Adding_an_External_Repository|Adding an External Repository]]<span style="text-decoration:line-through;color:red">,</span><span style="text-decoration:underline;color:green">. *</span> <span style="text-decoration:underline;color:green">If y</span>o<span style="text-decoration:underline;color:green">u</span>r <span style="text-decoration:underline;color:green">repositor</span>y<span style="text-decoration:underline;color:green">'s number </span>o<span style="text-decoration:underline;color:green">f revisions is less than 1,000, yo</span>u can use Subversion's <tt>svnsync</tt> command to <span style="text-decoration:underline;color:green">dire</span>c<span style="text-decoration:underline;color:green">tly c</span>opy your entire existing repository into your <span style="text-decoration:underline;color:green">Kenai </span> or you can use Subversion's <tt>svnsync</tt> command to copy your entire existing repository into your project's s<span style="text-decoration:line-through;color:red">ub</span>v<span style="text-decoration:line-through;color:red">ersio</span>project's svn repository<span style="text-decoration:underline;color:green">, as described below</span>. You must be a project administrator to use <tt>svnsync</tt> with your project's repository.<span style="text-decoration:underline;color:green"> *</span> <span style="text-decoration:underline;color:green">If your repository has more than 1,000 revisions, you are encouraged to follow the instructions at [[SVNRepositoryMigration|Migrating an Existing Subversion Repository to a Kenai Project Repository]], which tell you how to set the repository up to be copied and how to contact a Project Kenai administrator to schedule the transfer.</span> <span style="text-decoration:underline;color:green">'''</span>To copy the repository with <tt>svnsync</tt>: <span style="text-decoration:underline;color:green">'''</span> <span style="text-decoration:underline;color:green"> '''Note:''' SSH access is faster and more secure than HTTPS access. Therefore, these instructions assume that you'll use SSH. </span>n repository. You must be a project administrator to use <tt>svnsync</tt> with your project's repository. To copy the repository with <tt>svnsync</tt>: # If necessary, set up a <span style="text-decoration:line-through;color:red">n</span># If necessary, set up a <span style="text-decoration:underline;color:green">K</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s.org</span>en<span style="text-decoration:underline;color:green">ai</span> repository as described above at [[#Source_Code_Repository|Source Code Repository]]. # If necessary, set up your local system to use Subversion<span style="text-decoration:underline;color:green"> as described at [[SourceControl#usingsvn|Accessing a Subversion Repository]]</span>. #<span style="text-decoration:underline;color:green"> To set up SSH: #* If you're on a Linux, Mac, or UNIX system, see [[GeneratingAnSSHKey|Generating an SSH Key]]. #* If you're on a Windows system, see: #** [[Winsshwithputty|Generating and Using an SSH Key on a Microsoft Windows Machine]] #** [[Usingsvn-winsshsetup|Setting Up Cygwin to Use SSH on a Microsoft Windows Machine]] #</span>On your local system, run the following <tt>svnsync</tt> commands and substitute <span style="text-decoration:underline;color:green">your username and </span> repository as described above at [[#Source_Code_Repository|Source Code Repository]]. # If necessary, set up your local system to use Subversion. #On your local system, run the following <tt>svnsync</tt> commands and substitute the URLs for your project repository and your external repository:<span style="text-decoration:line-through;color:red"> </span>the URLs for your project repository and your external repository:<<span style="text-decoration:underline;color:green">br/><</span><pre><span style="text-decoration:line-through;color:red"> </span> > svnsync init <span style="text-decoration:line-through;color:red">http</span>pre> > svnsync init s<span style="text-decoration:underline;color:green">vn+ssh</span>://<span style="text-decoration:underline;color:green"><your-user</span>n<span style="text-decoration:underline;color:green">am</span>s://ne<span style="text-decoration:line-through;color:red">tb</span>e<span style="text-decoration:underline;color:green">>@svn.k</span><span style="text-decoration:line-through;color:red">a</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:underline;color:green">c</span>.o<span style="text-decoration:line-through;color:red">rg</span>o<span style="text-decoration:underline;color:green">m</span>/<span style="text-decoration:line-through;color:red">svn/you</span><span style="text-decoration:underline;color:green"><p</span>r<span style="text-decoration:underline;color:green">oject</span>-<span style="text-decoration:underline;color:green">name>~<</span>project-<span style="text-decoration:underline;color:green">svn-</span>r-project-repos<span style="text-decoration:line-through;color:red"> </span>repos<span style="text-decoration:underline;color:green">></span> <span style="text-decoration:line-through;color:red"> </span> http<span style="text-decoration:underline;color:green">s</span>://www.<span style="text-decoration:underline;color:green"><</span>some<span style="text-decoration:underline;color:green">-</span>site<span style="text-decoration:underline;color:green">></span>.org/<span style="text-decoration:underline;color:green"><</span>your-ext-project<span style="text-decoration:underline;color:green">></span>/svn/<span style="text-decoration:underline;color:green"><</span>http://www.somesite.org/your-ext-project/svn/your-repos<span style="text-decoration:line-through;color:red"> </span>your-repos<span style="text-decoration:underline;color:green">></pre><pre></span> > svnsync sync <span style="text-decoration:underline;color:green">svn+ss</span>h<span style="text-decoration:underline;color:green">://<your-username>@svn.kenai.com/<projec</span>t<span style="text-decoration:underline;color:green">-name>~<projec</span><span style="text-decoration:underline;color:green">-svn-re</span>p<span style="text-decoration:underline;color:green">o</span>s<span style="text-decoration:underline;color:green">></pre> #If the transfer is interrupted or there's an error resulting in a hanging lock, use the following command to clean things up</span>:<span style="text-decoration:underline;color:green"><pre> > svn propdel 'svn:sync:lock' --revprop -r 0 svn+ssh:</span>//<span style="text-decoration:underline;color:green"><your-user</span>n<span style="text-decoration:underline;color:green">am</span>e<span style="text-decoration:underline;color:green">>@svn.kenai.com/<projec</span>t<span style="text-decoration:underline;color:green">-name>~<project-svn-repos></pre> #Verify </span>b<span style="text-decoration:underline;color:green">y ch</span>e<span style="text-decoration:underline;color:green">cking out your project </span>an<span style="text-decoration:underline;color:green">d making </span>s<span style="text-decoration:underline;color:green">ure that history has been preserved</span>.<span style="text-decoration:underline;color:green"> If s</span>o<span style="text-decoration:underline;color:green">, you a</span> > svnsync sync https://netbeans.or<span style="text-decoration:line-through;color:red">g/</span>r<span style="text-decoration:underline;color:green">e done.<pre> > </span>svn<span style="text-decoration:underline;color:green"> co svn+ssh:</span>/<span style="text-decoration:underline;color:green">/<</span>your-<span style="text-decoration:underline;color:green">username>@svn.kenai.com/<</span>project-<span style="text-decoration:underline;color:green">name>~<p</span>r<span style="text-decoration:underline;color:green">oj</span>e<span style="text-decoration:underline;color:green">ct-svn-re</span>svn/your-project-repos<span style="text-decoration:line-through;color:red"> </span>pos<span style="text-decoration:underline;color:green">></span></pre> '''Note:''' You don't have to set up the <tt>pre-revprop-change</tt> hook. It's already set up for your <span style="text-decoration:line-through;color:red">n</span><span style="text-decoration:underline;color:green">K</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s.org</span>en<span style="text-decoration:underline;color:green">ai</span> Subversion repositories. The <span style="text-decoration:underline;color:green">Kenai </span>hook script requires only that you be a project administrator. For more information on <tt>svnsync</tt>, see [http://svn.collab.net/repos/svn/trunk/notes/svnsync.txt]. <span style="text-decoration:underline;color:green">For general information on working with source code management and repositories, see [[SourceControl|Source Code Management]]. </span> Subversion repositories. The hook script requires only that you be a project administrator. For more information on <tt>svnsync</tt>, see [http://svn.collab.net/repos/svn/trunk/notes/svnsync.txt]. ... * '''Adding a Wiki'''&mdash;Click ''Add'' in the Wiki heading bar and give the wiki a display name and an optional description. You can also set the name of the home page, which defaults to Home. * '''Renaming a Wiki'''&mdash;Click ''Edit'' to the right of the wiki name.<br/>[[image:manage-proj-clickedit.png]]<br/>You can change the name users of your project see on the project page. You can also change the description here, as well as the home page, as described below. * '''Setting the Wiki Home Page'''&mdash;Click ''Edit'' to the right of the wiki name and enter a wiki page name in the Wiki Default Page field. This sets the page that displays when the user clicks the wiki's link on the project's home page. * '''Setting Role Permissions'''&mdash;Click the ''more'' droplist to the right of the Wiki's name and choose ''Set Role Permissions''.<br/>[[image:manage-proj-clicksetpermissions<span style="text-decoration:line-through;color:red">only</span><span id="Wiki"></span> ===Wiki=== ''This feature is on the Features tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' ... * '''Setting Role Permissions'''&mdash;Click the ''more'' droplist to the right of the Wiki's name and choose ''Set Role Permissions''.<br/>[[image:manage-proj-clicksetpermissions.png]]<br/> You see a table of checkboxes showing roles and actions those roles can take with the wiki. The tasks you can set for the various roles are simple: ''Delete Pages'', ''View Pages'', and ''Edit Pages''. Think about who you want to give access to the wiki and set up roles accordingly. For information on the roles, see the [[#roledefs|role definitions]] above. * '''Making the Wiki Home Page Your Project Home Page'''&mdash;See [[#WikiHomePage|WikiHomePage]] for more information. For general information on working with wikis and using wiki formatting tags, see [[Wikis|About Wikis]].<span style="text-decoration:underline;color:green"><span id</span>.png]]<br/> You see a table of checkboxes showing roles and actions those roles can take with the wiki. The tasks you can set for the various roles are simple: ''Delete Pages'', ''View Pages'', and ''Edit Pages''. Think about who you want to give access to the wiki and set up roles accordingly. For information on the roles, see the [[#roledefs|role definitions]] above. * '''Making the Wiki Home Page Your Project Home Page'''&mdash;See [[#WikiHomePage|WikiHomePage]] for more information. For general information on working with wikis and using wiki formatting tags, see [[Wikis|About Wikis]]. =<span style="text-decoration:line-through;color:red">==D</span>=<span style="text-decoration:underline;color:green">"MessageF</span>o<span style="text-decoration:line-through;color:red">w</span><span style="text-decoration:underline;color:green">rums"></spa</span>n<span style="text-decoration:line-through;color:red">lo</span><span style="text-decoration:underline;color:green">> ===Mess</span>a<span style="text-decoration:line-through;color:red">d</span><span style="text-decoration:underline;color:green">ge Forum</span>s=== ''This feature is on the Features tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' <span style="text-decoration:line-through;color:red">A</span><span style="text-decoration:underline;color:green">Message</span> <span style="text-decoration:underline;color:green">Forums, or just forums, are message boards where your members can discuss the </span>project<span style="text-decoration:underline;color:green">.</span> project <span style="text-decoration:line-through;color:red">h</span> <span style="text-decoration:underline;color:green"> [[im</span>a<span style="text-decoration:line-through;color:red">s</span><span style="text-decoration:underline;color:green">ge:manage-forum.png]] You</span> <span style="text-decoration:underline;color:green">c</span>a<span style="text-decoration:underline;color:green">n</span> a <span style="text-decoration:line-through;color:red">D</span> <span style="text-decoration:underline;color:green">d</span>o<span style="text-decoration:underline;color:green"> the follo</span>w<span style="text-decoration:underline;color:green">i</span>n<span style="text-decoration:underline;color:green">g things with forums: * '''Adding a Forum'''&mdash;C</span>l<span style="text-decoration:underline;color:green">ick ''Add'' next t</span>o<span style="text-decoration:underline;color:green"> Mess</span>a<span style="text-decoration:underline;color:green">ge Forum an</span>d<span style="text-decoration:underline;color:green"> then enter the URI and di</span>s<span style="text-decoration:underline;color:green">play</span> <span style="text-decoration:underline;color:green">n</span>a<span style="text-decoration:underline;color:green">me of the fo</span>r<span style="text-decoration:underline;color:green">um. For </span>e<span style="text-decoration:underline;color:green">x</span>a<span style="text-decoration:underline;color:green">mple,</span> <span style="text-decoration:underline;color:green">you might want to create a </span>for<span style="text-decoration:underline;color:green">um</span> f<span style="text-decoration:underline;color:green">or report</span>i<span style="text-decoration:underline;color:green">ng bugs with the URI <tt>bugsforum</tt> and the disp</span>l<span style="text-decoration:underline;color:green">ay nam</span>e<span style="text-decoration:underline;color:green"> <tt>Bug</span>s <span style="text-decoration:underline;color:green">and Fea</span>t<span style="text-decoration:underline;color:green">ure Suggestions</tt>. T</span>h<span style="text-decoration:underline;color:green">e description is option</span>a<span style="text-decoration:underline;color:green">l, bu</span>t <span style="text-decoration:underline;color:green">useful for </span>you<span style="text-decoration:underline;color:green">r</span> <span style="text-decoration:underline;color:green">members. * '''Deleting a Forum'''&mdash;Click the ''more'' droplist to the right of the forum name and choose ''Delete''.<br/>[[image:manage-proj-clickdelete</span>w<span style="text-decoration:underline;color:green">permissions.png]] * '''Editing </span>a<span style="text-decoration:underline;color:green"> Forum's Setti</span>n<span style="text-decoration:underline;color:green">gs'''&mdash;Click ''Edi</span>t<span style="text-decoration:underline;color:green">''</span> to <span style="text-decoration:underline;color:green">the right of the foru</span>m<span style="text-decoration:underline;color:green"> n</span>a<span style="text-decoration:underline;color:green">me.<br/>[[image:manage-proj-clic</span>ke<span style="text-decoration:underline;color:green">dit.png]]<br/></span> <span style="text-decoration:underline;color:green">Ch</span>ownloads area for files that you want to make a<span style="text-decoration:line-through;color:red">v</span>a<span style="text-decoration:underline;color:green">nge </span><span style="text-decoration:underline;color:green">ny of the f</span>i<span style="text-decoration:underline;color:green">e</span>l<span style="text-decoration:underline;color:green">ds, which </span>a<span style="text-decoration:underline;color:green">re descri</span>ailab<span style="text-decoration:line-through;color:red">l</span>be<span style="text-decoration:underline;color:green">d</span>e <span style="text-decoration:line-through;color:red">f</span> <span style="text-decoration:underline;color:green">ab</span>o<span style="text-decoration:underline;color:green">ve unde</span>r <span style="text-decoration:underline;color:green">A</span>d<span style="text-decoration:underline;color:green">ding a F</span>or do<span style="text-decoration:line-through;color:red">w</span>o<span style="text-decoration:underline;color:green">rum. * '''Setti</span>n<span style="text-decoration:underline;color:green">g Ro</span>l<span style="text-decoration:underline;color:green">e Permissi</span>o<span style="text-decoration:underline;color:green">ns'''&md</span>a<span style="text-decoration:underline;color:green">sh;Click the ''more'' </span>nload<span style="text-decoration:line-through;color:red">.</span>d<span style="text-decoration:underline;color:green">roplist</span> <span style="text-decoration:line-through;color:red">An</span><span style="text-decoration:underline;color:green">t</span>o<span style="text-decoration:underline;color:green"> </span>the<span style="text-decoration:underline;color:green"> </span>r<span style="text-decoration:underline;color:green">ight</span> <span style="text-decoration:underline;color:green">of the for</span>u<span style="text-decoration:underline;color:green">m name and choo</span>se <span style="text-decoration:underline;color:green">''Set R</span>o<span style="text-decoration:underline;color:green">le Permissions''.<br/>[[image:manage-proj-clicksetpermissions.png]]<br/><br/>You see a table o</span>f <span style="text-decoration:underline;color:green">checkboxes showing roles and </span>th<span style="text-decoration:underline;color:green">e act</span>i<span style="text-decoration:underline;color:green">on</span>s <span style="text-decoration:underline;color:green">each role can per</span>f<span style="text-decoration:underline;color:green">orm. Th</span>e<span style="text-decoration:underline;color:green"> </span>a<span style="text-decoration:underline;color:green">c</span>t<span style="text-decoration:underline;color:green">ions ''Create Post'', ''Edit Post'', and ''Delete Post'' allow </span>u<span style="text-decoration:underline;color:green">se</span>r<span style="text-decoration:underline;color:green">s to </span>e<span style="text-decoration:underline;color:green">dit</span> <span style="text-decoration:underline;color:green">and delete only the</span>i<span style="text-decoration:underline;color:green">r own po</span>s<span style="text-decoration:underline;color:green">ts.</span> <span style="text-decoration:underline;color:green">The ac</span>t<span style="text-decoration:underline;color:green">i</span>o<span style="text-decoration:underline;color:green">n</span> <span style="text-decoration:underline;color:green">''Edit or D</span>e<span style="text-decoration:underline;color:green">lete A</span>n<span style="text-decoration:underline;color:green">y Post'' </span>other use of this feature is to ena<span style="text-decoration:line-through;color:red">b</span>al<span style="text-decoration:underline;color:green">lows a us</span>e<span style="text-decoration:underline;color:green">r</span> <span style="text-decoration:underline;color:green">to edit and delete any </span>p<span style="text-decoration:underline;color:green">ost in th</span>e<span style="text-decoration:underline;color:green"> f</span>o<span style="text-decoration:underline;color:green">rum, and by default a</span>p<span style="text-decoration:underline;color:green">p</span>l<span style="text-decoration:underline;color:green">i</span>e<span style="text-decoration:underline;color:green">s</span> <span style="text-decoration:underline;color:green">only </span>to <span style="text-decoration:underline;color:green">the Administrator role.<br/><br/> As an example, yo</span>u<span style="text-decoration:underline;color:green"> might want only </span>p<span style="text-decoration:underline;color:green">roject members to be ab</span>l<span style="text-decoration:underline;color:green">e t</span>o<span style="text-decoration:underline;color:green"> </span>ad<span style="text-decoration:underline;color:green">d</span>le people to upload <span style="text-decoration:line-through;color:red">f</span> <span style="text-decoration:underline;color:green">posts, ed</span>i<span style="text-decoration:underline;color:green">t them, and de</span>ile<span style="text-decoration:line-through;color:red">s</span>le<span style="text-decoration:underline;color:green">te them</span>, <span style="text-decoration:underline;color:green">but you'd </span>like <span style="text-decoration:underline;color:green">everyone to continue to be ab</span>l<span style="text-decoration:underline;color:green">e t</span>, like lo<span style="text-decoration:line-through;color:red">g</span> <span style="text-decoration:line-through;color:red">f</span>o <span style="text-decoration:underline;color:green">read all posts. Under the Unreg</span>i<span style="text-decoration:underline;color:green">stered ro</span>le<span style="text-decoration:underline;color:green">, you uncheck ''Edit Po</span>s<span style="text-decoration:underline;color:green">t''</span>, <span style="text-decoration:underline;color:green">''Crea</span>t<span style="text-decoration:underline;color:green">e P</span>o<span style="text-decoration:underline;color:green">st'',</span>iles, to <span style="text-decoration:line-through;color:red">h</span> <span style="text-decoration:underline;color:green">and ''D</span>el<span style="text-decoration:line-through;color:red">p</span><span style="text-decoration:underline;color:green">ete</span> <span style="text-decoration:underline;color:green">Post'', and then </span>you <span style="text-decoration:underline;color:green">click Up</span>d<span style="text-decoration:underline;color:green">at</span>e<span style="text-decoration:underline;color:green">. For information on the roles, see the [[#roledefs|role definitions]] a</span>b<span style="text-decoration:underline;color:green">ove. For general information on </span>u<span style="text-decoration:underline;color:green">sin</span>g <span style="text-decoration:underline;color:green">forums, see [[Forums|About Forums]]. ===Downloads=== ''Th</span>is<span style="text-decoration:underline;color:green"> feature i</span>s<span style="text-decoration:underline;color:green"> on the Feat</span>u<span style="text-decoration:underline;color:green">r</span>es t<span style="text-decoration:underline;color:green">ab on t</span> you debug issues the<span style="text-decoration:line-through;color:red">y'</span>he<span style="text-decoration:underline;color:green"> Manage page, as described abo</span>ve <span style="text-decoration:underline;color:green">und</span>e<span style="text-decoration:underline;color:green">r <a href="#Ope</span>n<span style="text-decoration:underline;color:green">ing_the_Manage_Page">Opening the Manage Page</a>.'' A proje</span>c<span style="text-decoration:underline;color:green">t has </span>o<span style="text-decoration:underline;color:green">ne Downloads list for project files that yo</span>u<span style="text-decoration:underline;color:green"> wa</span>nt<span style="text-decoration:underline;color:green"> your m</span>e<span style="text-decoration:underline;color:green">mbe</span>r<span style="text-decoration:underline;color:green">s to b</span>e<span style="text-decoration:underline;color:green"> able to </span>d<span style="text-decoration:underline;color:green">ownload, such as the latest build of the project</span>. [[image:manage-downloads.png]] ... * '''Deleting the Downloads list'''&mdash;Click the ''more'' droplist to the right of the downloads list name and choose ''Delete''.<br/>[[image:manage-proj-clickdeletewpermissions.png]] * '''Setting Role Permissions'''&mdash;Click the ''more'' droplist to the right of the download list's name and choose ''Set Role Permissions''.<br/> [[image:manage-proj-clicksetpermissions.png]]<br/> You see a table of checkboxes showing roles and actions those roles can take with the download area. The tasks you can set for the various roles are simple: ''Upload Files'', ''Download files'', ''Edit upload'', and ''Delete upload''. <br/><br/>By default, uploading files to the list, deleting a file from the list, and changing the information displayed for a file in the list can only be done by a project administrator. Additionally, by default, anyone can download a project's files. If you want to change these defaults (for example, to limit downloads to project members), you can do that here. For information on the roles, see the [[#roledefs|role definitions]] above. For general information on working with the Downloads list, see [[Downloads|About Downloads]]. This page also tells you how to [[Downloads#Getting_Downloads_Data|get a summary of data about your project's downloads]].<span style="text-decoration:underline;color:green"><span id</span>=<span style="text-decoration:underline;color:green">"ChatRoom"></span> </span>==<span style="text-decoration:underline;color:green">=Project Chat Room=== ''This feature is on the Features tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' A chat room is an area where your members can discuss the project with IM (instant messaging). You can have one chat room per project and use the Project Kenai chat client to access it. You can also use your own client, like [http://pidgin.im/about Pidgin] or [http://adium.im Adium], or you can use NetBeans 6.7 and later. See [[IMChat|About Instant Message (IM) Chat]] for more information on using IM chat clients. [[image:manage-chatroom.png]] You can do the following things with chat rooms: * '''Adding a Chat Room'''&mdash;Click ''Add'' next to Project Chat Room and then enter the display name of the chat room. The description is optional.<br/>[[image:manage-add-chatroom.png]] * '''Deleting a Chat Room'''&mdash;Click the ''more'' droplist to the right of the chat room name and choose ''Delete''.<br/>[[image:manage-proj-clickdeletewpermissions.png]] * '''Editing a Chat Room's Settings'''&mdash;Click ''Edit'' to the right of the chat room name and change the chat room's display name or its description.<br/>[[image:manage-proj-clickedit.png]] * '''Viewing Role Permissions'''&mdash;Click the ''more'' droplist to the right of the chat room's name and choose ''Set Role Permissions''.<br/>[[image:manage-proj-clicksetpermissions.png]]<br/> You see a read-only table of checkboxes showing roles and actions those roles can take with the chat room. Basically, anyone can use the chat room, but only administrators can create or delete one. ===</span>ve encountered. [[image:manage-downloads.png]] ... ===Website=== ''This feature is on the Features tab on the Manage page, as described under [[#Opening_the_Manage_Page|Opening the Manage Page]].'' A Website is a set of web pages that you have uploaded to <span style="text-decoration:line-through;color:red">n</span>Website=== ''This feature is on the Features tab on the Manage page, as described under [[#Opening_the_Manage_Page|Opening the Manage Page]].'' A Website is a set of web pages that you have uploaded to <span style="text-decoration:underline;color:green">Proj</span>e<span style="text-decoration:underline;color:green">c</span>et<span style="text-decoration:line-through;color:red">b</span>t<span style="text-decoration:underline;color:green"> K</span>e<span style="text-decoration:line-through;color:red">a</span>n<span style="text-decoration:line-through;color:red">s.org</span>en<span style="text-decoration:underline;color:green">ai</span> to use as your project's public home page. This home page is accessed through a web browser at the URL <tt><nowiki>http://</nowiki>''your-project-name''.<span style="text-decoration:line-through;color:red">n</span><span style="text-decoration:underline;color:green">k</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:underline;color:green">c</span>.o<span style="text-decoration:line-through;color:red">rg</span>o<span style="text-decoration:underline;color:green">m</span></tt>. The site can be a public face for users of your software and can include multimedia, your own CSS, and your designed HTML pages. Content for the site could include software downloads and release information, upcoming plans, marketing information, and so on. Additionally, a Java-based project could host its Javadoc here. <span id="manage-website-image"></span> [[image:manage-website.png]] You can use either a SCM Website Hook or a WebDAV client to upload a set of HTML, CSS, image, and other files for your web site to <tt><nowiki>https://</nowiki><span style="text-decoration:line-through;color:red">n</span><span style="text-decoration:underline;color:green">k</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:underline;color:green">c</span>.o<span style="text-decoration:line-through;color:red">rg</span>o<span style="text-decoration:underline;color:green">m</span>/website/''your-project-name''</tt>. For information on uploading files, see <span style="text-decoration:underline;color:green"> </span>/website/''your-project-name''</tt>. For information on uploading files, see [[UploadWebsiteFiles|Working With Your Project's Website]]. If you don't set this feature, the URL <tt><nowiki>http://</nowiki>''your-project-name''.<span style="text-decoration:line-through;color:red">n</span>[[UploadWebsiteFiles|Working With Your Project's Website]]. If you don't set this feature, the URL <tt><nowiki>http://</nowiki>''your-project-name''.<span style="text-decoration:underline;color:green">k</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:underline;color:green">c</span>.o<span style="text-decoration:line-through;color:red">rg</span>o<span style="text-decoration:underline;color:green">m</span></tt> defaults to your project home page, <tt><nowiki>http://</nowiki><span style="text-decoration:line-through;color:red">n</span><span style="text-decoration:underline;color:green">k</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:underline;color:green">c</span>.o<span style="text-decoration:line-through;color:red">rg</span>o<span style="text-decoration:underline;color:green">m</span>/projects/''your-project-name''</tt>. This web site is completely under your control. <span style="text-decoration:line-through;color:red">B</span><span style="text-decoration:underline;color:green">If </span>y<span style="text-decoration:underline;color:green">ou</span>y <span style="text-decoration:line-through;color:red">d</span> <span style="text-decoration:underline;color:green">s</span>e<span style="text-decoration:line-through;color:red">fau</span>el<span style="text-decoration:underline;color:green">ec</span>lt<span style="text-decoration:line-through;color:red">,</span> the <span style="text-decoration:line-through;color:red">s</span>t the <span style="text-decoration:underline;color:green">"Include Normal Nav</span>i<span style="text-decoration:underline;color:green">ga</span>it<span style="text-decoration:line-through;color:red">e</span>t<span style="text-decoration:underline;color:green">ion?"</span> <span style="text-decoration:line-through;color:red">d</span>o<span style="text-decoration:line-through;color:red">es</span> o<span style="text-decoration:underline;color:green">ption,</span> <span style="text-decoration:underline;color:green">the</span>n<span style="text-decoration:underline;color:green"> y</span>o<span style="text-decoration:underline;color:green">u only need </span>t<span style="text-decoration:underline;color:green">o</span> <span style="text-decoration:underline;color:green">supply t</span>h<span style="text-decoration:underline;color:green">e m</span> not ha<span style="text-decoration:line-through;color:red">v</span>a<span style="text-decoration:underline;color:green">in cont</span>e<span style="text-decoration:underline;color:green">nt,</span>e an<span style="text-decoration:line-through;color:red">y</span> an<span style="text-decoration:underline;color:green">d</span> <span style="text-decoration:underline;color:green">it will be surr</span> o<span style="text-decoration:line-through;color:red">f</span>o<span style="text-decoration:underline;color:green">unded</span> <span style="text-decoration:underline;color:green">by </span>the automatic navigation you see with <span style="text-decoration:underline;color:green">many </span> the automatic navigation you see with pages <span style="text-decoration:line-through;color:red">i</span>pages <span style="text-decoration:underline;color:green">o</span>n <span style="text-decoration:line-through;color:red">ne</span>t<span style="text-decoration:line-through;color:red">bean</span>n t<span style="text-decoration:underline;color:green">hi</span>s<span style="text-decoration:line-through;color:red">.org</span><span style="text-decoration:underline;color:green"> site</span>, like the <span style="text-decoration:line-through;color:red">righ</span><span style="text-decoration:underline;color:green">lef</span>t navbar that links to your project features, the breadcrumbs list, or search<span style="text-decoration:line-through;color:red">,</span><span style="text-decoration:underline;color:green">.</span> <span style="text-decoration:line-through;color:red">and you mus</span><span style="text-decoration:underline;color:green">O</span>t<span style="text-decoration:line-through;color:red"> p</span><span style="text-decoration:underline;color:green">he</span>r<span style="text-decoration:line-through;color:red">ov</span><span style="text-decoration:underline;color:green">w</span>i<span style="text-decoration:line-through;color:red">d</span><span style="text-decoration:underline;color:green">s</span>e<span style="text-decoration:underline;color:green">,</span>e <span style="text-decoration:line-through;color:red">n</span> <span style="text-decoration:underline;color:green">le</span>avi<span style="text-decoration:line-through;color:red">gatio</span>avin<span style="text-decoration:underline;color:green">g</span>n <span style="text-decoration:line-through;color:red">yours</span> <span style="text-decoration:underline;color:green">th</span>e<span style="text-decoration:line-through;color:red">lf.</span> <span style="text-decoration:line-through;color:red">If y</span>o<span style="text-decoration:line-through;color:red">u wan</span>e o<span style="text-decoration:underline;color:green">p</span>t<span style="text-decoration:line-through;color:red"> standard nav</span>i<span style="text-decoration:line-through;color:red">gati</span>on <span style="text-decoration:line-through;color:red">added aro</span>un<span style="text-decoration:line-through;color:red">d your page, </span>check<span style="text-decoration:line-through;color:red"> ''Includ</span>tion unchecke<span style="text-decoration:underline;color:green">d</span>e <span style="text-decoration:line-through;color:red">Norma</span> <span style="text-decoration:underline;color:green">wi</span>l<span style="text-decoration:underline;color:green">l</span>l <span style="text-decoration:line-through;color:red">Nav</span> <span style="text-decoration:underline;color:green">requ</span>i<span style="text-decoration:line-through;color:red">gation?'' wh</span><span style="text-decoration:underline;color:green">r</span>e<span style="text-decoration:line-through;color:red">n</span> you <span style="text-decoration:line-through;color:red">add </span>t<span style="text-decoration:line-through;color:red">he</span>e you t<span style="text-decoration:underline;color:green">o</span> s<span style="text-decoration:line-through;color:red">ite,</span><span style="text-decoration:underline;color:green">upply</span> <span style="text-decoration:line-through;color:red">or </span> you<span style="text-decoration:underline;color:green">r</span>you <span style="text-decoration:line-through;color:red">d</span> o<span style="text-decoration:underline;color:green">wn</span>o <span style="text-decoration:line-through;color:red">th</span> <span style="text-decoration:underline;color:green">l</span>i<span style="text-decoration:underline;color:green">nk</span>is <span style="text-decoration:line-through;color:red">b</span>s <span style="text-decoration:underline;color:green">if </span>y<span style="text-decoration:underline;color:green">ou</span>y <span style="text-decoration:line-through;color:red">editi</span> <span style="text-decoration:underline;color:green">wa</span>n<span style="text-decoration:line-through;color:red">g</span><span style="text-decoration:underline;color:green">t</span> the <span style="text-decoration:underline;color:green">u</span> the s<span style="text-decoration:line-through;color:red">it</span>se<span style="text-decoration:underline;color:green">r</span>e <span style="text-decoration:line-through;color:red">la</span>t<span style="text-decoration:line-through;color:red">er.</span> t<span style="text-decoration:underline;color:green">o</span> <span style="text-decoration:line-through;color:red">S</span><span style="text-decoration:underline;color:green">b</span>e<span style="text-decoration:line-through;color:red">e</span> <span style="text-decoration:line-through;color:red">[[#</span>a<span style="text-decoration:line-through;color:red">ddwe</span>b<span style="text-decoration:line-through;color:red">sit</span>e ab<span style="text-decoration:underline;color:green">l</span>e<span style="text-decoration:line-through;color:red">|Adding</span> <span style="text-decoration:line-through;color:red">a</span>e <span style="text-decoration:underline;color:green">to</span> <span style="text-decoration:line-through;color:red">Webs</span><span style="text-decoration:underline;color:green">nav</span>i<span style="text-decoration:underline;color:green">ga</span>ite<span style="text-decoration:line-through;color:red">]]</span> <span style="text-decoration:line-through;color:red">bel</span>te <span style="text-decoration:underline;color:green">t</span>o<span style="text-decoration:line-through;color:red">w</span><span style="text-decoration:underline;color:green"> your project</span>. '''Note:''' Your project will continue to have a project home page accessible from <span style="text-decoration:line-through;color:red">n</span><span style="text-decoration:underline;color:green">Proj</span>e<span style="text-decoration:underline;color:green">c</span>et<span style="text-decoration:line-through;color:red">b</span>t<span style="text-decoration:underline;color:green"> K</span>e<span style="text-decoration:line-through;color:red">a</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:line-through;color:red">org.</span> The project website does not replace the project home page, making the project website useful as a site for users of your software. The project home page can continue to be used by developers and others who want to participate in the project on <span style="text-decoration:line-through;color:red">n</span>. The project website does not replace the project home page, making the project website useful as a site for users of your software. The project home page can continue to be used by developers and others who want to participate in the project on <span style="text-decoration:underline;color:green">Proj</span>e<span style="text-decoration:underline;color:green">c</span>et<span style="text-decoration:line-through;color:red">b</span>t<span style="text-decoration:underline;color:green"> K</span>e<span style="text-decoration:line-through;color:red">a</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:line-through;color:red">org.</span> If you want to customize the project home page, see the section, [[ManageProject#WikiHomePage|WikiHomePage]]. You can do the following things with this feature:<span style="text-decoration:line-through;color:red"><span id="addwebsite"></span></span> * '''Adding a Website'''&mdash;Click ''Add'' next to Website and then enter a display name and description for the site. <span style="text-decoration:line-through;color:red">You can also add standard navigation around your website by choosing ''Include Normal Navigation?''. </span>The description is optional. <br/> '''Note:''' This option doesn't add the actual web site, but just turns the feature on so that accessing the URL <tt><nowiki>http://</nowiki>''your-project-name''.<span style="text-decoration:line-through;color:red">n</span>. If you want to customize the project home page, see the section, [[ManageProject#WikiHomePage|WikiHomePage]]. You can do the following things with this feature: * '''Adding a Website'''&mdash;Click ''Add'' next to Website and then enter a display name and description for the site. The description is optional. <br/> '''Note:''' This option doesn't add the actual web site, but just turns the feature on so that accessing the URL <tt><nowiki>http://</nowiki>''your-project-name''.<span style="text-decoration:underline;color:green">k</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:underline;color:green">c</span>.o<span style="text-decoration:line-through;color:red">rg</span>o<span style="text-decoration:underline;color:green">m</span></tt> shows the web pages you uploaded<span style="text-decoration:line-through;color:red"> to </span><span style="text-decoration:underline;color:green">.</span><<span style="text-decoration:line-through;color:red">tt</span><span style="text-decoration:underline;color:green">br/</span>><span style="text-decoration:line-through;color:red"><</span><span style="text-decoration:underline;color:green">[[image:ma</span>n<span style="text-decoration:line-through;color:red">o</span><span style="text-decoration:underline;color:green">age-</span>w<span style="text-decoration:underline;color:green">ebs</span>wi<span style="text-decoration:line-through;color:red">k</span>i<span style="text-decoration:underline;color:green">te-add.png]] * '''Include Normal Nav</span><span style="text-decoration:line-through;color:red">></span><span style="text-decoration:underline;color:green">gation?'''&mdas</span>h<span style="text-decoration:underline;color:green">; Selec</span>t<span style="text-decoration:underline;color:green"> </span><span style="text-decoration:underline;color:green">his o</span>p<span style="text-decoration:underline;color:green">tion to </span>https<span style="text-decoration:line-through;color:red">://</</span>s<span style="text-decoration:underline;color:green">urrou</span>n<span style="text-decoration:underline;color:green">d y</span>o<span style="text-decoration:underline;color:green">ur content </span>nowi<span style="text-decoration:line-through;color:red">ki>n</span>wi<span style="text-decoration:underline;color:green">th th</span>e<span style="text-decoration:underline;color:green"> defaul</span>t<span style="text-decoration:underline;color:green"> nav</span>b<span style="text-decoration:underline;color:green">ar, h</span>ea<span style="text-decoration:underline;color:green">der, a</span>etbean<span style="text-decoration:line-through;color:red">s.</span>n<span style="text-decoration:underline;color:green">d f</span>o<span style="text-decoration:underline;color:green">ote</span>r<span style="text-decoration:underline;color:green"> containin</span>org<span style="text-decoration:line-through;color:red">/webs</span>g<span style="text-decoration:underline;color:green"> l</span>i<span style="text-decoration:underline;color:green">nks </span>it<span style="text-decoration:line-through;color:red">e/''</span>t<span style="text-decoration:underline;color:green">o </span>your<span style="text-decoration:line-through;color:red">-</span><span style="text-decoration:underline;color:green"> </span>project<span style="text-decoration:line-through;color:red">-nam</span><span style="text-decoration:underline;color:green"> f</span>e<span style="text-decoration:line-through;color:red">''</</span><span style="text-decoration:underline;color:green">a</span>t<span style="text-decoration:line-through;color:red">t>.<b</span><span style="text-decoration:underline;color:green">u</span>r<span style="text-decoration:line-through;color:red">/>[[imag</span>e<span style="text-decoration:line-through;color:red">:manage-web</span>s<span style="text-decoration:line-through;color:red">ite-add</span>.<span style="text-decoration:line-through;color:red">png]]</span> * '''Deleting a Website'''&mdash;Click the ''more'' droplist to the right of the ''website'' name and choose <span style="text-decoration:line-through;color:red"> ''</span>Delete<span style="text-decoration:line-through;color:red">''</span>.<span style="text-decoration:line-through;color:red"><b</span>res. * '''Deleting a Website'''&mdash;Click the ''more'' droplist to the right of the ''website'' name and choose Delete.<span style="text-decoration:underline;color:green"> (See figu</span>r<span style="text-decoration:line-through;color:red">/></span><span style="text-decoration:underline;color:green">e </span>[[<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">#</span>ma<span style="text-decoration:line-through;color:red">ge:ma</span>nage-<span style="text-decoration:line-through;color:red">proj-clickdelete</span>w<span style="text-decoration:line-through;color:red">p</span>e<span style="text-decoration:line-through;color:red">rmi</span>manage-we<span style="text-decoration:underline;color:green">b</span>s<span style="text-decoration:line-through;color:red">s</span>i<span style="text-decoration:line-through;color:red">ons.pn</span>si<span style="text-decoration:underline;color:green">te-ima</span>g<span style="text-decoration:underline;color:green">e|above</span>]]<span style="text-decoration:underline;color:green">.)</span>g]]<br/> '''Note:''' Choosing Delete doesn't delete the files you uploaded. It just turns the feature off so that users no longer see your web site. * '''Editing a Website's Display Name and Description'''&mdash;Click ''Edit'' to the right of the ''website'' name and change the Website's display name<span style="text-decoration:line-through;color:red">,</span><br/> '''Note:''' Choosing Delete doesn't delete the files you uploaded. It just turns the feature off so that users no longer see your web site. * '''Editing a Website's Display Name and Description'''&mdash;Click ''Edit'' to the right of the ''website'' name and change the Website's display name <span style="text-decoration:underline;color:green">or </span> description<span style="text-decoration:line-through;color:red">, or navigation</span>description. (See <span style="text-decoration:underline;color:green">figure</span> [[#<span style="text-decoration:underline;color:green">m</span>. (See [[#a<span style="text-decoration:line-through;color:red">dd</span>a<span style="text-decoration:underline;color:green">nage-</span>website<span style="text-decoration:line-through;color:red">|Add</span><span style="text-decoration:underline;color:green">-</span>i<span style="text-decoration:line-through;color:red">ng </span><span style="text-decoration:underline;color:green">m</span>a<span style="text-decoration:line-through;color:red"> W</span><span style="text-decoration:underline;color:green">g</span>e<span style="text-decoration:line-through;color:red">bsite]] </span><span style="text-decoration:underline;color:green">|</span>above<span style="text-decoration:underline;color:green">]]</span>above.) * '''Setting Role Permissions'''&mdash;Click the ''more'' droplist to the right of the ''website'' name and choose ''Set Role Permissions''.<span style="text-decoration:line-through;color:red"><b</span>.) * '''Setting Role Permissions'''&mdash;Click the ''more'' droplist to the right of the ''website'' name and choose ''Set Role Permissions''.<span style="text-decoration:underline;color:green"> (See figu</span>r<span style="text-decoration:line-through;color:red">/></span><span style="text-decoration:underline;color:green">e</span> [[<span style="text-decoration:line-through;color:red">i</span><span style="text-decoration:underline;color:green">#</span>ma<span style="text-decoration:line-through;color:red">ge:ma</span>nage-<span style="text-decoration:line-through;color:red">proj-clicks</span>manage-<span style="text-decoration:underline;color:green">w</span>e<span style="text-decoration:underline;color:green">bsi</span>et<span style="text-decoration:line-through;color:red">p</span>e<span style="text-decoration:line-through;color:red">rm</span>te<span style="text-decoration:underline;color:green">-</span>i<span style="text-decoration:line-through;color:red">ssions.pn</span><span style="text-decoration:underline;color:green">ma</span>g<span style="text-decoration:underline;color:green">e|above</span>g]]<span style="text-decoration:line-through;color:red"><br/></span>]]<span style="text-decoration:underline;color:green">.)</span> You see a table of checkboxes showing roles and actions those roles can take with the <span style="text-decoration:line-through;color:red">pr</span><span style="text-decoration:underline;color:green">d</span>o<span style="text-decoration:line-through;color:red">ject</span><span style="text-decoration:underline;color:green">wnload</span> <span style="text-decoration:line-through;color:red">W</span><span style="text-decoration:underline;color:green">ar</span>e<span style="text-decoration:line-through;color:red">bsite</span><span style="text-decoration:underline;color:green">a</span>. The tasks you can set for the various roles are simple: ''View Website'' and ''Update Website''.<br/><br/>By default, anyone can see your web site, but only project administrators, software developers, and content developers can add or delete files.<br/><br/> For information on the roles in this table, see the [[ManageProject#roledefs|role definitions]] table in ''Managing a Project''. <span id="WikiHomePage"></span> ===WikiHomePage=== ... ===WikiHomePage=== ''This feature is on the Features tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' A Wiki Home Page is a way to provide a customized project home page for your project. You [[Wikis#Editing_a_Wiki_Page|edit your project's wiki Home page]] to add the content about your project that you want people to see on th<span style="text-decoration:underline;color:green">e Project Kena</span>. The tasks you can set for the various roles are simple: ''View Website'' and ''Update Website''.<br/><br/>By default, anyone can see your web site, but only project administrators, software developers, and content developers can add or delete files.<br/><br/> For information on the roles in this table, see the [[ManageProject#roledefs|role definitions]] table in ''Managing a Project''. <span id="WikiHomePage"></span> ===WikiHomePage=== ... ===WikiHomePage=== ''This feature is on the Features tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>.'' A Wiki Home Page is a way to provide a customized project home page for your project. You [[Wikis#Editing_a_Wiki_Page|edit your project's wiki Home page]] to add the content about your project that you want people to see on thi<span style="text-decoration:line-through;color:red">s</span> site. After you set this feature, project administrators continue to see the default home page. For all other users who are permitted to see your wiki pages, this page replaces the default project home page. To control who sees your wiki pages, see ''Setting Role Permission'' above under [[#Wiki|Wiki]]. '''Note:''' You can have both a wiki home page and a [[#Website|project website]]. The wiki home page replaces your project home page and is for use by developers and other <span style="text-decoration:line-through;color:red">n</span>i site. After you set this feature, project administrators continue to see the default home page. For all other users who are permitted to see your wiki pages, this page replaces the default project home page. To control who sees your wiki pages, see ''Setting Role Permission'' above under [[#Wiki|Wiki]]. '''Note:''' You can have both a wiki home page and a [[#Website|project website]]. The wiki home page replaces your project home page and is for use by developers and other <span style="text-decoration:underline;color:green">Proj</span>e<span style="text-decoration:underline;color:green">c</span>et<span style="text-decoration:line-through;color:red">b</span>t<span style="text-decoration:underline;color:green"> K</span>e<span style="text-decoration:line-through;color:red">a</span>n<span style="text-decoration:line-through;color:red">s.org</span>en<span style="text-decoration:underline;color:green">ai</span> members who want to participate in or learn about your project. The project website is available externally to a wider audience and can be used to provide information to the users of your software, such as information on the latest releases, plans for upcoming releases, marketing information, and so on. <span id="manage-wikihomepage-image"></span> [[image:manage-wikihomepage.png]] <span style="text-decoration:underline;color:green">For example, here's how the default project home page for the Bluebird project looks: [[image: project-homepage-default.png]] And here's the new project home page in the Bluebird wiki: [[image: project-homepage-wiki.png]] As you can see, with the customized wiki home page, all the project navigation is still available in the left navigation bar, and you provide the look you want for your project page. </span> members who want to participate in or learn about your project. The project website is available externally to a wider audience and can be used to provide information to the users of your software, such as information on the latest releases, plans for upcoming releases, marketing information, and so on. <span id="manage-wikihomepage-image"></span> [[image:manage-wikihomepage.png]] ... [[image:manage-wikihomepage.png]] You can do the following things with this feature: * '''Adding a WikiHomePage'''&mdash;Click ''Add'' next to WikiHomePage and then enter a description for the page. The description is optional.<br/>'''Note:''' <span style="text-decoration:line-through;color:red">''</span>Add<span style="text-decoration:line-through;color:red">''</span> doesn't add a page, but simply changes your project home page from the default home page to your wiki Home page.<br/>[[image:manage-add-wikihomepage.png]]<br/><br/> * '''Deleting a WikiHomePage'''&mdash;Click the ''more'' droplist to the right of the ''wikihome'' name and choose ''Delete''.<br/>[[image:manage-proj-clickdeleteonly.png]]<br/><br/>'''Note:''' Delete doesn't delete a page, but simply changes your project home page back to the default home page.<br/><br/> * '''Editing a WikiHomePage's Description'''&mdash;Click ''Edit'' to the right of the ''wikihome'' name and change the WikiHomePage's description.<br/>[[image:manage-proj-clickedit.png]] ... ''This feature is on the Emails tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>. '' This tab enables you to customize the email that gets sent when you add a new member in the [[#Members_Tab|Members tab]]. You can edit any of the fields, and you can use a set of predefined template variables in the email, such as <<span style="text-decoration:line-through;color:red">tt><</span>nowiki>{{project_display_name}}</nowiki><span style="text-decoration:line-through;color:red"></tt></span>, which cause text to be inserted when the email is sent. The template variables are listed at the bottom of the page with some of the default values filled in. Here's what they would be for the <span style="text-decoration:line-through;color:red">He</span>You can do the following things with this feature: * '''Adding a WikiHomePage'''&mdash;Click ''Add'' next to WikiHomePage and then enter a description for the page. The description is optional.<br/>'''Note:''' Add doesn't add a page, but simply changes your project home page from the default home page to your wiki Home page.<br/>[[image:manage-add-wikihomepage.png]]<br/><br/> * '''Deleting a WikiHomePage'''&mdash;Click the ''more'' droplist to the right of the ''wikihome'' name and choose ''Delete''.<br/>[[image:manage-proj-clickdeleteonly.png]]<br/><br/>'''Note:''' Delete doesn't delete a page, but simply changes your project home page back to the default home page.<br/><br/> * '''Editing a WikiHomePage's Description'''&mdash;Click ''Edit'' to the right of the ''wikihome'' name and change the WikiHomePage's description.<br/>[[image:manage-proj-clickedit.png]] ... This tab enables you to customize the email that gets sent when you add a new member in the [[#Members_Tab|Members tab]]. You can edit any of the fields, and you can use a set of predefined template variables in the email, such as <nowiki>{{project_display_name}}</nowiki>, which cause text to be inserted when the email is sent. The template variables are listed at the bottom of the page with some of the default values filled in. Here's what they would be for the <span style="text-decoration:underline;color:green">B</span>l<span style="text-decoration:line-through;color:red">p for n</span><span style="text-decoration:underline;color:green">u</span>e<span style="text-decoration:line-through;color:red">t</span>b<span style="text-decoration:line-through;color:red">eans.o</span>eb<span style="text-decoration:underline;color:green">i</span>r<span style="text-decoration:line-through;color:red">g</span><span style="text-decoration:underline;color:green">d</span> <span style="text-decoration:line-through;color:red">Sit</span><span style="text-decoration:underline;color:green">proj</span>e<span style="text-decoration:underline;color:green">ct: *</span>e <span style="text-decoration:line-through;color:red">T</span> <span style="text-decoration:underline;color:green">'''h</span>o<span style="text-decoration:line-through;color:red">ol</span>os<span style="text-decoration:underline;color:green">t:'''</span> <span style="text-decoration:underline;color:green"> &nbs</span>s p<span style="text-decoration:line-through;color:red">roj</span>p<span style="text-decoration:underline;color:green">;<tt> K</span>e<span style="text-decoration:underline;color:green">nai.</span>c<span style="text-decoration:underline;color:green">om</</span>ect<span style="text-decoration:line-through;color:red">:</span>t<span style="text-decoration:underline;color:green">t></span> * '''project_display_name:''' &nbsp;<tt> <span style="text-decoration:line-through;color:red">He</span><span style="text-decoration:underline;color:green">B</span>l<span style="text-decoration:line-through;color:red">p for n</span><span style="text-decoration:underline;color:green">u</span>e<span style="text-decoration:line-through;color:red">t</span>b<span style="text-decoration:line-through;color:red">eans.org S</span>i<span style="text-decoration:line-through;color:red">te Tools</span>ebi<span style="text-decoration:underline;color:green">rd</span></tt> * '''project_url:''' <tt> &nbsp;<nowiki>http://<span style="text-decoration:line-through;color:red">n</span><span style="text-decoration:underline;color:green">k</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:underline;color:green">c</span>.o<span style="text-decoration:line-through;color:red">rg</span>o<span style="text-decoration:underline;color:green">m</span>/projects/<span style="text-decoration:line-through;color:red">he</span><span style="text-decoration:underline;color:green">b</span>l<span style="text-decoration:line-through;color:red">p</span><span style="text-decoration:underline;color:green">uebird</span></nowiki></tt> * '''role_display_name:''' &nbsp;''the member's new role on the project<span style="text-decoration:line-through;color:red">:</span><span style="text-decoration:underline;color:green">'' *</span> <span style="text-decoration:line-through;color:red">Adm</span><span style="text-decoration:underline;color:green">'''s</span>i<span style="text-decoration:underline;color:green">g</span>in<span style="text-decoration:line-through;color:red">istr</span>at<span style="text-decoration:line-through;color:red">o</span>nat<span style="text-decoration:underline;color:green">u</span>r<span style="text-decoration:line-through;color:red">,</span><span style="text-decoration:underline;color:green">e:'''</span> <span style="text-decoration:line-through;color:red">Sof</span><span style="text-decoration:underline;color:green">&nbsp;<</span>t<span style="text-decoration:line-through;color:red">ware</span><span style="text-decoration:underline;color:green">t></span> <span style="text-decoration:line-through;color:red">D</span><span style="text-decoration:underline;color:green">Th</span>e<span style="text-decoration:line-through;color:red">veloper,</span> <span style="text-decoration:line-through;color:red">C</span>e <span style="text-decoration:underline;color:green">Pr</span>o<span style="text-decoration:line-through;color:red">nt</span><span style="text-decoration:underline;color:green">j</span>e<span style="text-decoration:line-through;color:red">n</span><span style="text-decoration:underline;color:green">c</span>t <span style="text-decoration:line-through;color:red">D</span><span style="text-decoration:underline;color:green">K</span>e<span style="text-decoration:line-through;color:red">veloper,</span><span style="text-decoration:underline;color:green">nai</span> <span style="text-decoration:line-through;color:red">or Obs</span><span style="text-decoration:underline;color:green">T</span>e<span style="text-decoration:line-through;color:red">rver''</span><span style="text-decoration:underline;color:green">am</tt></span> * '''wiki_home_url:''' <span style="text-decoration:line-through;color:red"> <tt></span> * '''wiki_home_url:''' &nbsp;<<span style="text-decoration:underline;color:green">tt> <</span>&nbsp;<nowiki>http://<span style="text-decoration:line-through;color:red">n</span>nowiki>http://<span style="text-decoration:underline;color:green">k</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:underline;color:green">c</span>.o<span style="text-decoration:line-through;color:red">rg</span>o<span style="text-decoration:underline;color:green">m</span>/projects/<span style="text-decoration:line-through;color:red">he</span><span style="text-decoration:underline;color:green">b</span>l<span style="text-decoration:line-through;color:red">p</span><span style="text-decoration:underline;color:green">uebird</span>/pages/Home</nowiki></tt> <span id="WebHooks"></span> ==Web Hooks Tab== ... ''This feature is on the Web Hooks tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>. '' This tab enables you to set a URL, a callback to a page that can accept web hook data from your <span style="text-decoration:underline;color:green">Project Kenai </span>/pages/Home</nowiki></tt> <span id="WebHooks"></span> ==Web Hooks Tab== ... ''This feature is on the Web Hooks tab on the Manage page, as described above under <a href="#Opening_the_Manage_Page">Opening the Manage Page</a>. '' This tab enables you to set a URL, a callback to a page that can accept web hook data from your project. Web hooks provide a way for you to handle data resulting from changes in your <span style="text-decoration:line-through;color:red">n</span>project. Web hooks provide a way for you to handle data resulting from changes in your <span style="text-decoration:underline;color:green">K</span>e<span style="text-decoration:line-through;color:red">tbea</span>n<span style="text-decoration:line-through;color:red">s.org</span>en<span style="text-decoration:underline;color:green">ai</span> projects on a web page of your choosing (as opposed to using something like an RSS feed). In this tab, you provide the URL of the web page that has code to interpret and handle the JSON data sent by <span style="text-decoration:line-through;color:red">n</span><span style="text-decoration:underline;color:green">Proj</span>e<span style="text-decoration:underline;color:green">c</span>et<span style="text-decoration:line-through;color:red">b</span>t<span style="text-decoration:underline;color:green"> K</span>e<span style="text-decoration:line-through;color:red">a</span>n<span style="text-decoration:line-through;color:red">s</span>en<span style="text-decoration:underline;color:green">ai</span>.<span style="text-decoration:line-through;color:red">org.</span>. In addition, you need to click the checkbox next to the features you want to track. At present, there is one feature you can track, source code repository updates. '''Note:''' A web hook is automatically disabled after 10 failed connection attempts. After a web hook is disabled, you must change the URL to re-enable the web hook. For general information on working with web hooks, see [[WebHooks|About Web Hook<span style="text-decoration:underline;color:green">s]]. <span id="Analytics"></span> ==Analytics Tab== [[image:manage-proj-analyticstab.png]] This tab enables you to add the tracking code from a profile you have set up on Google Analytics so your project's web page statistics can be gathered by Google. Click Add Analytic, add the tracking code code to that field, and click Add. Within 24 hours you will have data on your project in your Google account. For more information, see [[AboutAnalytics|Using Analytics With Your Project</span>s]]. <table> <tr><span>

Project Features

Wiki Controls

About this Project

Help for netbeans.org Site Tools was started in November 2009, is owned by kenaiadmin, and has 17 members.
By use of this website, you agree to the NetBeans Policies and Terms of Use (revision 20131025.e7cbc9d). © 2013, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo
 
 
Close
loading
Please Confirm
Close