docs: clarified the part about sections, fixed a grammar mistake and fixed a small styling issue
Merge pull request #39 from boxed/master

Some small updates to the docs