Cleanup some docs (maintenance)

- Fixed spacing inside docs
- Makes beginning of @param/@return in capital

Change-Id: I864b8b3f1f67e34e369aba7aadaf87e7752c894d
Merge "Cleanup some docs (maintenance)"