Some small updates to the docs

docs: clarified the part about sections, fixed a grammar mistake and fixed a small styling issue