Put text descriptions next to yaml examples

[mrbojangles3]

When a customer is building a yaml file or referencing a part of the docs, eg VPC remote peering, the description and the yaml should be in the same section.