docs: migrate Transformations per docs revamp#9155
Merged
yjouffrault merged 3 commits intodemo/groups-diataxis-examplefrom May 7, 2026
Merged
docs: migrate Transformations per docs revamp#9155yjouffrault merged 3 commits intodemo/groups-diataxis-examplefrom
yjouffrault merged 3 commits intodemo/groups-diataxis-examplefrom
Conversation
Hub + 2 recipe-form how-tos + 2 tutorial extractions (matching Generators PR precedent). - transformations/index.mdx: hub from topics/transformation.mdx with cross-links updated and a Learn-by-doing section pointing to both new academy tutorials - transformations/jinja2.mdx: NEW recipe-form how-to with placeholder-style examples - transformations/python.mdx: NEW recipe-form how-to with placeholder-style examples - academy/tutorials/transformations/build-a-jinja2-transformation.mdx: extracted from guides/jinja2-transform.mdx with consolidated tutorial framing - academy/tutorials/transformations/build-a-python-transformation.mdx: extracted from guides/python-transform.mdx with consolidated tutorial framing - sidebars.ts: re-point Transformations sub-cat at new paths with concise spoke labels (Jinja2 / Python); add academy tutorials - redirects-pending/transformations.yml: 3 redirects + 23 cross-links to update at cleanup Voice rules applied per the migrate-feature-page skill: no "this page", no "canonical" jargon, "Transformation" capitalized as a branded term in prose and link text. Five preserved-content "just" usages from the legacy guides rewritten on extraction. GraphQL fragments relocation deferred to a future Development Resources migration per the Confluence recommendation. Legacy files (topics/transformation.mdx, guides/jinja2-transform.mdx, guides/python-transform.mdx) remain on disk during iteration; deleted in the cleanup PR. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
github-actions
Bot
added
the
type/documentation
wvandeun
approved these changes
May 6, 2026
wvandeun
force-pushed
the
docs/migrate-transformations
branch
from
d91ce34 to
d769201
Compare
yjouffrault
added a commit
that referenced
this pull request
May 7, 2026
Hub + 2 spokes (no tutorial extraction — guides are short enough to reframe in place per the Confluence recommendation). - artifacts/index.mdx: hub from topics/artifact.mdx with cross-links updated and a new "How artifacts relate to other features" conceptual section - artifacts/use.mdx: reframed from guides/artifact.mdx — "Step N:" prefixes dropped, Prerequisites condensed to a one-line assumption note, action-named section headers - artifacts/content-composition.mdx: moved from guides/artifact-content-composition.mdx with cross-link updates only - sidebars.ts: re-point Artifacts sub-cat at new paths - redirects-pending/artifacts.yml: 3 redirects + 9 cross-links to update at cleanup Skill update: add a "What needs reviewer attention" section to the PR description template so future migration PRs tell the reviewer up front which lines are net-new prose vs. preserved content with cross-link updates. Cross-links to Transformations use legacy paths (../topics/transformation, ../guides/jinja2-transform, ../guides/python-transform) until the open Transformations PR (#9155) merges into base. They will resolve via that PR's redirects once merged, then need rebase/cleanup at end of phase 2. Legacy files (topics/artifact.mdx, guides/artifact.mdx, guides/artifact-content-composition.mdx) remain on disk during iteration; deleted in the cleanup PR. Co-authored-by: Yvonne <yvonne@opsmill.com> Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
yjouffrault
merged commit 2d02f77
into
demo/groups-diataxis-example
8 of 9 checks passed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Migrate the Transformations feature per the Infrahub docs revamp (Confluence recommendations).
Pattern: hub + 2 recipe-form how-tos + 2 academy tutorials extracted (matching the Generators PR precedent).
Content changes
transformations/index.mdx): topic content fromtopics/transformation.mdx, with cross-links updated and a "Learn by doing" section pointing to both new academy tutorials.transformations/jinja2.mdx: NEW recipe-form how-to. Drafted from the Confluence proposal, with voice rules applied (no "this page covers...", no "canonical").transformations/python.mdx: NEW recipe-form how-to. Same pattern.academy/tutorials/transformations/build-a-jinja2-transformation.mdx: extracted fromguides/jinja2-transform.mdx(the device-config running example). Tutorial framing added: consolidated "By the end of this tutorial..." opener and "What you learned" closer matching the established academy precedent.academy/tutorials/transformations/build-a-python-transformation.mdx: extracted fromguides/python-transform.mdx. Same framing.Sidebar
Automation & Outputs > Transformationssub-cat re-pointed attransformations/index(hub).Write a Jinja2 Transformation/Write a Python Transformation).Learn > Tutorialsgains both new academy tutorial entries.Out of scope
guides/graphql-fragment.mdxwill move to Development Resources → APIs & interfaces in a future migration. The new transformation how-tos cross-link to its current legacy path; entries are tracked incross_links_to_updatefor the cleanup PR.redirects-pending/transformations.yml > cross_links_to_update.faq/faq.mdx,guides/modular-generator-best-practices.mdx).Voice & tone
Applied the new voice rules from the migrate-feature-page skill:
Verification
cd docs && npm run buildsucceeds (no broken links).valeclean on all 5 new files.markdownlint-cli2clean on all 5 new files (only pre-existing legacy-file errors remain).simply/easily/just/simple/easyin new content).Test plan
/topics/transformation,/guides/jinja2-transform,/guides/python-transform) still resolve (files left on disk during iteration)🤖 Generated with Claude Code