Document interfaces and expand on workflow examples.

Define swagger schema for our apis.

Document api functionality and make sure we do not break it (integration, system tests).

Document class diagrams and define responsibilities and dependencies.