improving docs format and syntax
Merge pull request #641 from caelum/improvingSiteStyle

improving docs format and syntax