Skip to content

Latest commit

 

History

History
30 lines (20 loc) · 1.92 KB

CONTRIBUTING.md

File metadata and controls

30 lines (20 loc) · 1.92 KB

Contributing to CRATE

If you wish to contribute to this project, start by reading CRATE's Code of Conduct and act accordingly during the whole contribution process.

Any contribution to this project should follow two main steps:

  • Step 1: Open a new discussion on CRATE's GitHub Discussions space

    • Provide a clear description of your idea, including any coding details that you may already have in mind;

    • Enroll in a discussion with the project's owners about the merits and pros/cons of your idea;

    • Proceed to Step 2 if and only if owners accept your idea.

  • Step 2: Contribute to CRATE by creating a Pull Request

    • Fork CRATE's GitHub repository to your GitHub account;
    • Clone the forked repository into a local directory, thus creating your local repository;
    • Set your remote forked repository as the 'origin' remote (should be set by default);
    • Set CRATE's GitHub repository as the 'upstream' remote;
    • Pull the most recent version of CRATE's 'master' branch into your local repository;
    • Create and new development branch and commit your contribution;
    • Push your contribution to the 'origin' remote;
    • Create a Pull Request from your forked repository ('head repository') to CRATE's GitHub repository ('base repository');
    • The Pull Request is reviewed by the project's owners and your contribution is merged depending on the outcome of the review process.

Please refer to the several sources available on how to contribute to a GitHub repository (Step 2) (e.g., source 1, source 2).