Skip to content

docs: delete unlisted pages and their screenshots - #30758

Merged
nickvigilante merged 9 commits into
mainfrom
vigilante/docs-delete-unlisted-pages
Oct 14, 2026
Merged

nickvigilante merged 9 commits into
mainfrom
vigilante/docs-delete-unlisted-pages

Conversation

@nickvigilante

Copy link
Copy Markdown
Collaborator

Deletes seven docs files and 10 screenshots that are not in the docs manifest and are superseded or empty:

  • docs/about/why-coder.md: a TODO stub. The one link to it, a "Do" example in the style guide, now names its source in plain text.
  • docs/tutorials/example-guide.md: a contributor template with no inbound links. Its guidance is recorded in DOCS-1207 for a tutorial section in contributing/documentation.md, which is still to write.
  • docs/start/first-template.md and six step 6 screenshots in docs/images/templates/. Content is cataloged in DOCS-1209 for the Templates landing page.
  • docs/start/first-workspace.md and three screenshots in docs/images/start/. Content is cataloged in DOCS-1208 for the Workspaces landing page.
  • docs/start/local-deploy.md and docs/images/start/setup-page.png. Redundant with get-started/ and install/cli.md.

The deleted files stay recoverable at adcce66826.

This replaces #30710, #30711, #30712, #30713 and #30714, which are closed in favor of this PR.

Linear: DOCS-1205, DOCS-1206, DOCS-1207, DOCS-1211, DOCS-1212. Related: DOCS-1208, DOCS-1209.

I ran lint/docs-html, lint/docs-manifest, lint/docs-redirects and lint/emdash locally.

Generated by Coder Agents on behalf of @nickvigilante.

The page contained only a TODO and was not in the docs manifest. The style guide example that linked to it now names its source in plain text. Refs DOCS-1206.
The page is a contributor template that was never listed in the manifest. Its guidance is recorded in DOCS-1207 for the follow-up that adds a tutorial section to contributing/documentation.md. Refs DOCS-1207.
The page was removed from the manifest and is superseded by get-started. Its content is cataloged in DOCS-1209 for the Templates landing page. Refs DOCS-1211.
Only the deleted first-template page used these. The Templates landing page will retake them. Refs DOCS-1211.
The page was removed from the manifest and is superseded by get-started. Its content is cataloged in DOCS-1208 for the Workspaces landing page. Refs DOCS-1212.
Only the deleted first-workspace page used these. The Workspaces landing page will retake them. Refs DOCS-1212.
The page was removed from the manifest and is redundant with get-started and install/cli. Stacked on the first-template deletion, which held the only link to it. Refs DOCS-1205.
Only the deleted local-deploy page used it. Refs DOCS-1205.
@linear-code

linear-code Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

@nickvigilante
nickvigilante marked this pull request as ready for review October 14, 2026 14:44
@coderagents

coderagents Bot commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Documentation Check

Updates Needed

  • docs/.style/style-guide/word-choice.md - Line 452 still links to the deleted docs/about/why-coder.md in the "Do" example under the weasel-words rule. The PR body says this link now "names its source in plain text," but the diff does not change word-choice.md, so after merge the link points at a deleted file and 404s. Drop the link for plain text, or point it at the intended source. (Contributor-facing style guide; not in the docs nav, so no published URL.) (Addressed: the link is now plain text, verified at head 82a5923.)

Automated review via Coder Agents

@matifali matifali left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🧹

@nickvigilante
nickvigilante merged commit 935e076 into main Oct 14, 2026
30 checks passed
@nickvigilante
nickvigilante deleted the vigilante/docs-delete-unlisted-pages branch October 14, 2026 18:04
@github-actions github-actions Bot locked and limited conversation to collaborators Oct 14, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants