Another round of doc updates
Evolve restbase handler spec

- Added declarative handler syntax example based on Swagger 2.0 / Yaml. Longer
  term plan is to spec new entry points using this rather than requiring each
  team to write fairly repetitive code.
- Cleaned up the architecture document somewhat; moved use cases to use case
  doc.