Documentation improvements

Add more examples to some api dict types and include the
definition of more enums.

Change-Id: Ib9a0f2b738670feada65268570d234c0e00f43cd