Update documentation; spec out request and response interfaces

* Merge thoughts about data flow & merging of Rashomon & Restface

* Spec basic handler request & response interfaces

* First spec of HTTP transaction schema.