doc: ReST syntax changes to improve readability

- use blockquote when needed
- use more ReST syntax when possible (note, anchor, url, etc)

Change-Id: I3ebd63bb747d0e459351fb264b2ceca3e45925a5
Merge "doc: ReST syntax changes to improve readability"