enhance readme

- split sections into smaller ones.
- move comments in the sample code out of the code block to the
description of the section.