Docs: Improve input and output validation docs

[sinclairnick]

Need to improve the documentation for input and output validation.

• Describe how inputs are a) parsed (even without schema) and b) validated
• Describe how return values are(nt) validate wrt Response return
• Describe how typescript, openapi are affected by specifying schema