Skip to content

Conversation

@oromao
Copy link
Contributor

@oromao oromao commented Nov 24, 2025

Description

This pull request updates the Japanese documentation for Services and Networking and introduces a new reference page for Virtual IPs.

The update aligns the Japanese localization with the upstream English documentation, incorporating large structural updates, content rewrites, and terminology improvements.

What this PR changes

  • Updates content/ja/docs/concepts/services-networking/service.md with the latest upstream content
    • Synchronizes explanations of proxy modes (userspace, iptables, IPVS)
    • Updates diagrams, descriptions, and conceptual flow
    • Ensures accuracy of networking terminology in Japanese
  • Adds a new reference document:
    • content/ja/docs/reference/networking/virtual-ips.md
    • Provides a complete explanation of Kubernetes virtual IPs, allocation mechanisms, implementation details, and proxying models
  • Fixes outdated phrasing, removes obsolete sections, and restructures content to match upstream
  • Maintains glossary consistency and preserves shortcode elements such as feature-state and glossary_tooltip

Why this change is needed

Keeping localized documentation synchronized with upstream is essential for:

  • Ensuring Japanese users receive accurate, up-to-date Kubernetes information
  • Improving documentation reliability for new contributors and learners
  • Maintaining compatibility with current API behavior and networking implementation
  • Reducing technical debt in the localization by removing legacy references

This update brings the Service documentation in line with the current Kubernetes reference model and improves translation quality and conceptual consistency.

Issue

Closes: #53415

Signed-off-by: Paulo Sergio Romao Junior [email protected]

@k8s-ci-robot k8s-ci-robot added the do-not-merge/invalid-commit-message Indicates that a PR should not merge because it has an invalid commit message. label Nov 24, 2025
@linux-foundation-easycla
Copy link

linux-foundation-easycla bot commented Nov 24, 2025

CLA Signed

The committers listed above are authorized under a signed CLA.

  • ✅ login: oromao / name: oromao (0fcdd95)

@k8s-ci-robot k8s-ci-robot added cncf-cla: no Indicates the PR's author has not signed the CNCF CLA. area/localization General issues or PRs related to localization language/ja Issues or PRs related to Japanese language size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. language/ko Issues or PRs related to Korean language sig/docs Categorizes an issue or PR as relevant to SIG Docs. labels Nov 24, 2025
@netlify
Copy link

netlify bot commented Nov 24, 2025

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 0fcdd95
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/6924637b8150400008ef562a
😎 Deploy Preview https://deploy-preview-53428--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@oromao oromao force-pushed the ja/update-service-doc branch from 91d016a to 3fcfe4f Compare November 24, 2025 13:28
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign okabe-junya for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. and removed cncf-cla: no Indicates the PR's author has not signed the CNCF CLA. labels Nov 24, 2025
Update the Japanese translation of content/ja/docs/concepts/services-networking/service.md to match the latest English version.
Also create content/ja/docs/reference/networking/virtual-ips.md to preserve content moved from service.md.

Signed-off-by: oromao <[email protected]>
@oromao oromao force-pushed the ja/update-service-doc branch from 3fcfe4f to 0fcdd95 Compare November 24, 2025 13:54
@k8s-ci-robot k8s-ci-robot removed the do-not-merge/invalid-commit-message Indicates that a PR should not merge because it has an invalid commit message. label Nov 24, 2025
@kfess
Copy link
Member

kfess commented Nov 24, 2025

Thank you for your interest in contributing.

Before proceeding, please carefully review the Japanese localization style guide (https://kubernetes.io/ja/docs/contribute/localization/) and ensure your translation follows all the guidelines.

Additionally, please note:

  • One PR should contain changes to only one file
  • All translations must strictly adhere to the style guide

Would you be able to revise this PR accordingly?

@kfess
Copy link
Member

kfess commented Nov 24, 2025

@oromao

Please note that this issue is already assigned to another contributor (in this case, it is me).
For future contributions, please check if an issue is assigned before starting work.
We welcome your contributions to other unassigned issues!

@Okabe-Junya
Copy link
Member

/hold

#53428 (comment)

@k8s-ci-robot k8s-ci-robot added the do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. label Nov 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/localization General issues or PRs related to localization cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. do-not-merge/hold Indicates that a PR should not merge because someone has issued a /hold command. language/ja Issues or PRs related to Japanese language language/ko Issues or PRs related to Korean language sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[ja] Update content/ja/docs/concepts/services-networking/service.md

4 participants