Proofreading pass: Fix typos, add links.
Merge pull request #1509 from roberthbailey/auth

Proofreading pass: Fix typos, add links.
Require namespace on controller, pod, service objects
Update test cases to use default context
Fix examples test by setting a context prior to validation
Update schemas for api docs
Updates to review comments