Add README file documenting the repo structure and the YAML schema.
Closes #1 (closed)
Refs https://gitlab.com/gitlab-org/gitlab-ee/issues/11169