Introduction to XGC's Git Workflow ================================== The XGC codes are organized in three separate, private repositories on `Github `_ under the `PrincetonUniversity `_ organization (abbreviated PU in the remainder of this document): - `PrincetonUniversity/XGC-Devel `_: The current, actively developed versions of the XGC code (XGC1, XGCa, XGCs). All XGC developers use this repository as basis for their work. - `PrincetonUniversity/XGC-User `_: A read-only (except for repo admins) repository with regularly updated releases of XGC-Devel. All code in XGC-User is stable and safe for use by inexperienced XGC users. This repo is intended for pure XGC users (who do not develop code) and new XGC developers for the purpose of training. - `PrincetonUniversity/XGC-Full-f `_: Legacy code that has been developed in past SciDAC funding periods (e.g. XGC0, the full-f version of XGC1). This legacy code will undergo only modest development and maintenance work. Members of XGC-Users have access to the XGC-User repository, and members of XGC-Full-f Users have access to the XGC-Full-f repository. The teams XGC Developers and XGC Admins are subgroups of the XGC-Users team. Members of XGC Developers have read-access to the XGC-Devel repository, and members of XGC Admins have administrator privileges on all three XGC repositories. .. image:: ./img/XGC_repo_workflow.png :target: ./_images/XGC_repo_workflow.png :alt: Repository Structure Organization of and workflow for the XGC repositories ----------------------------------------------------- Generic resources: - `A nice comprehensive description of Git workflows `_ - Stackexchange - Ask Robert Hager (`rhager@pppl.gov `_), Seung-Hoe Ku (`sku@pppl.gov `_), Aaron Scheinberg (`aaron@jubileedev.com `_), Brad King (`brad.king@kitware.com `_) or Zack Galbreath (`zack.galbreath@kitware.com `_) for help. .. toctree:: :maxdepth: 3 git_xgc-user git_xgc-devel_summary