Skip to content

Latest commit

 

History

History
80 lines (64 loc) · 3.11 KB

Contributing.md

File metadata and controls

80 lines (64 loc) · 3.11 KB
Raw

Contributing Guidelines

This documentation contains a set of guidelines to help you during the contribution process.
Please go through the Code of Conduct.

Submitting Contributions👩‍💻👨‍💻

Below you will find the process and workflow used to review and merge your changes.

Project prerequisites

  • Visual Studio with UWP toolset.
  • Atleast 18362 target platform version

Building notes

  • If you get an error of certificate not found go open Package Manifest > Certificates and generate your own new one

Step 1 : Find an issue

  • Take a look at the Existing issues or create your own issues!
  • Wait for the issue to be assigned to you after which you can start working on it.

Step 2 : Fork the Project

  • Fork this Repository. This will create a Local Copy of this Repository on your Github Profile. Keep a reference to the original project in upstream remote.
$ git clone https://github.com/<your-username>/Protecc
$ cd Protecc
$ git remote add upstream https://github.com/FireCubeStudios/Protecc
  • If you have already forked the project, update your copy before working.
$ git remote update
$ git checkout <branch-name>
$ git rebase upstream/<branch-name>

Step 3 : Branch

# To create a new branch with name branch_name and switch to that branch 
$ git checkout -b <branch_name>

Step 4 : Work on the issue assigned

  • Work on the issue assigned to you.
  • After you've made changes or made your contribution to the project add changes to the branch you've just created by:
# To add all new files to branch branch_name
$ git add .

Step 5 : Commit

  • To commit give a descriptive message for the convenience of reveiwer by:
# This message get associated with all files you have changed
$ git commit -m "message"

Step 6 : Work Remotely

  • Now you are ready to your work to the remote repository.
  • When your work is ready and complies with the project conventions, upload your changes to your fork:
# To push your work to your remote repository
$ git push -u origin <branch_name>

Step 7 : Pull Request

  • Go to your repository in browser and click on compare and pull requests. Then add a title and description to your pull request that explains your contribution.
  • Then add a title to your pull request.
  • Mention the issue number in your PR.
  • Give a brief description about the changes.
  • Your Pull Request has been submitted and will be reviewed by the owner and merged.🥳

Need more help?🤔

You can refer to the following articles on basics of Git and Github and also contact the Project Mentors, in case you are stuck: