Skip to content

docs: mark unpublished docs pages as draft - #32351

Draft
nickvigilante wants to merge 2 commits into
mainfrom
vigilante/docs-1779-mark-the-opentofu-page-as-draft-and
Draft

nickvigilante wants to merge 2 commits into
mainfrom
vigilante/docs-1779-mark-the-opentofu-page-as-draft-and

Conversation

@nickvigilante

@nickvigilante nickvigilante commented Nov 17, 2026 •

Copy link
Copy Markdown
Collaborator

Two pages under docs/ aren't in the docs manifest, so they aren't published. This PR adds draft: true to their front matter so their unpublished state is explicit:

  • docs/admin/integrations/opentofu.md: a placeholder for custom Terraform binaries.
  • docs/templates/extending-templates/external-auth.md: the template-author external-auth page, which has never been in the manifest. DOCS-1213 tracks refreshing it and adding it to the sidebar.

The glossary's OpenTofu entry links to the OpenTofu page, so readers who follow that link on coder.com/docs/reference/glossary get a 404. Linkspector doesn't catch it because the linked file exists in the repository. This PR removes that link, which is the only link to either page in the repository. coder/coder.com has no links to them either.

The docs tooling doesn't read draft: yet, and docs-engine drops front matter keys it doesn't know, so nothing changes in the build. DOCS-1412 tracks defining the key and checking it against the manifest, and DOCS-1780 tracks failing the link check on links to draft pages.

Production serves release/2.39 as the mainline version, and that branch has the same glossary link, so this PR has the cherry-pick label. A local git merge-tree of this branch onto release/2.39 applies cleanly, and rename detection puts the external-auth change on that branch's older path, docs/admin/templates/extending-templates/external-auth.md.

Checks run locally: make lint/docs-manifest lint/docs-html lint/docs-redirects lint/emdash lint/style-claims, markdownlint, markdown-table-formatter, and Vale on the changed files. All pass.

Linear: DOCS-1779

Note

Generated by Coder Agents on behalf of @nickvigilante.

The OpenTofu page is a placeholder that was never added to the docs
manifest, so it is not published, and the glossary link to it 404s on
coder.com. Linkspector does not catch the broken link because the file
exists in the repository.

Mark the page with draft: true so its unpublished state is explicit,
and remove the only link to it.

DOCS-1779
@nickvigilante
nickvigilante temporarily deployed to main November 17, 2026 22:53 — with GitHub Actions Inactive
@nickvigilante
nickvigilante temporarily deployed to main November 17, 2026 22:53 — with GitHub Actions Inactive
@linear-code

linear-code Bot commented Nov 17, 2026

Copy link
Copy Markdown

DOCS-1779

The template-author external-auth page has never been in the docs
manifest, so it is not published. Mark it with draft: true until it is
refreshed and added to the sidebar.

DOCS-1779
@nickvigilante nickvigilante changed the title docs: mark the OpenTofu page as draft and remove links to it docs: mark unpublished docs pages as draft Nov 17, 2026
@nickvigilante
nickvigilante temporarily deployed to main November 17, 2026 22:59 — with GitHub Actions Inactive
@nickvigilante
nickvigilante temporarily deployed to main November 17, 2026 23:00 — with GitHub Actions Inactive

This branch was previously deployed

1 inactive deployment
main — d3a5a015 Deployed Nov 17, 2026 by nickvigilante via cla #259010
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant