Contribution

• Fork the repository you are working on.
• Go to your GitHub account, open the forked repository, click on the code button and then click the “copy to clipboard” icon if you intend to use a command-line tool.
• Open the terminal and run the following git command:

  Copy
  1git clone “URL you copied from the clipboard.”

Add 'upstream' repo to list of remotes

• Keeping your fork up to date while this isn't a necessary step. If you plan on doing anything more than a tiny quick fix, you'll want to make sure you keep your fork up to date by tracking the original "upstream" repo that you forked earlier.
• To do this, you'll need to add a remote. An example of the command is given below:

  Copy
  1git remote add upstream https://github.com/layer5io/meshery.git 

  Here “meshery" is used as the example repo. Be sure to reference the actual repo you are contributing to.

• Whenever you begin to work on a new feature or bugfix, it's important that you create a new branch. Not only is it a proper git workflow, but it also keeps your changes organized and separated from the master branch so that you can easily submit and manage multiple pull requests for every task completed.
• Perform the flow:

  Copy
  1 git checkout -b your-new-branch-name

  For example,

  Copy
  1git checkout -b feature

  (feature being a branch name)

Make the necessary changes to your file.

• To add the changes you have made to your branch, use:

  Copy
  1git add <file> 

• If you add multiple file changes to the branch, you simply use:

  Copy
  1 git add .

• Now commit those changes using the git commit command:

  Copy
  1git commit -s -m “This is my commit message”

Make sure to Sign-off on your Commits (Developer Certificate of Origin)

To contribute to this project, you must agree to the Developer Certificate of Origin (DCO) for each commit you make. The DCO is a simple statement that you, as a contributor, have the legal right to contribute.

To signify that you agree to the DCO for contributions, you simply add a line to each of your git commit messages:

Copy
1Signed-off-by: Jane Smith <jane.smith@example.com>

In most cases, you can add this signoff to your commit automatically with the -s or --signoff flag to git commit. You must use your real name and a reachable email address (sorry, no pseudonyms or anonymous contributions). An example of signing off on a commit:

Copy
1$ commit -s -m “my commit message w/signoff”

To ensure all your commits are signed, you may choose to add this alias to your global .gitconfig:

Copy
1[alias] amend = commit -s --amend cm = commit -s -m commit = commit -s
2

Or you may configure your IDE, for example, Visual Studio Code to automatically sign-off commits for you:

• To push your changes, run the git command:

  Copy
  1git push origin your_branch_name

• Head over to your forked repository on GitHub and you'll see a Compare & pull request button. Click on that button.
  Note: Please ensure that the right branch is selected for the PR.
  
  

  

  

• Once you click on the button, you'll be taken to the Pull Request page. Here, you can add a title and description to your pull request that explains your contribution. Once you're done, click on the Create pull request button.