new readme.md and disambiguation of layer types