first draft docs complete [ci-skip]