Improving some docs format

from:

![before](https://cloud.githubusercontent.com/assets/1529021/3259528/c6863d86-f244-11e3-9973-60f84559f5e8.png)

to:

![after](https://cloud.githubusercontent.com/assets/1529021/3259530/cd91396e-f244-11e3-9660-b27c5229bb68.png)

what do you think?