Skip to content

Replace outdated workflow with validation#300

Merged
bb220 merged 5 commits into
masterfrom
codex/remove-broken-github
May 19, 2026
Merged

Replace outdated workflow with validation#300
bb220 merged 5 commits into
masterfrom
codex/remove-broken-github

Conversation

@bb220
Copy link
Copy Markdown
Collaborator

@bb220 bb220 commented May 19, 2026

What changed

Replaced the stale docs updater setup with a focused docs validation workflow.

Removed:

  • .github/CODEOWNERS
  • .github/workflows/update-docs.yml
  • DOCS_UPDATER_SETUP_TODO.md
  • The duplicated local validation command block from AGENTS.md

Added:

  • .github/workflows/docs-validation.yml

The new workflow runs on pull requests into master and can also be triggered manually. It checks:

jq empty docs.json
jq empty openapi.json
mint broken-links
mint validate

Why

The old GitHub Actions setup was outdated and broken. This keeps PR validation lightweight and docs-focused: JSON syntax checks for the core config/spec files, link checking, and Mintlify build validation. Since these checks now run in CI, the agent review guide no longer needs to ask reviewers to run that command block manually.

Validation

Ran locally:

jq empty docs.json
jq empty openapi.json
mint broken-links
mint validate

All checks passed. mint validate needed access to refresh Mintlify's local cache, then completed successfully.

@bb220 bb220 marked this pull request as ready for review May 19, 2026 14:05
@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 19, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
promptlayer 🟢 Ready View Preview May 19, 2026, 2:06 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e5c861d495

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment on lines -17 to -20
cancel-in-progress: false

jobs:
update-docs:
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Update the remaining updater setup guide

@claude Removing the workflow leaves the tracked DOCS_UPDATER_SETUP_TODO.md instructions pointing at .github/workflows/update-docs.yml as deployed and telling maintainers to run gh workflow run update-docs.yml; with this entrypoint gone, anyone following the setup/test guide will fail to trigger the documented automation. Please either keep a replacement workflow or update/remove that setup guide alongside this deletion.

Useful? React with 👍 / 👎.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@claude remove that setup guide as well

@bb220 bb220 changed the title [codex] Remove outdated GitHub configuration Remove outdated workflow May 19, 2026
@bb220 bb220 changed the title Remove outdated workflow [codex] Remove outdated GitHub docs updater files May 19, 2026
@bb220 bb220 changed the title [codex] Remove outdated GitHub docs updater files Remove outdated workflow files May 19, 2026
@bb220 bb220 changed the title Remove outdated workflow files [codex] Replace outdated docs updater with validation workflow May 19, 2026
@bb220 bb220 changed the title [codex] Replace outdated docs updater with validation workflow Replace outdated docs updater with validation workflow May 19, 2026
@bb220 bb220 changed the title Replace outdated docs updater with validation workflow Replace outdated workflow with validation May 19, 2026
Comment thread .github/workflows/docs-validation.yml Fixed
@bb220 bb220 merged commit a7e4128 into master May 19, 2026
5 checks passed
@bb220 bb220 deleted the codex/remove-broken-github branch May 19, 2026 15:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants