How to contribute - AtChem/AtChem2 Wiki
The best way to contribute to the development of AtChem2 is to use git. Coding guidelines can be found in the AtChem2 manual (in the
doc/ directory) and Python scripts to check the formatting and the style of the code are available in the
tools/ directory. A working knowledge of git is required.
The procedure to submit contributions with git is as follows:
Fork the main repository (
AtChem/AtChem2) to a local repository (
Configure git so that
originis the forked repository (
upstreamis the main repository (
AtChem/AtChem2). The output of
git remote -vshould look like this:
origin [email protected]:username/AtChem2.git (fetch) origin [email protected]:username/AtChem2.git (push) upstream [email protected]:AtChem/AtChem2.git (fetch) upstream [email protected]:AtChem/AtChem2.git (push)
Create a new branch in the forked repository. Make the necessary edits on the branch, commit and push. Before committing, it is recommended to run the Test Suite locally by executing the command
make tests, if FRUIT is not [installed](/AtChem/AtChem2/wiki/How to install AtChem2)); this verifies that the proposed changes will not cause problems and also checks the style and indentation of the code.
Submit a pull request, together with a brief description of the proposed changes. One of the admins will review the pull request and approve it or ask for additional modifications, as appropriate.
Contributions can also be submitted via email or via the Issues page.