Skip to content

Latest commit

 

History

History
78 lines (53 loc) · 2.9 KB

CONTRIBUTING.md

File metadata and controls

78 lines (53 loc) · 2.9 KB
Raw

Template Contribution Guidelines

This documentation contains a set of guidelines to help you during the contribution process. We are happy to welcome all the contributions from anyone willing to improve/add new templates to this project. Thank you for helping out and remember, no contribution is too small.

Submitting OTE Templates

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

Step 1 : Find existing templates

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>/OTE-Templates
cd OTE-Templates
git remote add upstream https://github.com/3nock/OTE-Templates
  • If you have already forked the project, update your copy before working.
git remote update
git checkout master
git rebase upstream/master

Step 3 : Create your Template Branch

Create a new branch. Use its name to identify the issue your addressing.

# It will create a new branch with name template_branch_name and switch to that branch
git checkout -b template_branch_name

Step 4 : Create Template

  • Create your template.
  • Add all the files/folders needed.

Step 5 : Commit

  • After you've made changes or completed template creation, add changes to the branch you've just created by:
# To add all new files to branch template_branch_name
git add .
  • To commit, give a descriptive message for the convenience of the reviewer by:
# This message get associated with all files you have changed
git commit -m "Added/Fixed/Updated XXX Template"

NOTE:

  • A Pull Request should have only one unique template to make it simple for review.
  • Multiple templates for same technology can be grouped into single Pull Request.

Step 6 : Push Your Changes

  • Now you are ready to push your template to the remote (forked) 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 template_branch_name

Step 7 : Pull Request

  • Fire up your favorite browser, navigate to your GitHub repository, then click on the New pull request button within the Pull requests tab. Provide a meaningful name and description to your pull request, that describes the purpose of the template.

  • Voila! Your Pull Request has been submitted. It will be reviewed and merged by the moderators, if it complies with project standards, otherwise a feedback will be provided.