Skip to content

Commit

Permalink
numbering
Browse files Browse the repository at this point in the history
  • Loading branch information
woodthom2 committed Mar 3, 2024
1 parent 64ec163 commit 8cef4d5
Showing 1 changed file with 16 additions and 8 deletions.
24 changes: 16 additions & 8 deletions content/en/blog/developer-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,14 @@ The preferred workflow for contributing to Harmony’s repository is to fork the

Please read our general guide about [contributing to Harmony](/contributing-to-harmony/).

We have three main repositories on Github under the `harmonydata` organisation:

* Harmony Python library: https://github.com/harmonydata/harmony - this is everything to do with the NLP logic of Harmony
* Harmony API: https://github.com/harmonydata/harmonyapi
* Harmony front end: https://github.com/harmonydata - this is everything to do with the front end and graphical interface of Harmony

This contributor guide focuses on the Python library, but you could follow the same steps for the other repositories.

1. Fork the [main project repository](https://github.com/harmonydata/harmony) by clicking on the ‘Fork’ button near the top right of the page. This creates a copy of the code under your GitHub user account. For more details on how to fork a repository see [this guide](https://help.github.com/articles/fork-a-repo/).
2. [Clone](https://docs.github.com/en/github/creating-cloning-and-archiving-repositories/cloning-a-repository) your fork of the Harmony repo from your GitHub account to your local disk:

Expand All @@ -21,15 +29,15 @@ git clone [email protected]:harmonydata/harmony.git
cd harmony
```

1. Configure and link the remote for your fork to the upstream repository:
3. Configure and link the remote for your fork to the upstream repository:

```
git remote -v
git remote add upstream <https://github.com/harmonydata/harmony.git>
```

1. Verify the new upstream repository you’ve specified for your fork:
4. Verify the new upstream repository you’ve specified for your fork:

```
git remote -v
Expand All @@ -43,7 +51,7 @@ git remote -v
\> upstream <https://github.com/harmonydata/harmony.git> (push)
```

1. [Sync](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/syncing-a-fork) the main branch of your fork with the upstream repository:
5. [Sync](https://docs.github.com/en/github/collaborating-with-issues-and-pull-requests/syncing-a-fork) the main branch of your fork with the upstream repository:

```
git fetch upstream
Expand All @@ -53,7 +61,7 @@ git checkout main
git merge upstream/main
```

1. Create a new feature branch from the main branch to hold your changes:
6. Create a new feature branch from the main branch to hold your changes:

```
git checkout main
Expand All @@ -63,27 +71,27 @@ git checkout -b <feature-branch>

Always use a feature branch. It’s good practice to never work on the main branch! Name the feature branch after your contribution.

1. Develop your contribution on your feature branch. Add changed files using git add and then git commit files to record your changes in Git:
7. Develop your contribution on your feature branch. Add changed files using git add and then git commit files to record your changes in Git:

```
git add <modified_files>
git commit
```

1. When finished, push the changes to your GitHub account with:
8. When finished, push the changes to your GitHub account with:

```
git push --set-upstream origin my-feature-branch
```

1. Follow [these instructions](https://help.github.com/articles/creating-a-pull-request-from-a-fork) to create a pull request from your fork. If your work is still work in progress, open a draft pull request.
9. Follow [these instructions](https://help.github.com/articles/creating-a-pull-request-from-a-fork) to create a pull request from your fork. If your work is still work in progress, open a draft pull request.

Note

We recommend to open a pull request early, so that other contributors become aware of your work and can give you feedback early on.

1. To add more changes, simply repeat steps 7 - 8. Pull requests are updated automatically if you push new changes to the same branch.
10. To add more changes, simply repeat steps 7 - 8. Pull requests are updated automatically if you push new changes to the same branch.

Note

Expand Down

0 comments on commit 8cef4d5

Please sign in to comment.