Renaming main.md -> capabilities.md, and fixing some markup

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