Explain parser behaviour and format rules

Explain some of the format rules and parser behaviour
in the README file.

This commit also fixes a minimal typo in the render-test-case
comments.

Signed-off-by: Luis Araujo <luis.araujo@collabora.co.uk>