anchor.diff: -= Install and set up the tools and software 
  += Install and set up the tools and software
   :icons:
   :toc: macro
   :toc-title:
  
positive.code: toc::[]
  
  == Create a GitHub account
  Before you can contribute to OpenShift documentation, you must https://www.github.com/join[sign up for a GitHub account].
  
  == Set up authentication
  When you have your account set up, follow the instructions to https://help.github.com/articles/generating-ssh-keys/[generate and set up SSH keys on GitHub] for proper authentication between your workstation and GitHub.
  
  Confirm authentication is working correctly with the following command:
  
  
negative.code: ----
  +
  [TIP]
  This utility will run in the terminal where you started it, so you should leave
  it running and open new terminal windows for other tasks.
  
  4. In your browser, enable the LiveReload plugin in the same tab where the
  preview file is open; the icon should change color once activated. The following
  message will also display in your terminal window:
  +
  ----
  [1] guard(main)> 17:29:22 - INFO - Browser connected.
  ----
  
  With this setup, a rebuild is automatically generated each time you make a change
  to the source `.adoc` file, and is immediately viewable in the corresponding
  `.html` file.
  
  === Clean up
  The `.gitignore` file is set up to prevent anything under the `_preview` and
  `_package` directories from being committed. However, you can reset the
  environment manually by running:
  
  ----
  $ bundle exec rake clean
  ----
  
  == Next steps
  With the repository and tools set up on your workstation, you can now either
  edit existing content or create new topics.
  
  * link:doc_guidelines.adoc[Review the documentation guidelines] to understand
  some basic guidelines to keep things consistent across our content.
  * link:create_or_edit_content.adoc[Create a local working branch] on your
  workstation to edit existing topics or create new topics.
  