Skip to content

Latest commit

 

History

History
117 lines (79 loc) · 3.66 KB

contributing.md

File metadata and controls

117 lines (79 loc) · 3.66 KB

Follow these steps to contribute

How to add your projects to ProjectsHut

1. Fork this repository

 Fork this repository

2. Click on Go to file

Go to file

3. Add following code to end of DB/projects.json

{
  "github_username": "YOUR_GITHUB_USERNAME",
  "Projects": [
    {
      "github_url": "PROJECT_LINK",
      "title": "PROJECT_NAME",
      "description": "PROJECT_DESCRIPTION",
      "tech": ["tech1", "tech2"]
    },
    {
      "github_url": "PROJECT_LINK",
      "title": "PROJECT_NAME",
      "description": "PROJECT_DESCRIPTION",
      "tech": ["tech1", "tech2"]
    }
  ]
}

Important: Tech Stacks name should be in lowercase and should be separated by comma (e.g. ["reactjs", "nodejs"])

4. Commit all changes.

  • Add a commit like this for only projects addition chore: project addition by [your-githubuser-name] #issue_number

Note Alternatively, if you prefer to run the project locally, follow these steps:

  1. Go to preferred folder in your computer and paste the following command after forking our repository (Only one of it if you don't have ssh setup then go with HTTP command)
git clone https://github.com/<YOUR-USERNAME>/ProjectsHut.git
  1. Navigate to the project folder
cd ProjectsHut
  1. Add a reference(remote) to the original repository.
git remote add upstream https://github.com/priyankarpal/ProjectsHut.git
  1. Check the remotes for this repository.
git remote -v
  1. Install dependencies
pnpm i

Note: If you don't have pnpm installed in your system then run this command npm i -g pnpm

  1. Now go ahead and create a new branch and move to the branch
git checkout -b fix-issue-<ISSUE-NUMBER>

Note: Replace <ISSUE-NUMBER> with the issue number you are working on

  1. Run in local
pnpm dev

Add new features or fix bugs according to your issue number

  1. After done you can now push this changes, for doing that follow the following command chain
  • git status -s (Shows the changed files)

  • git add --all (Will add all the files to staging area)

  • git commit -m "feat/docs/fix: <EXPLAIN-YOUR_CHANGES>"

    Note: Replace <EXPLAIN-YOUR_CHANGES> with the changes you have made. Also, follow the conventional commits for writing commit messages

  • git push origin fix-issue-<ISSUE-NUMBER>

  1. After this go to your forked GitHub repository and go to Pull Request section. Now you might be able to see a pop up saying Pull Request. Click on the popup and you will be redirected to pull request page

  2. Now fill in the form template of the pull request and give the necessary description.

  3. Click on Submit

  4. Hurray! You just made your first contribution to this project 🎉

  5. Wait for your pull request to be reviewed and merged.

An example video guide on how to make your first PR.

Useful Links