Functions documentation cleanup.

- Switched to definition lists for parameters to be consistent
  with generated resource docs
- Make consistent the layout of literal blocks and returns
- Other minor grammatical and layout fixes

Change-Id: I62eb179ce2a20024d2195cc7eb88e2e79bd4ae68
Merge "Functions documentation cleanup."