Using GitLab.md 1.71 KB
Newer Older
1 2 3 4 5 6 7
Contributing to a Repository
============================

The right way to contribute changes to a repository.

## Forking

Nigel Kukard's avatar
Nigel Kukard committed
8
* Log into [LinuxAssist Devlabs GitLab](https://gitlab.devlabs.linuxassist.net)
9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48
* Find the project you're wanting to change, click on the repository
* Top right hand side, click "Fork"

You now have your own copy of the repository.

## Clone Locally

Clone the repository locally...

```sh
git clone ssh://git@gitlab.devlabs.linuxassist.net/yourusername/yourreponame.git
cd yourreponame
git config format.signature true
```

You should probably add the upstream repository too so you can do merges and rebases...

```sh
git remote add upstream ssh://git@gitlab.devlabs.linuxassist.net/upstream/repo.git
```

## Make Your Changes

Make and commit your changes, merge your commits, go mad.

### Branching

For each separate change you going to make you must create a branch...

```sh
git checkout master -b your-change-name
```

### Committing You Changes

Commit your chagnes as usual, making sure of course all your changes must contain the Signed-Off line.


## Submitting Your Changes

Nigel Kukard's avatar
Nigel Kukard committed
49
Be sure to read the code [Submission Policy](https://gitlab.devlabs.linuxassist.net/allworldit/allworldit/blob/master/Submission%20Policy.md)
50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68

### Push Changes

Make sure your code is based off the main repo and push your branch...

```sh
git fetch upstream
git checkout yourbranchname
git rebase upstream/master
git push origin yourbranchname:yourbranchname
```

### Submit Upstream

Using the web interface you can then create a merge request:
* Click on your repository, click "Create Merge Request"
* Select the repository and branch on the top left and top right
* Type in a description of your changes
* Click "Submit merge request"