Feature/version i11n switching by krumware · Pull Request #78 · Cloud-Native-Platform-Engineering/cnpe-community

krumware · 2026-03-16T16:16:55Z

Major updates to website framework to improve translation management and artifact version selection/switching.

.gitignore fix — the resources pattern was matching content/*/resources/, hiding translated resource pages from the sidebar. Changed to /resources to only match Hugo's build output directory.
Sidebar translation improvements — sidebar now shows translated titles when available and links to language-prefixed URLs for untranslated pages, keeping users within their language context instead of silently redirecting to English.
Translation fallback with CTA — untranslated pages now fall back to English content with a "Translation Needed" banner encouraging contributions. Banner text uses Hugo i18n strings so it can be localized later.
Translation stubs for all pages — every translatable page now has a frontmatter-only stub (with outdated: true) in each language directory, so nothing returns a 404.
Document versioning structure — versioned resources follow a latest/ + v1/ folder structure with version switcher support. Version tagging instructions added to the README, emphasizing the use of git mv to preserve file history.
German language support — added de language config and restored a previously deleted German glossary translation from git history.
/en/ path redirect — Netlify redirect from /en/* to /:splat so English content works via /en/-prefixed URLs.
Cleanup — removed empty legacy wgs/ directories left over from the TAG App Delivery restructure.

Workflow changes

Adding new pages: new translatable pages should include a stub file (outdated: true, frontmatter only) in each language directory so the fallback works.
Tagging document versions: use git mv + restore to preserve history when creating a new version folder. See the README section "Tagging a new version of a whitepaper or artifact" for the full process.
Finding untranslated content: contributors can look for files with outdated: true and no body content to find pages that need translation.

Do not merge without approvals/reviews

netlify · 2026-03-16T16:17:33Z

✅ Deploy Preview for cnpe ready!

Name	Link
🔨 Latest commit	`430e60f`
🔍 Latest deploy log	https://app.netlify.com/projects/cnpe/deploys/69b970c664d9530008625c3b
😎 Deploy Preview	https://deploy-preview-78--cnpe.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Okabe-Junya

Thank you for your great work!
let me review based on this discussion - #73 (comment) :)

I think totally LGTM, left some minor comments, PTAL when you have time

Okabe-Junya · 2026-03-16T16:33:04Z

website/content/es/resources/glossary/latest/index.md

Seems ko, fr glossary/whitepaper files didn't change the name in this PR and this occurs 404 maybe

At least page is working well in the PR preview

ah, that's definitely broken. it's supposed to fall back to english content, but even the english one is missing now. i'll inspect.

ready for recheck

Okabe-Junya · 2026-03-16T16:37:58Z

website/layouts/partials/version-switcher.html

+    {{ $versioned = $versioned | append . }}
+  {{ end }}
+{{ end }}
+{{ $sorted := sort $versioned "version" "desc" }}


The version switcher idea is so nice!
but seems this will potentially cause like

v1 -> v10 -> v2 -> ... -> v9

(since these versions are "string")

so need to fix in the future (no need to fix for now, but need to fix by releasing v10 I think)

I'll take a look and make sure. It's intended to be SemVer compatible.

going to do this in a future PR i think. lots of changes in this one already

Okabe-Junya · 2026-03-16T16:42:35Z

website/layouts/partials/translation-needed.html

+		<i class="fas fa-language"></i>
+	</div>
+	<div class="translation-needed-content">
+		<strong>Translation Needed</strong>


I think this should support l10n like this:

Suggested change

<strong>Translation Needed</strong>

<strong>{{ i18n "translation_needed_title" }}</strong>

(and update each website/i18n/.toml)

ah good call!

ready for recheck

Signed-off-by: Colin Griffin <colin@krum.io>

…ions Signed-off-by: Colin Griffin <colin@krum.io>

Signed-off-by: Colin Griffin <colin@krum.io>

krumware · 2026-03-16T22:13:36Z

@Okabe-Junya I pushed some additional changes. lots of stuff, but we should have full language parity now, with fallback to english versions where now translations exist (yet).

cmcgalliard · 2026-03-17T14:55:32Z

platform-as-a-product/platform-engineer-interview-script.md

 - Do you have any questions for us?
 - Legal Reminder: Only the anonymized transcript will be shared with the wider research team; all references to you and your company will be removed. Only a small group of leads will have access to the video to ensure the integrity of the transcript for the duration of the project, after which the video will be deleted.
- Join the conversation: "Join the ongoing conversation at TAG App Delivery: https://tag-app-delivery.cncf.io/wgs/platforms/"
+- Join the conversation: "Join the ongoing conversation at TAG App Delivery: https://cloudnativeplatforms.com/"


References TAG APP Deliver - and should this point at the TCG?

krumware added 4 commits March 13, 2026 12:30

update page links

561ba21

update link location

063d653

add version switching and version glossary

06d8938

add updated partials

9fd760a

krumware requested review from roberthstrand and techmaharaj as code owners March 16, 2026 16:16

krumware mentioned this pull request Mar 16, 2026

[Website Localization] Japanese (ja) translation proposals #73

Open

Okabe-Junya reviewed Mar 16, 2026

View reviewed changes

krumware added 9 commits March 16, 2026 18:04

fix .gitignore to not ignore content resource directories

873a8a3

Signed-off-by: Colin Griffin <colin@krum.io>

add /en/ path redirect to netlify config

dba04e6

Signed-off-by: Colin Griffin <colin@krum.io>

sidebar: show translated titles and prefix links for missing translat…

3c35fa9

…ions Signed-off-by: Colin Griffin <colin@krum.io>

fix glossary and maturity-model ref paths

07732dc

Signed-off-by: Colin Griffin <colin@krum.io>

add German language support

094046a

Signed-off-by: Colin Griffin <colin@krum.io>

add v1 versions for translated resources

4ec42a9

Signed-off-by: Colin Griffin <colin@krum.io>

add translation stubs for missing pages

318f7cb

Signed-off-by: Colin Griffin <colin@krum.io>

remove obsolete glossary _index.md

48df5df

Signed-off-by: Colin Griffin <colin@krum.io>

add translation variables to partials

97fa29d

krumware added 2 commits March 17, 2026 10:21

Add process and explanations for tagging document releases

582be47

update documentation and checklists

ae2f928

cmcgalliard reviewed Mar 17, 2026

View reviewed changes

fix missing table of contents on fallback renderings

430e60f

	<strong>Translation Needed</strong>
	<strong>{{ i18n "translation_needed_title" }}</strong>

Conversation

krumware commented Mar 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Workflow changes

Uh oh!

netlify bot commented Mar 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for cnpe ready!

Uh oh!

Okabe-Junya left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

krumware commented Mar 16, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

krumware commented Mar 16, 2026 •

edited

Loading

netlify bot commented Mar 16, 2026 •

edited

Loading