Step by Step setup
We’ll go through each step below, but here’s what you need to get started with Git:
Install Git on your system
Git is a version control system to track the changes of source code.
You will need to have Git installed on your computer to contribute to Jenkins X development. Teaching Git is outside the scope of the Jenkins X docs, but if you’re looking for an excellent reference to learn the basics of Git, we recommend the Git book if you are not sure where to begin.
Move back to the terminal and check if Git is already installed.
git version and press enter.
If the command returned a version number, you can skip the rest of this section.
Otherwise, download the latest version and follow this installation guide.
git version again to check if Git was installed successfully.
Git Graphical Front Ends
There are several GUI clients that help you to operate Git. Not all are available for all operating systems and maybe differ in their usage. Thus, we will use the command line since the commands are everywhere the same.
Create a GitHub Account
If you’re going to contribute to the docs, you’ll need to have an account on GitHub. Go to www.github.com/join and set up a personal account.
Set up your working copy
The working copy is set up locally on your computer. It’s what you’ll edit, compile, and end up pushing back to GitHub. The main steps are cloning the repository and creating your fork as a remote.
Fork the repository
If you’re not familiar with this term, GitHub’s help pages provide a simple explanation:
A fork is a copy of a repository. Forking a repository allows you to freely experiment with changes without affecting the original project.
Open the Jenkins X docs repository on GitHub and click on the “Fork” button in the top right.
Clone your fork locally
Now open your fork repository on GitHub and copy the remote url of your fork. You can choose between HTTPS and SSH as protocol that Git should use for the following operations. HTTPS works always if you’re not sure.
Then go back to your terminal,
cd to where you would like to place your local copy of the
jx-docs repo, and then clone your fork.
git clone --recurse-submodules --depth 1 email@example.com:<YOUR_USERNAME>/jx-docs.git cd jx-docs
In case you already have a git clone locally (from before the theme change) then run the following to pull the Docsy theme and dependencies
git submodule update --init --recursive
Add the conventional upstream
git remote in order to fetch changes from the
branch and to create pull requests:
git remote add upstream https://github.com/jenkins-x/jx-docs.git
Let’s check if everything went right by listing all known remotes:
git remote -v
The output should look similar to:
origin firstname.lastname@example.org:<YOUR_USERNAME>/jx-docs.git (fetch) origin email@example.com:<YOUR_USERNAME>/jx-docs.git (push) upstream https://github.com/jenkins-x/jx-docs.git (fetch) upstream https://github.com/jenkins-x/jx-docs.git (push)
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.