suzanne's edits: first pass (#207)
suzanne's edits: first pass (#207)

* suzanne's edits: first pass

* links fixes

* typo fix

* fixed codeblocks, small edits

tobilg/dcos-commons,mesosphere/dcos-commons,mesosphere/dcos-commons,tobilg/dcos-commons,mesosphere/dcos-commons,comptelfwd/dcos-commons,comptelfwd/dcos-commons,vishnu2kmohan/dcos-commons,adragomir/dcos-commons,mesosphere/dcos-commons,tobilg/dcos-commons,adragomir/dcos-commons,tobilg/dcos-commons,mesosphere/dcos-commons,comptelfwd/dcos-commons,vishnu2kmohan/dcos-commons,vishnu2kmohan/dcos-commons,adragomir/dcos-commons,comptelfwd/dcos-commons,adragomir/dcos-commons,vishnu2kmohan/dcos-commons,tobilg/dcos-commons,comptelfwd/dcos-commons,comptelfwd/dcos-commons,vishnu2kmohan/dcos-commons,adragomir/dcos-commons