Skip to content

docs(site): fix codemods file layout and add registered codemods table#694

Merged
jamesadevine merged 1 commit into
mainfrom
docs/fix-codemods-file-layout-5f72b6082256d97e
May 22, 2026
Merged

docs(site): fix codemods file layout and add registered codemods table#694
jamesadevine merged 1 commit into
mainfrom
docs/fix-codemods-file-layout-5f72b6082256d97e

Conversation

@github-actions
Copy link
Copy Markdown
Contributor

Summary

  • The "File layout" section in the codemods reference listed three fabricated example files that don't exist in the codebase. Readers following along would be confused when the files weren't there.
  • Added a new "Registered codemods" table near the top so users can immediately see which codemods are active without reading through the full contributor section.

Changes

  • site/src/content/docs/reference/codemods.mdx:
    • Replaced fake filenames (0001_engine_id_split.rs, 0002_permissions_field.rs, 0003_safeoutput_renames.rs) with the actual files (0001_repos_unified.rs, 0002_pool_object_form.rs) and their real inline comments.
    • Added "Registered codemods" table listing both live codemods with ID, summary, and introduced_in version.

Accuracy checks

  • src/compile/codemods/ directory listing: exactly mod.rs, helpers.rs, 0001_repos_unified.rs, 0002_pool_object_form.rs.
  • 0001_repos_unified::CODEMOD: id = "repos_unified", summary = "repositories: + checkout: -> unified repos:", introduced_in = "0.28.0".
  • 0002_pool_object_form::CODEMOD: id = "pool_object_form", summary = "pool: <string> -> pool object form (name/vmImage)", introduced_in = "0.30.0" (INTRODUCED_IN const).
  • mod.rs registry: CODEMODS = [&m0001_repos_unified::CODEMOD, &m0002_pool_object_form::CODEMOD].

Validation

  • cd site && npm ci && npm run build — 29 pages built, all internal links valid.

Created by the docs-writer workflow.

Generated by Docs Writer · ● 15.1M ·

- Replace the three fabricated example filenames (0001_engine_id_split.rs,
  0002_permissions_field.rs, 0003_safeoutput_renames.rs) in the File layout
  section with the actual files in src/compile/codemods/ with their real
  comments.
- Add a 'Registered codemods' table near the top listing the two live
  codemods (repos_unified, pool_object_form) with their IDs, summaries, and
  introduced-in versions, verified against src/compile/codemods/*.rs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot mentioned this pull request May 22, 2026
@jamesadevine jamesadevine marked this pull request as ready for review May 22, 2026 13:27
@jamesadevine jamesadevine merged commit b89f28f into main May 22, 2026
@jamesadevine jamesadevine deleted the docs/fix-codemods-file-layout-5f72b6082256d97e branch May 22, 2026 13:27
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.

1 participant