Updating Capabilities Armature

The main document was previously a long description of something
more like philosophy, and now it's a more clear description
of what I think we should do and why, with examples.

Note that the Armature templates do not actually talk about content
itself.  They talk about some basics, but you can't take the templates
and usefully build an armature from them.

Signed-off-by: Luke Kanies <luke@puppetlabs.com>