New contributions to PeleLMeX are welcome !
The PeleLMeX contributions workflow follows these steps:
- Fork the main repository
- Create an
AmazingNewFeature
branch implementing your changes - Open a Pull Request (PR) from
AmazingNewFeature
on your fork to branchdevelopment
of the main PeleLMeX repository
Follow GitHub directions
to fork PeleLMeX main repo on your GitHub account, and use a recursive git clone
to get your fork of PeleLMeX and its dependencies.
Then step into the PeleLMeX folder and add the main PeleLMeX repository as the upstream
remote in order to keep track of the main repo :
git add remote upstream https://github.com/AMReX-Combustion/PeleLMeX
At any point, you can update the developement
branch of your local repository with changes implemented in the main PeleLMeX repo by pulling from upstream
:
git checkout development
git pull upstream development
We recommend setting your development branch to track the upstream one instead of your fork:
git branch -u upstream/development
You are now free to modify your own fork of PeleLMeX. To add a new feature to PeleLMeX, the procedure is:
-
Create a branch for the new feature from the
development
branch (locally) :git checkout development git checkout -b AmazingNewFeature
-
and commit your changes to your local repo :
git commit -m "Developed AmazingNewFeature"
-
Alongside your development, regularly merge changes from the main repo
development
branch into yourAmazingNewFeature
branch, fix any conficts, and push your changes to your GitHub fork :git push -u origin AmazingNewFeature
-
When you are ready to propose your new feature/improvement/bug fix to the main PeleLMeX repo, reiterate Step 3 and submit a PR through the GitHub page from your fork onto the
development
branch of the main repo:
- Click on the
compare & pull request
button to start your PR. - Provide a title and a short description for your PR:
- what feature/fix do you propose
- how did you test it
- any other information deemed useful : does it modify the default PeleLM behavior ? ...
- Press
Create pull request
.
Please DO NOT write large PR, as they are very difficult and time-consuming to review. As much as possible, split them into small targeted PRs. For example, if find typos in the documentation open a pull request that only fixes typos. If you want to fix a bug, make a small pull request that only fixes a bug.
As much as possible, PeleLMeX
adhere to AMReX Coding Style
and we are encouraging contributors to follow those guidelines.