Rework resource types

Headers and responses on resources should be closer to correct now.
Clean up descriptions somewhat

Also remove some things made redundant by last commit.
Merge pull request #17 from awlayton/raml/v0_2

Raml/v0 2