Fix and tweak syntax

Author: i80and

source/includes/steps-configure-git.yaml

@@ -1,8 +1,6 @@
-title: "Fork these repositories into your own GitHub account. +"
-stepnum: 1
+title: "Fork these repositories into your own GitHub account."
 ref: fork-repos
 content: |
-
   `This guide from GitHub <https://guides.github.com/activities/forking/>`_ covers the specifics.
 
   - https://github.com/mongodb/docs
@@ -15,99 +13,66 @@ content: |
   - https://github.com/mongodb/docs-bi-connector
 ---
 title: "Clone and prepare MongoDB Documentation Assets."
-stepnum: 2
 ref: clone-docs-assets
-pre: |
-
 action:
   language: sh
   code: |
-  	git clone [email protected]:<yourid>/docs-assets.git
+    git clone [email protected]:<yourid>/docs-assets.git
     cd docs-assets
     git remote add upstream [email protected]:mongodb/docs-assets.git
 ---
 title: "Clone and prepare MongoDB Documentation Toolset."
-stepnum: 3
 ref: prep-docs-tools
-pre: |
-
 action:
   language: sh
   code: |
-  	git clone [email protected]:<yourid>/docs-tools.git
+    git clone [email protected]:<yourid>/docs-tools.git
     cd docs-tools
     git remote add upstream [email protected]:mongodb/docs-tools.git
 ---
 title: "Clone and prepare MongoDB Manual documentation."
-stepnum: 4
 ref: clone-docs
-pre: |
-
 action:
   language: sh
   code: |
-  	git clone [email protected]:<yourid>/docs.git
+    git clone [email protected]:<yourid>/docs.git
     cd docs
     giza generate assets
     git remote add upstream [email protected]:mongodb/docs.git
 ---
 title: "Clone and prepare MongoDB Primer documentation."
-stepnum: 5
 ref: clone-docs-primer
-pre: |
-
 action:
   language: sh
   code: |
-  	git clone [email protected]:<yourid>/docs-primer.git
+    git clone [email protected]:<yourid>/docs-primer.git
     cd docs-primer
     git remote add upstream [email protected]:mongodb/docs-primer.git
 ---
 title: "Clone and prepare the Cloud/Ops Manager documentation."
-stepnum: 6
 ref: clone-mms-docs
-pre: |
-
 action:
   language: sh
   code: |
-  	git clone [email protected]:<yourid>/mms-docs.git
+    git clone [email protected]:<yourid>/mms-docs.git
     cd mms-docs
     git remote add upstream [email protected]:10gen/mms-docs.git
 ---
 title: "Clone and prepare the Atlas documentation."
-stepnum: 7
 ref: clone-cloud-docs
-pre: |
-
 action:
   language: sh
   code: |
-  	git clone [email protected]:<yourid>/cloud-docs.git
+    git clone [email protected]:<yourid>/cloud-docs.git
     cd cloud-docs
     git remote add upstream [email protected]:10gen/cloud-docs.git
 ---
 title: "Clone and prepare the BI Connector documentation."
-stepnum: 8
 ref: clone-bi-docs
-pre: |
-
 action:
   language: sh
   code: |
     git clone [email protected]:<yourid>/docs-bi-connector.git
     cd docs-bi-connector
     git remote add upstream [email protected]:10gen/docs-bi-connector.git
----
-title: "If you want to be able to work from a local development copy of giza (optional):"
-stepnum: 9
-ref: 
-pre: |
-
-action:
-  language: sh
-  code: |
-  	sudo pip uninstall giza
-    cd docs-tools/giza
-    sudo python ./setup.py develop
-...
+...

source/includes/steps-create-ssh-key.yaml

@@ -1,5 +1,4 @@
 title: "Generate the certificate and follow the prompts. "
-stepnum: 1
 ref: generate-certificates
 pre: |
   When you are asked to name the file, you must provide the full path as well.
@@ -8,44 +7,40 @@ pre: |
 action:
   language: sh
   code: |
-  	ssh-keygen -t rsa -b 4096 -C "[email protected]"
+    ssh-keygen -t rsa -b 4096 -C "[email protected]"
 ---
 title: "Set the certificate permissions."
-stepnum: 2
 ref: set-cert-perms
 pre: |
   Change to the default user directory for SSH certificates. Change the 
   permissions for the certificate to owner read/write only.
 action:
   language: sh
   code: |
-  	cd ~/.ssh/
+    cd ~/.ssh/
     chmod 600 <name>.pub
 ---
 title: "Enable SSH password management."
-stepnum: 3
 ref: enable-ssh-passwords
 pre: |
   This is supposed to be enabled by default on MacOS X systems.
 action:
   language: sh
   code: |
-  	eval ``ssh-agent``
+    eval ``ssh-agent``
 ---
 title: "Add your certificate to the SSH password manager."
-stepnum: 4
 ref: add-cert-to-ssh
 pre: |
 action:
   language: sh
   code: |
-  	ssh-add
+    ssh-add
 post: "Enter the password for the certificate."
 ---
 title: "Add this certificate to your GitHub account."
-stepnum: 5
 ref: add-cert-to-github
 content: |
   For specific instructions, see 
   `GitHub <https://help.github.com/articles/adding-a-new-ssh-key-to-your-github-account/>`_.
-...
+...

source/includes/steps-get-aws-keys.yaml

@@ -1,12 +1,10 @@
 title: "Login to your AWS Account."
-stepnum: 1
 ref: login-aws
 content: |
   Login to `AWS for the Education department <https://idp.mongodb.com/simplesaml/saml2/idp/SSOService.php?spentityid=urn:amazon:webservices:univ-training-991734710418>`_.
 
 ---
 title: "Connect to your AWS Instance."
-stepnum: 2
 ref: connect-aws-instance
 content: |
 
@@ -18,7 +16,6 @@ content: |
 
 ---
 title: "Choose or create an SSH Key (if needed)."
-stepnum: 3
 ref: create-ssh-key
 content: |
   
@@ -30,21 +27,19 @@ content: |
 
 ---
 title: "Copy this key file to your SSH certificate directory."
-stepnum: 4
 ref: copy-ssh-key
 pre: |
 action:
   language: sh
   code: |
-  	cp yourawscert.pem ~/.ssh/
+    cp yourawscert.pem ~/.ssh/
 ---
 title: "Change the ownership of this key file."
-stepnum: 5
 ref: update-key-permissions
 pre: |
   The key file must only be readable by you.
 action:
   language: sh
   code: |
-  	chmod 600 ~/.ssh/yourawscert.pem
-...
+    chmod 600 ~/.ssh/yourawscert.pem
+...

source/includes/steps-install-aws-keys.yaml

@@ -1,10 +1,7 @@
 title: "Login to Cloud Manager."
-stepnum: 1
 ref: login-cloud-manager-1
-
 ---
 title: "Set billing information."
-stepnum: 2
 ref: set-billing
 content: |
   
@@ -22,7 +19,6 @@ content: |
 
 ---
 title: "Complete the AWS Configuration."
-stepnum: 3
 ref: create-aws-config
 content: |
 
@@ -63,7 +59,5 @@ content: |
 
 ---
 title: "Click :guilabel:`Add`."
-stepnum: 4
 ref: click-add
-
-...
+...

source/includes/steps-install-noc-keys.yaml

@@ -1,20 +1,14 @@
 title: "Create a giza AWS configuration file in your home config directory."
-stepnum: 1
 ref: create-aws-config
-pre: |
-
 action:
   language: sh
   code: |
     mkdir -m 755 -p ~/.config
-  	vi ~/.config/giza-aws-authentication.conf
+    vi ~/.config/giza-aws-authentication.conf
 
 ---
 title: "Add an ``[authentication]`` block in your configuration file."
-stepnum: 2
 ref: add-auth-block
-pre: |
-
 action:
   language: ini
   code: |
@@ -27,17 +21,12 @@ action:
 
 ---
 title: "Save your configuration file."
-stepnum: 3
 ref: save-aws-config-file
-
 ---
 title: "Set this file to be owner readable."
-stepnum: 4
 ref: make-owner-readable
-pre: |
-
 action:
   language: sh
   code: |
-  	chmod 600 ~/.config/giza-aws-authentication.conf
-...
+    chmod 600 ~/.config/giza-aws-authentication.conf
+...

source/includes/steps-install-prereqs.yaml

@@ -1,5 +1,4 @@
 title: "Download and Install XCode."
-stepnum: 1
 ref: install-xcode
 content: |
   This is required for some development capabilities on a Mac OS system.
@@ -8,7 +7,6 @@ content: |
 
 ---
 title: "Download and Install Inkscape."
-stepnum: 2
 ref: install-inkscape
 content: |
   
@@ -19,14 +17,13 @@ content: |
 
 ---
 title: "Download and Install Homebrew."
-stepnum: 3
 ref: install-homebrew
 pre: |
   This is required to install certain development tools including MongoDB itself.
 action:
   language: sh
   code: |
-  	/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
     brew update
     brew doctor
 
@@ -36,18 +33,14 @@ post: |
      More information on `Homebrew <http://brew.sh/>`_ can be found online.
 ---
 title: "Install Python and Python 3."
-stepnum: 4
 ref: install-python
-pre: |
-
 action:
   language: sh
   code: |
-  	brew install python
+    brew install python
     brew install python3
 ---
 title: "Install MongoDB Version Manager."
-stepnum: 5
 ref: install-m
 pre: |
   Install https://github.com/aheckmann/m[MongoDB Version Manager]
@@ -63,21 +56,17 @@ action:
   heading: "Install MongoDB Version Manager."
   language: sh
   code: |
-  	sudo npm install -g m
+    sudo npm install -g m
   post: |
     .. note:: See https://github.com/aheckmann/m[MongoDB Version Manager] for more information on how to install versions of MongoDB.
 ---
 title: "Install a specific version, edition or platform."
-stepnum: 6
 ref: install-mongodb
 content: |
   If you need a specific version, edition or platform of MongoDB, check the Private Build list for https://corp.10gen.com/dlBrowse?os=osx[OS X], https://corp.10gen.com/dlBrowse?os=linux[Linux] or https://corp.10gen.com/dlBrowse?os=win32[Windows].
 ---
 title: "Install Documentation Building Tools."
-stepnum: 7
 ref: install-giza
-pre: |
-
 action:
   heading: "Install Giza Pre-Requisites"
   language: sh
@@ -91,14 +80,14 @@ action:
   heading: "Install Giza."
   language: sh
   code: |
-  	sudo pip install giza
+    sudo pip install giza
 
 action:
   heading: "Install Mut."
   language: sh
   code: |
-  	bash -c "$(curl -fsSL https://raw.githubusercontent.com/i80and/mut/master/install.sh)"
+    bash -c "$(curl -fsSL https://raw.githubusercontent.com/mongodb/mut/master/install.sh)"
 
 post: |
   .. note:: More information on ``mut`` can be found on the https://docs-mongodbcom-staging.corp.mongodb.com/mut/tutorial/installation.html[mut guide].
-...
+...