===== Overview =====

How to contribute to [[https://github.com/kubernetes/community/blob/master/contributors/guide/github-workflow.md|Kubernetes via GitHub]].

===== The workflow =====

First, create a GitHub fork of ''https://github.com/kubernetes/kubernetes''.

Create the appropriate Go working directory:

<code>
$ mkdir -p ~/go/src/k8s.io
$ cd ~/go/src/k8s.io
</code>

Make a local clone of your GitHub fork:

<code>
$ git clone https://github.com/rpjday/kubernetes
</code>

Move into the cloned directory, and verify the single remote defined thus far:

<code>
$ cd kubernetes
$ git remote -v
origin	https://github.com/rpjday/kubernetes (fetch)
origin	https://github.com/rpjday/kubernetes (push)
$
</code>

Define the remote ''upstream'' for the official Kubernetes repo, and make sure you can't push to it:

<code>
$ git remote add upstream https://github.com/kubernetes/kubernetes.git
$ git remote set-url --push upstream no_push
$ git remote -v
origin	https://github.com/rpjday/kubernetes (fetch)
origin	https://github.com/rpjday/kubernetes (push)
upstream	https://github.com/kubernetes/kubernetes.git (fetch)
upstream	no_push (push)
$
</code>

Finally, regularly pull new content and merge it into the ''master'' branch:

<code>
$ git checkout master
$ git fetch upstream
$ git merge upstream/master
</code>