Fix #340. Add warning to OAuth document.

Also added other minor documentation changes.