Skip to content

Latest commit

 

History

History
137 lines (84 loc) · 4.27 KB

CONTRIBUTING.md

File metadata and controls

137 lines (84 loc) · 4.27 KB
Raw

Rules

  • Don't create a pull request on an issue that doesn't exist, create an issue first and if the changes you are proposing are said to be okay, you can go ahead and create a pull request

  • Don't work on anything unless you are assigned, if you make a pull request without being assigned to that issue, it will be closed without being merged

  • Don't work on more than one issue at a time, this is so that you don't make a huge pull request and others can have opportunities to work on another issue while you work on something else

  • Do read the readme.md file

  • Add the Issue you worked on in your Pull Request

  • Don't work on the main branch, create your own branch

  • Don't commit the lock files eg package.json

  • Keep your PR as small as possible

Note: Breaking any of the rules above👆🏽 will get your PR rejected

👩🏽‍💻 Prerequisite Skills to Contribute

Contribute in project

-   TypeScript
-   NodeJs
-   Express

💥 How to Contribute

  • Take a look at the existing Issues or create a new issue!
  • Fork the Repo. Then, create a branch for any issue that you are working on. Finally, commit your work.
  • Create a Pull Request (PR), which will be promptly reviewed and given suggestions for improvements by the community.
  • Add screenshots or screen captures to your Pull Request to help us understand the effects of the changes proposed in your PR.

🌟 HOW TO MAKE A PULL REQUEST:

  1. Start by making a Fork of the Borgen repository. Click on the Fork symbol at the top right corner.

  2. Clone your new fork of the repository in the terminal/CLI on your computer with the following command:

git clone https://github.com/<your-github-username>/Borgen
  1. Navigate to the newly created Borgen project directory:
cd Borgen
  1. Set upstream command:
git remote add upstream https://github.com/<your-github-username>/Borgen.git
  1. Create a new branch:
git checkout -b YourBranchName
  1. Sync your fork or your local repository with the origin repository:
  • In your forked repository, click on "Fetch upstream"
  • Click "Fetch and merge"

Alternatively, Git CLI way to Sync forked repository with origin repository:

git fetch upstream
git merge upstream/main

Github Docs for Syncing

  1. Make your changes to the source code.

  2. Add and commit the changes:

⚠️ Make sure not to commit package.json or package-lock.json file

Add the changes that you have made to the branch using the git add command:

git add TheFileNameYouChanged

Example:

git add README.md

Now commit those changes using git commit command:

git commit -m "Your commit message"
  1. Push your local commits to the remote repository:
git push origin YourBranchName

  1. Create a Pull Request!

  2. Congratulations! You've made your first contribution to Borgen!

🏆 After this, the maintainers will review the PR and will merge it if it helps move the Borgen project forward. Otherwise,
it will be given constructive feedback and suggestions for the changes needed to add the PR to the codebase.

Your PR

When making your 🚀PRs please do them in small chunks e.g after revamping the navbar make a PR. This ensures
the PRs are manageable and easy to review. Thank for taking interest in this project.

💝 Your contribution is appreciated.

💥 Issues

In order to discuss changes, you are welcome to open an issue about what you would like to contribute. Enhancements are always encouraged and appreciated.