Documentation and Specs for Contribution api, refs #4 and closes #10