Initialize i18n foundation for English (en)

Author: TineoC

CONTRIBUTING.md

@@ -16,6 +16,64 @@ If your repo has certain guidelines for contribution, put them here ahead of the
 - [Kubernetes Contributor Guide](http://git.k8s.io/community/contributors/guide) - Main contributor documentation, or you can just jump directly to the [contributing section](http://git.k8s.io/community/contributors/guide#contributing)
 - [Contributor Cheat Sheet](https://git.k8s.io/community/contributors/guide/contributor-cheatsheet) - Common resources for existing developers
 
+## Localization (i18n)
+
+We welcome contributions to localize `kubernetes.dev` for the contributor community.
+
+### Governance
+The contributor site is under the authority of **SIG Contributor Experience (ContribEx)**.
+A contributor-site localization team handles ownership and review for localized
+content in this repository. Established localization teams from across the project
+(e.g., [SIG Docs Localization](https://kubernetes.io/docs/contribute/localization/)
+contributors) can contribute and provide guidance, but decisions for this
+repository rest with the contributor-site localization team.
+
+### Adding a New Language
+
+This guide is for **existing localization teams** that want to add their language
+to the Contributor Site. Before starting, your team should have at least two
+owners and agree to the conventions below.
+
+If you are starting a new localization from scratch, first see the
+[SIG Docs Localization guide](https://kubernetes.io/docs/contribute/localization/#start-a-new-localization).
+
+#### Branch Convention
+Open a PR from a branch named `i18n/<lang-code>` (e.g., `i18n/ko`).
+
+#### Minimum Required Pages
+For a localization to be published, the following must be translated:
+- Community page (`content/<lang>/community/`)
+- Getting Started (`content/<lang>/docs/onboarding/`)
+- Guidelines & Platforms (`content/<lang>/docs/guidelines/`,
+  `content/<lang>/docs/platforms/`)
+- GitHub Workflow (`content/<lang>/docs/github-workflow/`)
+
+Additional pages can be translated incrementally after the minimum is met.
+
+#### Setup Steps
+
+1. **Update `hugo.yaml`** — add a new language block under `languages`.
+
+2. **Create the content directory** — `content/<lang>/` with a translated `_index.md`.
+
+3. **Set up an `OWNERS` file** at `content/<lang>/OWNERS` referencing your localization
+   team's aliases (defined in the repository's `OWNERS_ALIASES`):
+   ```yaml
+   reviewers:
+   - sig-docs-<lang>-reviews
+
+   approvers:
+   - sig-docs-<lang>-owners
+   ```
+
+4. **Translate UI strings** — create `i18n/<lang>/<lang>.toml` with the site's
+   translatable strings.
+
+5. **Update README.md** — add a link to your localized `README-<lang>.md` under
+   the Localization section.
+
+6. **Open a pull request** from your `i18n/<lang-code>` branch against `main`.
+
 ## Mentorship
 
 - [Mentoring Initiatives](https://git.k8s.io/community/mentoring) - We have a diverse set of mentorship programs available that are always looking for volunteers!

README-en.md

@@ -0,0 +1,12 @@
+# Kubernetes Contributor Site - English (en)
+
+This directory contains the English localization of the Kubernetes Contributor Site.
+
+## Contact
+- **Slack**: [#sig-contribex](https://kubernetes.slack.com/messages/sig-contribex), [#sig-docs-localizations](https://kubernetes.slack.com/messages/sig-docs-localizations)
+- **Mailing List**: [kubernetes-dev](https://groups.google.com/a/kubernetes.io/group/dev)
+
+## Code of Conduct
+All contributors must follow the [Kubernetes Code of Conduct](https://github.com/kubernetes/community/blob/master/code-of-conduct.md).
+
+For more information on contributing to this site, please see the main [README.md](../README.md).

README.md

@@ -4,6 +4,10 @@ This repository contains the [Hugo][hugo] site and generator scripts for the
 Kubernetes Contributor site. The published website is available at
 https://kubernetes.dev/ (served via Netlify).
 
+## Localization
+
+- [English (en)](README-en.md)
+
 ## Site content
 
 The content for the Contributor Site is sourced from multiple locations.
@@ -18,12 +22,14 @@ original location. A list of sources and their locations within the
 
 ### External sources
 
-- **Source:** https://git.k8s.io/community/contributors/guide <br>
-  **Destination:** `/guide`
-- **Source:** https://github.com/cncf/foundation/blob/main/code-of-conduct.md <br>
-  **Destination:** `/code-of-conduct.md`
-- **Source:** https://git.k8s.io/sig-release/releases/release-1.18/README.md <br>
-  **Destination:** `/release.md`
+- **Source:** [kubernetes/community/contributors/guide](https://git.k8s.io/community/contributors/guide) <br>
+  **Destination:** `/en/docs/guide/`
+- **Source:** [cncf/foundation/code-of-conduct.md](https://github.com/cncf/foundation/blob/master/code-of-conduct.md) <br>
+  **Destination:** `/en/includes/cncf-code-of-conduct.md`
+- **Source:** [kubernetes/sig-release/releases/release-1.36/README.md](https://git.k8s.io/sig-release/releases/release-1.36/README.md) <br>
+  **Destination:** `/en/resources/release/` ([View on kubernetes.dev](https://kubernetes.dev/en/resources/release/))
+
+> **Note:** The release version in this source changes over time. Check the [sig-release repository](https://git.k8s.io/sig-release/releases/) for the latest release.
 
 ## Running the site locally
 

hugo.yaml

@@ -6,7 +6,8 @@ themesDir: node_modules
 enableRobotsTXT: true
 
 # Language settings
-contentDir: content/en
+defaultContentLanguage: en
+defaultContentLanguageInSubdir: false
 
 enableMissingTranslationPlaceholders: true
 disableKinds:
@@ -55,8 +56,14 @@ module:
 # Language configuration
 languages:
   en:
+    contentDir: content/en
     title: *title # Use the YAML reference instead of repeating
     languageName: English
+    weight: 1
+    languagedirection: ltr
+    params:
+      languageNameLatinScript: English
+      time_format_blog: "02.01.2006"
 
 markup:
   goldmark:

i18n/en/en.toml

@@ -0,0 +1,232 @@
+# Site strings for English (en)
+# Following kubernetes/website structure using 'other' key for pluralization support
+
+[ui_search_placeholder]
+other = "Type name, tag, area..."
+
+[ui_view_readme_source]
+other = "View README Source"
+
+[ui_view_charter]
+other = "View Charter"
+
+[ui_view_charter_source]
+other = "View Charter Source"
+
+[ui_press_help]
+other = 'Press "?" for help.'
+
+[ui_navigate_arrows]
+other = "Use left and right arrows to navigate."
+
+[ui_return_onboarding]
+other = "Return to onboarding index."
+
+[ui_filter]
+other = "Filter:"
+
+[ui_any_day]
+other = "Any day"
+
+[ui_monday]
+other = "Mon"
+
+[ui_tuesday]
+other = "Tue"
+
+[ui_wednesday]
+other = "Wed"
+
+[ui_thursday]
+other = "Thu"
+
+[ui_friday]
+other = "Fri"
+
+[ui_topics]
+other = "Topics:"
+
+[ui_clear]
+other = "Clear"
+
+[ui_leadership]
+other = "Leadership"
+
+[ui_chairs]
+other = "Chairs"
+
+[ui_tech_leads]
+other = "Tech Leads"
+
+[ui_meetings]
+other = "Meetings"
+
+[ui_at]
+other = "at"
+
+[ui_show_details]
+other = "Show Details"
+
+[ui_visit]
+other = "Visit"
+
+[ui_filter_by_day]
+other = "Filter community groups by meeting day"
+
+[ui_filter_by_topic]
+other = "Filter by topic"
+
+[ui_label_sigs]
+other = "SIGs"
+
+[ui_label_wgs]
+other = "Working Groups"
+
+[ui_label_committees]
+other = "Committees"
+
+[ui_aria_show_sigs]
+other = "Show Special Interest Groups"
+
+[ui_aria_show_wgs]
+other = "Show Working Groups"
+
+[ui_aria_show_committees]
+other = "Show Committees"
+
+[ui_link_join]
+other = "Join"
+
+[ui_link_notes]
+other = "Notes"
+
+[ui_link_recordings]
+other = "Recordings"
+
+[ui_link_slack]
+other = "Slack"
+
+[ui_wg_prefix]
+other = "WG"
+
+[ui_description]
+other = "Description"
+
+[ui_day]
+other = "Day"
+
+[ui_time]
+other = "Time"
+
+[ui_links]
+other = "Links"
+
+[ui_view_source]
+other = "View Source"
+
+[ui_video_placeholder]
+other = "Kubernetes contributor site video"
+
+[kep_number]
+other = "KEP Number"
+
+[kep_title]
+other = "Title"
+
+[kep_sig]
+other = "SIG"
+
+[kep_author]
+other = "Author"
+
+[kep_created]
+other = "Created"
+
+[kep_updated]
+other = "Updated"
+
+[kep_last_updated]
+other = "Last Updated"
+
+[kep_milestone]
+other = "Milestone"
+
+[kep_milestones]
+other = "Milestones"
+
+[kep_latest]
+other = "Latest"
+
+[kep_latest_milestone]
+other = "Latest Milestone"
+
+[kep_alpha]
+other = "Alpha"
+
+[kep_beta]
+other = "Beta"
+
+[kep_stable]
+other = "Stable"
+
+[kep_depr]
+other = "Depr."
+
+[kep_deprecated]
+other = "Deprecated"
+
+[kep_other]
+other = "Other"
+
+[kep_release]
+other = "Release"
+
+[kep_all_releases]
+other = "All Releases"
+
+[kep_all_sigs]
+other = "All SIGs"
+
+[kep_filter_keps]
+other = "Filter KEPs"
+
+[kep_filter_by_release]
+other = "Filter by release"
+
+[kep_filter_by_sig]
+other = "Filter by SIG"
+
+[kep_search_placeholder]
+other = "Search by title, KEP number, author..."
+
+[kep_stage]
+other = "Stage"
+
+[kep_filters]
+other = "Filters"
+
+[kep_caption]
+other = "List of Kubernetes Enhancement Proposals (KEPs)"
+
+[kep_et_al]
+other = "et al."
+
+[kep_implementation_history]
+other = "Implementation History"
+
+[kep_related_enhancements]
+one = "Related Enhancement"
+other = "Related Enhancements"
+
+[kep_ownership]
+other = "Ownership"
+
+[kep_owning_sig]
+other = "Owning SIG"
+
+[kep_participating_sigs]
+one = "Participating SIG"
+other = "Participating SIGs"
+
+[kep_primary_authors]
+other = "Primary Authors"