Skip to content

Latest commit

 

History

History
109 lines (55 loc) · 2.69 KB

contribute.md

File metadata and controls

109 lines (55 loc) · 2.69 KB

#How to contribute to robocomp github repository

In brief the steps involved will be:

  • Fork the robocomp repository
  • Clone the repository
  • Create a new branch
  • Switch to the created branch
  • Make suitable changes
  • Test the changes
  • Add the files you want to commit
  • Commit the files
  • Push to repository
  • Compare changes
  • Pull a request for the commit made
  • Start a discussion over the commits made

In detail explanation:

  1. Forking the repository:

Open the robocomp github repository : https://github.com/robocomp/robocomp

Click on the fork option as shown below:

The indication that the repo is forked can be observed as follows:

  1. Cloning the the repository:

Open a terminal and move to home directory and type:

git clone <link to the forked repository>

  1. Creating a branch:

Open a terminal and move the “pwd” to the place where the forked repository is present.

  • To see a list of all branches present and to see the current working branch type and execute:

    git branch

  • Create a new branch to work on. There is no restriction wrt the naming of the branch:

    git branch <branch_name>

  • To switch to the branch that you created to work on execute:

    git checkout <branch_name>

  1. Making changes:

Demo : Lets make changes to Readme.md

  1. Commit the changes made
  • To get a list of all the files to which changes have been made type:

    git status

  • Next add only those files which we want to commit by typing:

    git add <filename>

  • Now commit the changes by using command:

    git commit -m 'commit message'

  1. Push the commit to repository:

    git push origin <current_working_branch_name>

  1. Compare and pull request

  1. Discuss the commits you have made with the rest of the contributing team.