Main Devlopment Workflow

Committing Guidelines

The main repository is public and serves as the central source for JOREK.
Developers will create forks of the main repository for their individual development work.
Collaborators can be added to forks to enable team-based development on specific features or bug fixes.
Developments in the forks need to be merged back into the main repository as soon as possible.

Create a github account
- If you do not have one already, setup a github account and make sure your username contains your last name and initial.
Fork the Main Repository:
- If you don't have a fork already, create a new one under your user account.
- Navigate to the main repository on GitHub.
- Click the "Fork" button to create a personal copy of the repository under your GitHub account.
- Add collaborators to your fork if you are working closely with someone else.

Clone Your Fork:

Clone your fork to your local machine:

git clone https://github.com/<your-username>/<repository-name>.git
cd <repository-name>

Set Up the Main Repository as an Upstream Remote:
- Add the main repository as an upstream remote to keep your fork in sync:
```
git remote add upstream https://github.com/iterorganization/JOREK.git
```
Sync Your Fork with the Main Repository:
- Regularly fetch and merge changes from the main repository:
```
git fetch upstream
git merge upstream/develop
```

Develop Features or Fix Bugs:
- Create a new branch for each feature or bug fix:
```
git checkout -b <feature|bugfix>/branch-name
```
- Commit your changes to the branch:
```
git add .
git commit -m "Description of changes"
```
Push Changes to Your Fork:
- Push your branch to your fork:
```
git push origin <feature-or-bugfix-branch>
```
Create a Pull Request:
- Open a pull request (PR) from your fork's branch to the main repository's develop branch.
  - From the main page of your fork's repository a button with "Contribute" will appear
  - Click on the button and then "Open Pull Request"
  - Fill out the Pull Request Form describing the Pull Request in a way that is understandable to the whole community
- Resolve potential merge conflicts and verify the automatic regression tests are passing.
- Ensure the PR is reviewed and approved before merging by at least two people.

Merge changes from the main repository into your fork frequently to avoid large merge conflicts. This is especially important for long developments
Keep feature and bug fix branches small and focused.
Ensure all changes are reviewed (by at leat 2 people) before merging into the main repository.
Make sure to create new regression tests for your developments.
Bug fixes should be developed independently of feature development.
Merge bug fixes from the main repository into your fork as soon as they are available:
```
git fetch upstream
git merge upstream/develop
```

Use the GitHub Issue Tracker to bring up important bugfixes and discussions on new developments or to make a feature request.

Creating Issues:
- Provide a clear and concise title and description.
- Include relevant details such as steps to reproduce a bug, expected behavior, or the motivation for a new feature.
- Mention specific users with @username to make them aware of the issue.
- Use appropriate labels (e.g., bug, enhancement, discussion) to categorize issues.
Linking Pull Requests:
- Reference issues in pull requests using keywords like Fixes #<issue-number> to automatically close the issue when the PR is merged.
- Ensure the issue is resolved and all discussions are addressed before closing.
- More infos here about linking an issue to a PR

During the migration to GitHub, the history of commit hashes will change. Follow these steps to ensure a smooth transition:

Push Your Branches Before Migration (end of July):
- Before the migration, push all your local branches to the current repository:
```
git push origin <branch-name>
```
Retrieve Your Branch After Migration:
- After the migration, contact jorek-devel@jorek.eu to retrieve your new branch from the private GitHub repository where old branches are saved during the migration period, please include your GitHub username in the email.

Set Up Your Fork with the Old Branch:

Clone your fork of the new main repository:

git clone https://github.com/<your-username>/<repository-name>.git
cd <repository-name>

Add the private repository (containing old branches) as a remote:

git remote add old-repo https://github.com/<private-repo-owner>/<private-repo-name>.git

Fetch your old branch:
```
git fetch old-repo <branch-name>
```
Create a new branch in your fork based on the old branch:
```
git checkout -b <branch-name> old-repo/<branch-name>
```
Push the branch to your fork:
```
git push origin <branch-name>
```