Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Creating an Account

You can create an account for yourself by registering on the confluence page. At this point you will have basic access rights, you can add bug reports to most projects, clone repositories. Once you have an account you can use that to contact the admins of a project you are interested in joining on the project page (https://opensource.ncsa.illinois.edu/projects).

Project Pages

All projects hosts on this server are listed on the project page (https://opensource.ncsa.illinois.edu/). You can there select a single project and get more information about that project. You can also go directly to that page, for example to get to the Brown Dog page (key is BD) you can go to https://opensource.ncsa.illinois.edu/projects/BD. Each project will have a unique page that can be reached using the project key.

The Projects pull down shows all of the projects hosted at this server. The Demo menu will give you quick access to any of the demo sites for each project. Services will show you all the services provided by NCSA Open Source, the About menu entry will show you information about what version each of the services is. The last entry in the menu, either allows you

...

to login, or if you are logged in shows a link to crowd (where you can modify your personal information, such as name email and password) and a link that only shows those projects you are involved in.
Each project page will show you a short description of the project, status of the project and the people involved in the project.
There are 4 categories that people can be assigned to for each project:
  • admin : allows you to modify project information in project page, JIRA, Confluence and stash.
  • developers : allows to check in code in Stash, can be assigned tasks in JIRA and edit pages in Confluence.
  • contributors : can be assigned tasks in JIRA and edit pages in Confluence.
  • alumni : people that have worked on this project in the past, no special privileges.
A project can be in one of the following three states:
  • active : the project is actively maintained. New features are constantly added, and bugs are fixed.
  • supported : the project is no longer actively maintained, no new features, but bugs will be fixed.
  • archived : the project and its information will always be around, no new features or bug fixes.
On the right you will see a bunch of links, not all of these links will
appear for each project:
  • external webpage : a link to a webpage describing the project outside of NCSA Open Source
  • demo site : a link to an external site hosting a demo of the software (also shown in the Demo menu)
  • manual page : manual pages copied from the source (send email to opensource@ncsa.illinois.edu for information no how to set this up)
  • API pages : JavaDoc pages copied from the source (send email to opensource@ncsa.illinois.edu for information no how to set this up)
  • Confluence/JIRA/Stash/Bamboo/FishEye : links to project space in each of the services
  • Contact Admin : Allows any signed in user to send an email to admins of a project.
  • Downloads : any downloads available (send email to opensource@ncsa.illinois.edu for information no how to set this up)
For those people that are admins of the project you will also see an edit button, you can use this to add and remove people from the project, and change any of the information shown on the project page. Don¹t add/remove the links to Confluence/JIRA/Stash/Bamboo/FishEye as those require special setup to enable them. Any of the changes to the project page should be reflected immediately. Adding or remove people from the groups can take up to 30 minutes to be reflected in the separate services.
In confluence you can use the groups of people to limit access to specific pages. For example you might want to have some internal pages where you discuss new features. You can limit access to those pages using the groups <KEY>-admin, <KEY>-dev, <KEY>, <KEY>-alumni, where <KEY> is replaced by your project KEY (for example BD for BrownDog). Each project should have these four groups that they can use.
The source code for the project pages can be found at https://opensource.ncsa.illinois.edu/stash/projects/ISDA/repos/opensource-projects, please feel free to make suggestions for improvements of new features you would like to see added to the project pages.