Git and GitHub workflow#

Note

If your not familiar with git you may want to start by reviewing Git’s documentation and then trying out the workflow. If you get stuck, chat with us on Discord.

The preferred workflow for contributing to skbase’s repository is to fork the main repository on GitHub, clone your fork locally and create a development installation, and then create a new feature branch for your development.

  1. Fork the project repository 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.

  2. Follow skbase’s development installation instructions.

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

    git remote -v
git remote add upstream https://github.com/sktime/skbase.git

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

    git remote -v
> origin    https://github.com/<username>/skbase.git (fetch)
> origin    https://github.com/<username>/skbase.git (push)
> upstream  https://github.com/sktime/skbase.git (fetch)
> upstream  https://github.com/sktime/skbase.git (push)

  5. Sync the main branch of your fork with the upstream repository:

    git fetch upstream
git checkout main
git merge upstream/main

    Hint

    You can use these same instructions to sync another branch by replacing the “main” branch with the name of the other branch you want to sync.

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

    git checkout main
git checkout -b <name-of-feature-branch>

    Note

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

  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

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

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

  9. Follow these instructions to create a pull request from your fork. If your work is still work in progress, make sure to open a draft pull request.

    Note

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

  10. To add more changes related to this feature, simply repeat steps 7 - 8.

    Note

    Pull requests are updated automatically if you push new changes to the same branch. This will trigger skbase’s continuous integration routine to re-run automatically.

Show Source