Split mkdocs build and deploy into separate jobs

Created on 29 March 2025, 3 months ago

Problem/Motivation

The results of mkdoc build cannot be seen without merging into the default branch. It would be nice to be able to preview changes.

Steps to reproduce

  • Create an issue fork repository.
  • Make changes to documentation in the /docs directory.
  • Push your changes to your forked repository.
  • The mkdocs job will not run and you cannot see your changes.

Proposed resolution

Separate the mkdocs build and the GitLab pages deploy into two jobs so the build results can be seen in the artifact browser.

Ideally, the changes would be deployed using GitLab Pages to a separate URL that doesn't overwrite the deployment from the default branch, but I don't know if this is possible.

Remaining tasks

  • Separate the current job into a build job and a deploy job.

User interface changes

The pipelines in GitLab will change slightly.

πŸ“Œ Task
Status

Active

Version

1.0

Component

Other

Created by

πŸ‡ΊπŸ‡ΈUnited States alexdmccabe Orlando, FL, US / Seminole lands

Live updates comments and jobs are added and updated live.
Sign in to follow issues

Merge Requests

Comments & Activities

Production build 0.71.5 2024