Add README file
Update core documentation

This commit fixes some mistakes in the documentation of the core
component.