{"id":772,"date":"2018-11-12T03:01:26","date_gmt":"2018-11-12T03:01:26","guid":{"rendered":"https:\/\/www.appservgrid.com\/paw93\/?p=772"},"modified":"2018-11-12T03:03:44","modified_gmt":"2018-11-12T03:03:44","slug":"kubernetes-docs-updates-international-edition","status":"publish","type":"post","link":"https:\/\/www.appservgrid.com\/paw93\/index.php\/2018\/11\/12\/kubernetes-docs-updates-international-edition\/","title":{"rendered":"Kubernetes Docs Updates, International Edition"},"content":{"rendered":"

Kubernetes Docs Updates, International Edition<\/a><\/h3>\n

Author: Zach Corleissen (Linux Foundation)<\/p>\n

As a co-chair of SIG Docs, I\u2019m excited to share that Kubernetes docs have a fully mature workflow for localization (l10n).<\/p>\n

Abbreviations galore<\/h2>\n

L10n is an abbreviation for localization<\/em>.<\/p>\n

I18n is an abbreviation for internationalization<\/em>.<\/p>\n

I18n is what you do<\/a> to make l10n easier. L10n is a fuller, more comprehensive process than translation (t9n<\/em>).<\/p>\n

Why localization matters<\/h2>\n

The goal of SIG Docs is to make Kubernetes easier to use for as many people as possible.<\/p>\n

One year ago, we looked at whether it was possible to host the output of a Chinese team working independently to translate the Kubernetes docs. After many conversations (including experts on OpenStack l10n), much transformation<\/a>, and renewed commitment to easier localization<\/a>, we realized that open source documentation is, like open source software, an ongoing exercise at the edges of what\u2019s possible.<\/p>\n

Consolidating workflows, language labels, and team-level ownership may seem like simple improvements, but these features make l10n scalable for increasing numbers of l10n teams. While SIG Docs continues to iterate improvements, we\u2019ve paid off a significant amount of technical debt and streamlined l10n in a single workflow. That\u2019s great for the future as well as the present.<\/p>\n

Consolidated workflow<\/h2>\n

Localization is now consolidated in the kubernetes\/website<\/a> repository. We\u2019ve configured the Kubernetes CI\/CD system, Prow<\/a>, to handle automatic language label assignment as well as team-level PR review and approval.<\/p>\n

Language labels<\/h3>\n

Prow automatically applies language labels based on file path. Thanks to SIG Docs contributor June Yi<\/a>, folks can also manually assign language labels in pull request (PR) comments. For example, when left as a comment on an issue or PR, this command assigns the label language\/ko (Korean).<\/p>\n

\/language ko<\/p>\n

These repo labels let reviewers filter for PRs and issues by language. For example, you can now filter the k\/website dashboard for PRs with Chinese content<\/a>.<\/p>\n

Team review<\/h3>\n

L10n teams can now review and approve their own PRs. For example, review and approval permissions for English are assigned in an OWNERS file<\/a> in the top subfolder for English content.<\/p>\n

Adding OWNERS files to subdirectories lets localization teams review and approve changes without requiring a rubber stamp approval from reviewers who may lack fluency.<\/p>\n

What\u2019s next<\/h2>\n

We\u2019re looking forward to the doc sprint in Shanghai<\/a> to serve as a resource for the Chinese l10n team.<\/p>\n

We\u2019re excited to continue supporting the Japanese and Korean l10n teams, who are making excellent progress.<\/p>\n

If you\u2019re interested in localizing Kubernetes for your own language or region, check out our guide to localizing Kubernetes docs<\/a> and reach out to a SIG Docs chair<\/a> for support.<\/p>\n

Source<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

Kubernetes Docs Updates, International Edition Author: Zach Corleissen (Linux Foundation) As a co-chair of SIG Docs, I\u2019m excited to share that Kubernetes docs have a fully mature workflow for localization (l10n). Abbreviations galore L10n is an abbreviation for localization. I18n is an abbreviation for internationalization. I18n is what you do to make l10n easier. L10n … <\/p>\n

Continue reading “Kubernetes Docs Updates, International Edition”<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-772","post","type-post","status-publish","format-standard","hentry","category-kubernetes"],"_links":{"self":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts\/772","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/comments?post=772"}],"version-history":[{"count":1,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts\/772\/revisions"}],"predecessor-version":[{"id":775,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/posts\/772\/revisions\/775"}],"wp:attachment":[{"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/media?parent=772"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/categories?post=772"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.appservgrid.com\/paw93\/index.php\/wp-json\/wp\/v2\/tags?post=772"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}