anchor.diff:  owner: Docs
   ---
   
  -## <a id='why'></a>Why Should You Contribute?
  +## <a id='why'></a> Why Should You Contribute?
   
   The Cloud Foundry documentation relies on contributions from the community to remain accurate, complete, and consumable.
   
  
positive.code: * You are a good person, and you want to help your fellow humans.
  * You hate the idea of someone else having to go through what you just went through to figure something out. Such a waste; so inefficient.
  
  ## <a id='how'></a>How Can You Contribute?
  
  The content for the Cloud Foundry documentation lives in several GitHub repos within the [cloudfoundry GitHub org](https://github.com/cloudfoundry/). Each topic is represented by a source file in Markdown/HTML/embedded Ruby (`html.md.erb`) format. 
  
  
negative.code: 
  The instructions below explain how to use Bookbinder to preview your documentation changes locally. But you do not have to install or use Bookbinder in order to contribute to the Cloud Foundry documentation. 
  
  To preview documentation changes with Bookbinder, do the following:
  
  1. If you do not already have a workspace directory within your home directory, create one.
  	<pre class="terminal">$ mkdir ~/workspace</pre>
  
  1. Clone the layout repo. This contains layouts, formatting, and styles used across all documentation sets.
  	<pre class="terminal">git clone git<span>@</span>github.com:pivotal-cf/docs-layout-repo</pre>
  
  1. Identify the content repo where your documentation lives. For example, `https://github.com/cloudfoundry/docs-cloudfoundry-concepts`.
  
  1. Clone the content repo. For example:
   	<pre class="terminal">$ git clone git<span>@</span>github.com:cloudfoundry/docs-cloudfoundry-concepts.git</pre>
  
  1. Return to your workspace directory and clone the Cloud Foundry book.
  	<pre class="terminal">$ git clone git<span>@</span>github.com:cloudfoundry/docs-book-cloudfoundry.git</pre>
  
  1. Change directory into the Cloud Foundry book.
  	<pre class="terminal">cd docs-book-cloudfoundry</a>
  
  1. Run `bundle install` to install the necessary gems, including Bookbinder.
  
  1. Use Bookbinder to create a live version of your docs:
  	<pre class="terminal">$ bundle exec bookbinder watch</pre>
  
  1. Navigate to `http://localhost:4567` in a browser and navigate to the route where your docs are published. For instance, `http://localhost:4567/cf-cli/install-go-cli.html`.
  	<br><br>
  	Bookbinder will automatically update the live version of the docs whenever you make a change to the content repo.