Skip to content

Migrate documentation automation to Depot CI - #4362

Merged
marccampbell merged 2 commits into
mainfrom
migrate-depot-ci
Aug 13, 2026
Merged

Migrate documentation automation to Depot CI#4362
marccampbell merged 2 commits into
mainfrom
migrate-depot-ci

Conversation

@marccampbell

@marccampbell marccampbell commented Aug 12, 2026

Copy link
Copy Markdown
Member

Summary

  • replace nine GitHub Actions workflows with three Depot CI workflows for PR checks, main-branch automation, and release notes
  • prevent all fork PR jobs from running; same-repository PRs only
  • replace Dependabot with a weekly Factory dependency-update workflow
  • keep the Factory workspace definition out of this repository; it now lives in replicatedhq/factory-workspaces#13
  • pin retained action and tool dependencies and move release-note generation and Vale review into auditable scripts
  • add the missing Replicated SDK release-notes insertion marker used by the automation

External configuration completed

  • granted the existing Depot Code Access installation access to only replicatedhq/replicated-docs in addition to its prior allowlist
  • imported all 11 required GitHub Actions secrets as Depot variants scoped to replicatedhq/replicated-docs
  • reused the existing Depot organization Factory token
  • removed the temporary one-shot migration branch after a successful transfer

Validation

  • depot ci migrate preflight --yes
  • pinned actionlint against all three Depot workflows
  • shell syntax and YAML parsing
  • all six release-note event mappings plus empty-output behavior
  • pinned release-notes generator compilation
  • npm ci
  • npm run build
  • live Depot PR checks for labeling, Vale, and Factory workflow validation
  • git diff --check

The Docusaurus build passes with the repositories existing broken-link and broken-anchor warnings.

Merge order

Merge replicatedhq/factory-workspaces#13 first so the replicated-docs workspace exists before this PR publishes its dependency workflow. This PR is intentionally not merged.

@marccampbell
marccampbell requested a review from a team as a code owner August 12, 2026 12:53
@netlify

netlify Bot commented Aug 12, 2026

Copy link
Copy Markdown

Deploy Preview for replicated-docs ready!

Name Link
🔨 Latest commit 63de63f
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs/deploys/6a7c6e5ff41e86000841986b
😎 Deploy Preview https://deploy-preview-4362--replicated-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify

netlify Bot commented Aug 12, 2026

Copy link
Copy Markdown

Deploy Preview for replicated-docs-upgrade ready!

Name Link
🔨 Latest commit 63de63f
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs-upgrade/deploys/6a7c6e5f11739f00076740a0
😎 Deploy Preview https://deploy-preview-4362--replicated-docs-upgrade.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@replicated-ci replicated-ci added type::docs Improvements or additions to documentation type::feature labels Aug 12, 2026
@xavpaice

Copy link
Copy Markdown
Member

See https://github.com/replicatedhq/factory-workspaces/pull/12 if we want to move the factory workflow out of this repo

@marccampbell
marccampbell merged commit 16d0500 into main Aug 13, 2026
7 checks passed
@marccampbell
marccampbell deleted the migrate-depot-ci branch August 13, 2026 17:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type::docs Improvements or additions to documentation type::feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants