# General Instructions

Our books are hosted, in Markdown format, in <http://github.com/devops-collective-inc>. So, you'll need a way to **clone** our repositories, such as a GitHub desktop client.

Start in the book's [GitHub.com repo](http://github.com/devops-collective-inc), where you'll find a Fork button:

![The Fork button](https://2108994893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA8qNDILzGSFdX2ig2M%2F-LHBHOPYlCMn5PQe-v0M%2F-LHBHOvO92lzeRY7IF9h%2F1.png?generation=1531361993769051\&alt=media)

Clicking that will fork the repo into your own account in GitHub. When it's done, verify that you're now under your GitHub account (here, it's concentrateddon):

![Verify the fork](https://2108994893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA8qNDILzGSFdX2ig2M%2F-LHBHOPYlCMn5PQe-v0M%2F-LHBHOvQ_7hFH4rhs3Er%2F2.png?generation=1531361993699423\&alt=media)

You an then clone the repo to your local computer, which will launch the GitHub Desktop Client.

![Clone the repo](https://2108994893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA8qNDILzGSFdX2ig2M%2F-LHBHOPYlCMn5PQe-v0M%2F-LHBHOvS7RTfGc8YEWHZ%2F3.png?generation=1531361993807152\&alt=media)

Afterwards, the client won't show any files. That's normal - it only shows changes by default. You just open the local folder to see the files as they currently are.

![Open the folder](https://2108994893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA8qNDILzGSFdX2ig2M%2F-LHBHOPYlCMn5PQe-v0M%2F-LHBHOvUqfh-5v2_j-6F%2F4.png?generation=1531361993724175\&alt=media)

Make whatever changes you plan to make. The GitHub client should show the changed files, along with the changes themselves.

![View changes](https://2108994893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA8qNDILzGSFdX2ig2M%2F-LHBHOPYlCMn5PQe-v0M%2F-LHBHOvW27ox46WpqQ29%2F5.png?generation=1531361993904274\&alt=media)

You need to provide a short comment and description about what you've changed, and *commit* your changes to the repo (alternately, you could right-click the changed file to discard your changes).

![Commit changes](https://2108994893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA8qNDILzGSFdX2ig2M%2F-LHBHOPYlCMn5PQe-v0M%2F-LHBHOvYoYugq-0eDti9%2F6.png?generation=1531361993777505\&alt=media)

Your changes are still local, so you need to *push* them up to your GitHub account.

![Push changes](https://2108994893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA8qNDILzGSFdX2ig2M%2F-LHBHOPYlCMn5PQe-v0M%2F-LHBHOv_EsvLUOePtxLu%2F7.png?generation=1531361993690388\&alt=media)

With the changes safely in GitHub.com, you can log into the website and create a new Pull Request.

![Create a PR](https://2108994893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA8qNDILzGSFdX2ig2M%2F-LHBHOPYlCMn5PQe-v0M%2F-LHBHOvbcPGjbpxoNhCa%2F8.png?generation=1531361993685423\&alt=media)

You'll need to confirm the PR.

![Confirm the PR](https://2108994893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA8qNDILzGSFdX2ig2M%2F-LHBHOPYlCMn5PQe-v0M%2F-LHBHOvd2pLIUqmFIAmE%2F9.png?generation=1531361993910602\&alt=media)

Finally, you'll need to provide a description of what you've changed and finalize the PR. This submits it for review and merging into the main book!

![Finalize the PR](https://2108994893-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA8qNDILzGSFdX2ig2M%2F-LHBHOPYlCMn5PQe-v0M%2F-LHBHOvfjdwv3iF7PF59%2F10.png?generation=1531361993791761\&alt=media)