DOCTOOLS.README.md: Cleaned up headings

Signed-off-by: Ole Herman Schumacher Elgesem <[email protected]>

Author: olehermanse

DOCTOOLS.README.md

@@ -1,12 +1,12 @@
-# Documentation Tools Cheatsheet for Beginners
+# Documentation tools cheatsheet for beginners
 
 CFEngine technical documentation is written using a Markdown formatting (see [Markdown Cheatsheet][Markdown Cheatsheet]) and published using a combination of Jekyll and various plugins (see [CFEngine Documentation][CFEngine Documentation]).
 
 The various Markdown and other files (e.g. images) that make up the volume of CFEngine documentation are held in a master source code repository. Contributors to the documentation make their own changes in local copies of the documentation Markdown on their own machines and then push those changes to a remote branch.
 
 From there a request is made to merge the modifications back into the mainline, from which the Jekyll tooling will be triggered to import and then render the final documentation in HTML.
 
-## Git and GitHub ##
+## Git and GitHub
 
 Git is the repository system in use for CFEngine technical documentation, and the remote repositories are hosted on GitHub.
 
@@ -20,7 +20,7 @@ setup then manage repositories and users that they would otherwise need to do
 themselves. In general it contains many features and improvements to a normal
 Git workflow.
 
-### Downloading and Installing Git on Windows ###
+### Downloading and installing Git on Windows
 
 1. Go to the Git website at http://git-scm.com/
 2. Go to the download section. At the time of writing this was http://git-scm.com/downloads.
@@ -30,19 +30,19 @@ Git workflow.
 6. If you see a security warning select `Run`, and for `User Account Control` select `Yes`.
 7. Follow the instructions in the installer. It is safe to accept all the default values.
 
-### Launching Git Bash ###
+### Launching Git Bash
 
 1. Using Windows Explorer, open a directory where you wish to store CFEngine related Git repositories (e.g. D:\Projects\CFEngine).
 2. Right click to bring up the contextual menu.
 3. Select `Git Bash`
 ![Contextual Menu With Git Bash](Doctools-ReadMe-Git-Bash.png)
 4. A `Command Prompt` style window will open. This is where you will enter Git commands.
 
-### Using Git ###
+### Using Git
 
 Git is a very powerful and robust command line tool at its heart. While it has a great number of commands, some of which are similar to one another, for the beginner there are generally only a few simple ones they need to learn to get started -- and a few more complicated ones to get themselves out of trouble!
 
-#### Good Git Commands to Learn ####
+#### Good Git commands to learn
 
 * clone
 * add
@@ -51,33 +51,32 @@ Git is a very powerful and robust command line tool at its heart. While it has a
 * pull
 * reset
 
-#### Basic Examples ####
+#### Basic examples
 
 Note: Statements using the following format `> git command something` are to be done on the command line (e.g. Command Prompt/PowerShell on Windows, bash etc. on Linux / Mac). Do not type the `>` at the start of the statement -- beging typing the instructions that follow it (e.g. `git...`).
 
-##### Cloning a Remote Repository #####
+##### Cloning a remote repository
 
 1. `> git clone https://github.com/cfengine/documentation.git`
 
 This will clone the repository from the URL indicated into a sub-directory called `documentation`.
 
-##### Cloning a Remote Repository, Making and Committing Changes #####
+##### Cloning a remote repository, making and committing changes
 
 1. `> git clone https://github.com/cfengine/documentation.git`
 2. Edit any of the files in the `documentation` sub-directory.
 3. `> git commit -a -m "This is a note about the changes that were made"`
 
-##### Cloning a Remote Repository and Configuring a `Remote` #####
+##### Cloning a remote repository and configuring a remote
 
 1. `> git clone https://github.com/cfengine/documentation.git`
 2. `> cd documentation`
 3. `> git remote add upstream https://github.com/cfengine/documentation.git`
 
 Note: If working with a clone that you do not have rights to push to then you will need to add a remote for it and push changes to there first.
 
-### Git (and Related) Resources ###
+### Git (and related) resources
 
 * The Wikipedia article on Git provides a good overview of the software: http://en.wikipedia.org/wiki/Git_(software).
 * The official Git documentation has excellent content for learning how to use Git: http://git-scm.com/documentation.
 * GitHub's Help section has many useful tips and tricks, as well as guidance on how to setup Git, create Git repos, fork of repos and contribute to Git supported software projects: https://help.github.com/
-