...
- Javadoc exists for all public interfaces (Package, Class, Method)
- RESTful interfaces are well documented in RAML. Every parameter and return has a JSON schema. JSON schemas are defined in their own JSON files and put in the schemas subfolder.
- Documentation explains why something exists over how it works
- Documentation covers edge cases and lays out the contract - success, error, exception.
- README introduces the purpose of the services and guides developers in getting started.
...