use the trick of copying the rst doc as README.rst in the repo root,

so that README appears in the project front page of a public repo
.gitlab-ci.yml not found in this commit