CVS->Git

  On June 1, 2021, the main repository for STAR offline software has migrated from CVS to GitHub (https://github.com/star-bnl). Currently there are two main repositories on github:
star-sw:   most offline software codes
star-mcgen:   MC generators for starsim
The maintainer and developer for STAR project on GitHub is Dmitri Smirnov.

For developers, a GitHub account is required for work with the new repositories. After registered in GitHub, please email Dmitri Smirnov and request to join STAR project.

The workflow for modifying or creating software codes is following the common procedure as other projects on GitHub.

  1. Fork the repo. Create a "copy" of the central repository under your account
  2. Clone your fork. Create a local "copy" of the repository on your machine:   $git clone git@github.com:<account>/star-sw.git
  3. Make changes locally. Create clean commits with informative log messages by using the full power of Git tools
  4. Push to your fork. Send the changes to your fork hosted on GitHub:   $git push
  5. Create a pull request (PR). So others know that you want to merge your changes into the central repository

For modifications to existing codes, in most cases, the PR review will be sent to the reviewers automatically. For new codes additions, please notify Xin Dong and Dmitri Smirnov about the PR. We will follow the standard STAR code review policy and assign reviewers.

By default, the PR needs two approvals from reviewers and needs to pass the CI built tests, then we can merge the PR into the star-sw main branch.

For any questions or requests, please contact Xin Dong or Dmitri Smirnov.

Presentations and documents about STAR on Github:

1. Mar. 2021 Collaboration Meeting, slides from Dmitri Smirnov.
2. Feb.  2022 Collaboration Meeting, slides from Dmitri Smirnov.