Create and join projects

This page provides information relative to projects in Gforge @, more precisely about:

Project Visibility

A private project is a project that only exists for those who know that it has been created and that can only be seen by the people that are registered as members of this project. All members of a project have access to the source control Manager (SCM) and to the webspace of the project.

A public project appears in the list of project hosted on the forge. Anybody can find it using the search function, the project tree or a search engine and can browse all public items of the project. But a public project does not necessarily mean that all items of the project are public. The visibility of each item can be controlled item by item. For example, you could have a public tracker for bugs, a private tracker for security problems, and anonymous access to the source. The visibility of each item is controlled by the admin link that is accessible to the project's admins on the page showing the item. In all cases, only registered members of the project can change the web pages of the project or its source code.

Creating a project

Once you have an account on Gforge @ (see Get an account), you can create projects, either private or public. You might want to create a private project if you want to control the list of users who have read or write access to the information stored in that project. If you just want to join an existing project, see the section Joining a project.

To create a project, simply go to your personal page: Of course, to do this, you need to be logged in the website so you might need to enter your username and password to get access to this webpage. On this webpage, click on the "Register Project" link which is located in the left to middle part of the screen, right below the "My Page" tab. Fill in the fields. I advise you to put the same (short) sentence in the fields "Project Purpose And Summarization" and "Project Public Description".

You can also choose the SCM repository type (SVN or GIT), and eventually the project template (keep the default if you want to start with some useful default settings, or deselect it if you want to start from an empty project).

Once the fields are filled, hit the "Submit" button. Your project has now been submitted to the Gforge @ admins. To be approved, the project and its use must obey the terms of usages.

When the project is approved, you will receive numerous confirmation emails that will contain important information regarding your access to the various services hosted by the server. Do not delete them!

Project visibility

By default, your new project is private and not visible to the non-members. It can be changed in the project administration page, in the section "users and permissions", edit the global roles "Anonymous/not logged in" and "Any user logged in" and adapt the permission as needed.

Project roles

Joining a project

To join a project, you need to:

  • create an account (see Get an account);
  • mail the project administrator(s) to add you as a member of the project. In particular, do not send these requests to the Gforge @ administration team.
  • if you are going to actively participate, you should also configure your ssh access (see Setup SSH).

The project administrator(s) can add members in the project administration page, in the section "users and permissions".

Project users