update discovery API with full REST paths and types. (#597)
update discovery API with full REST paths and types. (#597)

* update discovery API with full REST paths and types.

Signed-off-by: Mike Helmick <7921dc6140489a964ef17e5ff716719a1d9a8d47@google.com>

* fix typo

Signed-off-by: Mike Helmick <7921dc6140489a964ef17e5ff716719a1d9a8d47@google.com>

* address review comments.

Signed-off-by: Mike Helmick <7921dc6140489a964ef17e5ff716719a1d9a8d47@google.com>

* a few cleanups on wording

Signed-off-by: Mike Helmick <7921dc6140489a964ef17e5ff716719a1d9a8d47@google.com>
cloudevents/spec