GitLab/Publishing docs

Policy Migration status Workflows Project setup assumptions Registering an account on GitLab Hosting a project on GitLab Pipeline conversion Mirroring projects Configuring CI Publishing documentation Code review Making a merge request Squashing Managing security patches Deploying services to production Gerrit to GitLab Localization updates wikitech:GitLab GitLab implementation

Docpub offers two GitLab CI templates you can include in your .gitlab-ci.yml to build and publish your docs to doc.wikimedia.org.

You can use docpub to publish your project's documentation or test coverage reports. Docs will be published by default under the same path as your GitLab project; in the case of test reports an extra cover/ prefix will be added. See the README for more details.

Scap and Blubber repositories contain usage examples.

In order to be able to trigger the docpub pipeline, your project needs to be added to the list of allowed projects. Best person to contact about this is Jaime Nuche, but anyone in Release Engineering should be able to help you.

By default, new projects in GitLab are configured with an enabled public pipeline. Do not disable this setting or your doc publishing will fail.

Migrating from Gerrit

If you were already publishing your docs/coverage using the Zuul/Jenkins infrastructure, you should also take care of updating any references in the following places:

• In the docroot listing if your project has an entry there
• Any pages of https://www.mediawiki.org or https://wikitech.wikimedia.org

Once that is done, contact Jaime Nuche or someone in Release Engineering about removing the old docs.