Skip to content

Latest commit

 

History

History
101 lines (58 loc) · 4.71 KB

CONTRIBUTING.md

File metadata and controls

101 lines (58 loc) · 4.71 KB
Raw

Contributing Guidelines

Getting Started

Contributing to open source projects, like this one, can be a rewarding experience allowing participants to learn, teach, share and gain experience.

View openBookmarkz/ideas open issues here and follow the instructions below to contribute to this project.

Project Setup

  1. Create a Fork of this project. This will create a copy of the original repository in your GitHub account that you own, allowing you to make changes without affecting the original repo.

    Create a fork gif

  2. Go to the forked repo in your GitHub (if the page hasn't automatically opened, you can find this in your repositories) and click the Code button. Choose HTTPS (or SSH if you have this setup) and copy the link.

    Image from Gyazo

  3. In your IDE, open a terminal/command line, and run the following command to clone your forked repo into the IDE:

    git clone <insert copied link from step 2 here>

  4. Set the upstream (the original repo) by running the following command in the terminal/command line:

    git remote add upstream https://github.com/openBookmarkz/ideas.git

  5. Confirm that the upstream has been correctly added by running git remote -v in the terminal/command line. This will then output two origin links and two upstream links. The origin links are used for pushing and fetching from your forked repo. The upstream are used to push and fetch from the original repo. You should see something similar to the example below:

    git remote -v

origin  [email protected]:kera-cudmore/ideas.git (fetch)
origin  [email protected]:kera-cudmore/ideas.git (push)
upstream        https://github.com/openBookmarkz/ideas.git (fetch)
upstream        https://github.com/openBookmarkz/ideas.git (push)

  6. Create a new branch to work on. In the terminal/command line run the following command:

    git checkout -b <branchName/your-idea>

  7. Tell Git to track this branch. In the terminal/command line run the following command:

    git push -u origin <branch name>

Make & Commit your Changes

Once you are happy with your changes, you will want to commit the changes to your forked repo and then submit a pull request using the submission template back to the original repo. A Pull Request (PR) is how a contributor begins the process of merging their changes back into the original project.

  1. Add, commit and push your changes to your forked repository:

    git add <filename>
git commit -m "<Commit message here>"
git push

Submission Template

Kindly utilize the Submission Template as a reference for the submission of your idea.

Create a Pull Request (PR)

  1. In the original repo click the Pull Requests tab in the top menu.

    Pull Requests Top Menu

  2. You should be able to see a yellow banner at the top of the screen with a green button that says compare & pull request. Clicking this button will start the Pull Request process.

    Create pull request button

  3. This will open the pull request page where you can provide a comprehensive overview of your contribution using the pre-populated Idea Template. Please fill out the template with your contribution and reference the issue (if applicable).

    Pull request page

  4. Click the Create pull request button at the bottom of the form to submit your pull request.

  5. The team will then review your contribution, provide feedback if necessary (you will be notified via email), and merge your contribution into the main project if it aligns with our goals and standards.