Adds 'discussion' field to metadata.json
Add ARM-9 sections answering 'Why'
Merge branch 'hlindberg-master'

Closes #58
(ARM-9) Correct typos

This corrects a small number of typos and missing words as well as some
artifacts that crept in when converting the text from google docs to
markdown.
Added ARM-15
Updated documentation for ARM-15
Merge pull request #60 from hickey/master

ARM-15 - Puppet master state
Added discussion links for ARM-15
(ARM-9) Remove backslashes inserted by text converesion

When the text was translated from google doc backslashes were inserted
into the text. Some of those where not removed in examples leading
people to enter things that failed with syntax errors (probably from
within yaml parser).
(arm-9) Fix typos in yaml

A yaml example was not valid yaml, (it is : not => in a yaml hash).
(arm-2) Update ARM-2 Iteration to reflect implementation in Puppet 3.4
Update index for ARM-2 to show it is version 2.0.0

The ARM was updated with the changes for Puppet 3.4.
The public scrutiny and UX testing that has taken place since
the last publication should be enough for this to go straight to
versio 2.0.0.