Root: Update and improve README.md
Compiler: Update and improve README.md with usage, and an example
Compiler: Fix some comment inconsistencies