add introductory and interface documentation

.gitlab-ci.yml not found in this commit