Add new sample API Descriptor for use in other documentation.
Add state-machine design documentation
Update readme
Fix rake command
Add sample hypermedia contract
fix broken links
Merge pull request #199 from mdsol/feature/state_machine_design_docs

Merged!