Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update localization guidelines #10485

Merged
merged 5 commits into from Oct 12, 2018
Merged

Update localization guidelines #10485

merged 5 commits into from Oct 12, 2018

Conversation

zacharysarah
Copy link
Contributor

@zacharysarah zacharysarah commented Oct 3, 2018

👋 Reviews from stakeholders are welcome and encouraged! 🙇

TL,DR

This PR updates localization docs and workflows for https://kubernetes.io. It also proposes archiving language-specific repos (k/kubernetes-docs-*).

Updates

October 09

October 10

Summary

This PR updates several aspects of localization (l10n) for Kubernetes docs:

  • Localization guidelines reflect that all l10n work now happens in k/website instead of subproject repositories.

  • Individual content/<xx> directories gain language-specific OWNERS files. This lets translation teams review and approve their own l10n-specific PRs.

  • Chinese content moves from content/cn/ to content/zh/ to conform with the ISO 639-1 naming scheme.

  • Language-specific subproject repositories will be archived.

Context

In Q3 2017, Kubernetes SIG Docs invited an independent Chinese localization project to house their project in k/website. SIG Docs was unprepared for the introduction of Chinese-language content, due to both the amount of PRs and the lack of Chinese fluency on the part of k/website's maintainers.

To enable translation work to continue while SIG Docs solved for infrastructure support and a scalable l10n workflow, SIG Docs proposed the creation of a language-specific subproject for Chinese content (kubernetes-docs-zh). The goal was for translation work to continue without creating an undue burden on either the Chinese l10n (via a backlog of unapproved PRs) or on SIG Docs maintainers (unable to provide meaningful review of Chinese content).

SIG Architecture also approved the creation of two additional repos for new localization projects in Japanese (k/kubernetes-docs-ja) and Korean (k/kubernetes-docs-ko).

In Q3 2018, while solving for how to pass source content and translated output between repos, @zparnold proposed and implemented a language label bot. The bot automatically assigns labels to PRs based on the content/* filepaths of pull requests, allowing reviewers to filter pull requests by language. For example, see this list of PRs with Korean content.

UPDATE: Per @cblecker in #10485 (comment), Prow natively supports automatic label assignment by language. I've updated this PR accordingly. The implementation differs from the original proposal, but the strategic effect remains the same.

The combination of native multilingual support and automated language labeling allows SIG Docs to consolidate l10n workflows in a single repository: k/website. This strategy scales appropriately with increasing numbers of localizations. The alternative requires SIG Docs to enforce common standards for synchronizing source and output across multiple, non-forked repos with disparate branching structures and non-identical milestones. These strategies are unnecessarily complex and do not scale well.

Consolidating workflows is a good idea. Let's do it.

There is one notable downside of archiving language-specific repos: absent some finely-tuned git commands, l10n teams could lose their commit histories by moving files from one repo to another. This is avoidable, but it does require git expertise. (:point_left: @mistyhacks) It's also not the end of the world, but it is kind of a bummer.

Easy file previews

Dependencies

PRs in k/website

PR Description ✔️
#10566 Update OWNERS* to enable content/en/OWNERS ✔️

Impacts to other Kubernetes SIGs

PR SIG Impact
kubernetes/community#2753 community Remove language-specific subprojects from SIG Docs info
kubernetes/test-infra#9732 test-infra Remove language-specific subproject repos from Prow configuration
kubernetes/org#154 Kubernetes org Archive language-specific repos and teams

Lazy consensus

If stakeholders do nothing by Friday, October 12:

  • This PR merges:
  • Archive language-specific subproject repositories:
    • Archive the kubernetes/kubernetes-docs-ja repository using admin permissions
      • Make one final commit of kubernetes-docs-ko:content/ja/ to k/website
    • Archive the kubernetes/kubernetes-docs-ko repository using admin permissions
      • Make one final commit of kubernetes-docs-ko:content/ko/ to k/website
    • Archive the kubernetes/kubernetes-docs-zh repository using admin permissions
      • Make one final commit of kubernetes-docs-ko:content/zh/ to k/website
  • Revise GH teams:
    • Add the following teams:
      • @kubernetes/sig-docs-en-owners
      • @kubernetes/sig-docs-en-reviews Create an OWNERS_ALIAS for sig-docs-pr-reviews
      • @kubernetes/sig-docs-ja-owners
      • @kubernetes/sig-docs-ja-reviews
      • @kubernetes/sig-docs-ko-owners
      • @kubernetes/sig-docs-ko-reviews
      • @kubernetes/sig-docs-zh-owners
      • @kubernetes/sig-docs-zh-reviews
    • Remove the following teams:
      • @kubernetes/kubernetes-docs-ja-admins
      • @kubernetes/kubernetes-docs-ja-maintainers
      • @kubernetes/kubernetes-docs-ko-admins
      • @kubernetes/kubernetes-docs-ko-maintainers
      • @kubernetes/kubernetes-docs-zh-admins
      • @kubernetes/kubernetes-docs-zh-maintainers
      • @kubernetes/kubernetes-docs-zh-reviewers

@zacharysarah zacharysarah self-assigned this Oct 3, 2018
@k8s-ci-robot k8s-ci-robot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 3, 2018
@kubernetes-docs-i18n-bot kubernetes-docs-i18n-bot added the language/en Issues or PRs related to English language label Oct 3, 2018
@k8s-ci-robot k8s-ci-robot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Oct 3, 2018
@k8sio-netlify-preview-bot
Copy link
Collaborator

Deploy preview for kubernetes-io-master-staging ready!

Built with commit 76a9621

https://deploy-preview-10485--kubernetes-io-master-staging.netlify.com

@k8sio-netlify-preview-bot
Copy link
Collaborator

k8sio-netlify-preview-bot commented Oct 3, 2018

Deploy preview for kubernetes-io-master-staging failed.

Built with commit a6cf9f4

https://app.netlify.com/sites/kubernetes-io-master-staging/deploys/5bc10f4473f2cf64dde20c56

@k8s-ci-robot k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Oct 4, 2018
@k8s-ci-robot k8s-ci-robot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Oct 6, 2018
@kubernetes-docs-i18n-bot kubernetes-docs-i18n-bot added the language/zh Issues or PRs related to Chinese language label Oct 6, 2018
@k8s-ci-robot k8s-ci-robot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels Oct 6, 2018
@k8s-ci-robot k8s-ci-robot added the sig/architecture Categorizes an issue or PR as relevant to SIG Architecture. label Oct 7, 2018
@zacharysarah zacharysarah changed the title [WIP] Update localization guidelines Update localization guidelines Oct 7, 2018
@k8s-ci-robot k8s-ci-robot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Oct 7, 2018
@zacharysarah
Copy link
Contributor Author

Stakeholders

Chinese localization

@tengqm, @markthink, @hanjiayao

Japanese localization

@cstoku, @MasayaAoyama, @tnir

Korean localization

@claudiajkang, @gochist, @ianychoi

SIG Architecture

Should the Kubernetes org fork the language label app into the kubernetes GitHub organization?

@cblecker, @kubernetes/sig-architecture-pr-reviews
/sig architecture

SIG Community

@parispittman, @kubernetes/community-reviewers
/sig community

SIG Docs

@Bradamant3, @chenopis, @jaredbhatti, @zparnold
@mistyhacks for git expertise in preserving commit histories between repos

SIG Test-Infra

@spiffxp, @kubernetes/test-infra-reviewers
/sig test-infra

General interest

@caniszczyk, @dankohn

config.toml Outdated
@@ -7,7 +7,7 @@ enableRobotsTXT = true

disableKinds = ["taxonomy", "taxonomyTerm"]

ignoreFiles = [ "^OWNERS$", "README.md", "^node_modules$", "content/en/docs/doc-contributor-tools" ]
ignoreFiles = [ "^OWNERS$", "README*.md", "^node_modules$", "content/en/docs/doc-contributor-tools" ]
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Does this regex correctly exclude examples like README-ko.md?

@zparnold

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

^OWNERS$ seems to copy the OWNERS file in the subdirectory. I think OWNERS$ is correct.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@cstoku Thanks--it's the addition of language-specific READMEs (for example, README-ja.md) for which I want to verify the exclusion with "README*.md".

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@zparnold ☝️ PTAL

Copy link
Contributor

@mdlinville mdlinville Oct 9, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think you want to tighten this regex. You want to match things that:

  • start with README
  • end with .md
  • Don't have -[a-z][a-z]

So: README\.md gets exactly README.md without any others.

If you wanted to match only the language-specific ones: README[-]+[a-z]*\.md That looks for things with 1 or more hyphen and then 0 or more letters before the .md

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@mistyhacks Thanks for the review! ✨

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@zacharysarah Use \\ instead of \ in a toml file, like "README[-]+[a-z]*\\.md".

Copy link
Member

@gochist gochist left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have questions


Each l10n repository must have branches for the different Kubernetes documentation release versions, matching the branches in the main [kubernetes/website](https://github.com/kubernetes/website) documentation repository. For example, the kubernetes/website `release-1.10` branch (https://github.com/kubernetes/website/tree/release-1.10) has a corresponding branch in the kubernetes/kubernetes-docs-zh repository (https://github.com/kubernetes/kubernetes-docs-zh/tree/release-1.10). These version branches keep track of the differences in the documentation between Kubernetes versions.
Teams are free to use any branching strategy for work in progress. For example, a German localization team might use source files from `{{< release-branch >}}`, but work in `dev-{{< release-branch >}}-de-1.0` before squashing commits in a single PR against `{{< release-branch >}}`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In this example, which repository does the dev-{{< release-branch >}}-de-1.0 branch belong to? If it is k/website, does l10n team have permission to create those branch?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@gochist 👋

which repository does the branch belong to?

Yes, it's k/website.

does l10n team have permission to create those branch?

Yes. 👍

It's probably best to treat a development branch for translation the same as any other long-running collaborative branch (for example, the release branches for 1.11 and 1.10: #9171, #7818).

Normally we require folks to open PRs on a fork of k/website, but for collaborative projects like localizations I think it's better to treat them like release branches and open directly against k/website.

A development branch for 1.12 source would require an open PR against https://github.com/kubernetes/website/tree/release-1.12, which Individual contributors would then use as the base for their own PRs. A team needs to agree on who opens and maintains the PR--by keeping it current with its parent branch, resolving merge conflicts, and setting expectations for when to merge it--but that can be anyone, with no special permissions required.

We should absolutely specify this in the docs. 👍 I'll update this PR accordingly. Great question! ✨

content/en/docs/contribute/localization.md Outdated Show resolved Hide resolved
content/en/docs/contribute/localization.md Show resolved Hide resolved
@cstoku
Copy link
Contributor

cstoku commented Oct 7, 2018

About the overview of this issue, is the following content correct?


Now:

* [ ]  Add an OWNERS file to `/content/ja/` that duplicates [`kubernetes-docs-ko:OWNERS`](https://github.com/kubernetes/kubernetes-docs-ja/blob/master/OWNERS)

Revised:

* [ ]  Add an OWNERS file to `/content/ja/` that duplicates [`kubernetes-docs-ja:OWNERS`](https://github.com/kubernetes/kubernetes-docs-ja/blob/master/OWNERS)

Now:

  • Archive the kubernetes/kubernetes-docs-ja repository using admin permissions

    • Make one final commit of kubernetes-docs-ko:content/ja/ to k/website
  • Archive the kubernetes/kubernetes-docs-zh repository using admin permissions

    • Make one final commit of kubernetes-docs-ko:content/zh/ to k/website
* [ ]  Archive the [`kubernetes/kubernetes-docs-ja`](https://github.com/kubernetes/kubernetes-docs-ko) repository using admin permissions

  * [ ]  Make one final commit of `kubernetes-docs-ko:content/ja/` to `k/website`
* [ ]  Archive the [`kubernetes/kubernetes-docs-zh`](https://github.com/kubernetes/kubernetes-docs-ko) repository using admin permissions

  * [ ]  Make one final commit of `kubernetes-docs-ko:content/zh/` to `k/website`

Revised:

  • Archive the kubernetes/kubernetes-docs-ja repository using admin permissions

    • Make one final commit of kubernetes-docs-ja:content/ja/ to k/website
  • Archive the kubernetes/kubernetes-docs-zh repository using admin permissions

    • Make one final commit of kubernetes-docs-zh:content/zh/ to k/website
* [ ]  Archive the [`kubernetes/kubernetes-docs-ja`](https://github.com/kubernetes/kubernetes-docs-ja) repository using admin permissions

  * [ ]  Make one final commit of `kubernetes-docs-ja:content/ja/` to `k/website`
* [ ]  Archive the [`kubernetes/kubernetes-docs-zh`](https://github.com/kubernetes/kubernetes-docs-zh) repository using admin permissions

  * [ ]  Make one final commit of `kubernetes-docs-zh:content/zh/` to `k/website`

Upstream contributions are welcome and encouraged!

For the sake of efficiency, limit upstream contributions to a single pull request per week, containing a single [squashed commit](https://github.com/todotxt/todo.txt-android/wiki/Squash-All-Commits-Related-to-a-Single-Issue-into-a-Single-Commit).
SIG Docs welcomes ustream contributions and corrections to the English source! For the sake of efficiency, limit upstream contributions to a single pull request per week, containing a single [squashed commit](https://github.com/todotxt/todo.txt-android/wiki/Squash-All-Commits-Related-to-a-Single-Issue-into-a-Single-Commit).
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/ustream/upstream/

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@tnir Even editors are not immune. 😆 🙇


```shell
mkdir -p content/de/docs/tutorials
cp content/en/docs/tutorials/kubernetes-basics.md content/de/docs/tutorials/kubernetes-basics.md
cp content/en/docs/tutorials/kubernetes-basics.md content/de/docs/tutorials/kubernetes-basics.md
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You don't need to add an extra white space here 😄

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: kbarnard10

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

The pull request process is described 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 the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Oct 12, 2018
@k8s-ci-robot k8s-ci-robot merged commit abcee2d into kubernetes:master Oct 12, 2018
@zacharysarah zacharysarah deleted the update-l10n-guidelines branch October 12, 2018 21:35
@tnir
Copy link
Contributor

tnir commented Oct 12, 2018

@zacharysarah @kbarnard10 👍 🎉

While just checked zh and ko, https://kubernetes.io/zh/ is not found (404) (/cn/ is still available) and https://kubernetes.io/ko/ looks wierd (features and case studies).

@zparnold
Copy link
Member

zparnold commented Oct 12, 2018 via email

@tnir
Copy link
Contributor

tnir commented Oct 13, 2018

@zparnold Thanks 😄

@zacharysarah
Copy link
Contributor Author

@tnir LGTM: https://kubernetes.io/zh/

@tnir
Copy link
Contributor

tnir commented Oct 15, 2018

@zacharysarah Yes, after #10610 (and might be other PRs), now we can see that it works well 🎉🎉🎉

@markthink
Copy link

markthink commented Oct 15, 2018

@zacharysarah I can't create a branch PUSH code for myself, I can't complete the update operation, suggesting that I didn't pass the cla check. In fact, this problem should not exist.

Counting objects: 4, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (4/4), done.
Writing objects: 100% (4/4), 11.18 KiB | 0 bytes/s, done.
Total 4 (delta 2), reused 0 (delta 0)
remote: Resolving deltas: 100% (2/2), completed with 1 local object.
remote: error: GH006: Protected branch update failed for refs/heads/release-1.12-zh.
remote: error: Required status check "cla/linuxfoundation" is expected.
To https://github.com/kubernetes/kubernetes-docs-zh.git
 ! [remote rejected]   release-1.12-zh -> release-1.12-zh (protected branch hook declined)
error: failed to push some refs to 'https://github.com/kubernetes/kubernetes-docs-zh.git'

PUSH is designed to update the latest code base, and managing documents is sometimes necessary.

The impact of this issue:Although it has been successfully switched from cn to zh directory here, kubernetes-docs-zh does not push update permissions, and submitting PR operations to merge documents is not particularly convenient.

@zacharysarah
Copy link
Contributor Author

@markthink Please open your comment as a new issue so we can resolve it separately. Thanks in advance.

@brucehex
Copy link

@zacharysarah ok, thank you.

claudiajkang added a commit to claudiajkang/website2 that referenced this pull request Oct 18, 2018
This commit adds a link about Localizing Kubernetes Documentation in
README.md's Contributing to the docs section.

Fixed : kubernetes#10485, kubernetes#10622

Signed-off-by: Claudia J. Kang <claudiajkang@gmail.com>
claudiajkang added a commit to claudiajkang/website2 that referenced this pull request Oct 18, 2018
This commit adds a link process about the l10n README files in
localization.md.

Fixed : kubernetes#10485, kubernetes#10622

Signed-off-by: Claudia J. Kang <claudiajkang@gmail.com>
k8s-ci-robot pushed a commit that referenced this pull request Oct 23, 2018
* New link about Localizing Kubernetes Documentation

This commit adds a link about Localizing Kubernetes Documentation in
README.md's Contributing to the docs section.

Fixed : #10485, #10622

Signed-off-by: Claudia J. Kang <claudiajkang@gmail.com>

* Update l10n guide about adding l10n README files.

This commit adds a link process about the l10n README files in
localization.md.

Fixed : #10485, #10622

Signed-off-by: Claudia J. Kang <claudiajkang@gmail.com>
markthink pushed a commit to markthink/website that referenced this pull request Oct 9, 2019
* Update localization guidelines for language labels

Continuing work

Continuing work

Continuing work

More work in progress

Add local OWNERS folders

Add an OWNERS file to Chinese

Remove shortcode for repos

Add Japanese

Alphabetize languages, change weights accordingly

More updates

Add Korean in Korean

Add English to languageName

Feedback from gochist

Move Chinese content from cn/ to zh/

Move OWNERS from cn/ to zh/

Resolve merge conflicts by updating from master

Add files back in to prep for resolution

After rebase on upstream/master, remove files

Review and update localization guidelines

Feedback from gochist, tnir, cstoku

Add a trailing newline to content/ja/OWNERS

Add a trailing newline to content/zh/OWNERS

Drop requirement for GH repo project

Clarify language about forks/branches

Edits and typos

Remove a shortcode specific to a multi-repo language setup

Update aliases and owners

Add explicit OWNERS for content/en

Migrate content from Chinese repo, update regex in config.toml

Remove untranslated strings

Add trailing newline to content/en/OWNERS

Add trailing newlines to OWNERS files

add Jaguar project description (kubernetes#10433)

* add Jaguar project description

[Jaguar](https://gitlab.com/sdnlab/jaguar) is an open source solution for Kubernetes's network based on OpenDaylight.
Jaguar provides overlay network using vxlan and Jaguar CNIPlugin provides one IP address per pod.

* Minor newline tweak

blog post for azure vmss (kubernetes#10538)

Add microk8s to pick-right-solution.md (kubernetes#10542)

* Add microk8s to pick-right-solution.md

Microk8s is a single-command installation of upstream Kubernetes on any Linux and should be included in the list of local-machine solutions.

* capitalized Istio

Add microk8s to foundational.md (kubernetes#10543)

* Add microk8s to foundational.md

Adding microk8s as credible and stable alternative to get started with Kubernetes on a local machine. This is especially attractive for those not wanting to incur the overhead of running a VM for a local cluster.

* Update foundational.md

Thank you for your suggestions! LMK if this works now?

* Rewrote first paragraph

And included a bullet list of features of microk8s

* Copyedit

fix typo (kubernetes#10545)

Fix the kubectl subcommands links. (kubernetes#10550)

Signed-off-by: William Zhang <warmchang@outlook.com>

Fix command issue (kubernetes#10515)

Signed-off-by: mooncake <xcoder@tenxcloud.com>

remove imported community files per issue 10184 (kubernetes#10501)

networking.md: Markdown fix (kubernetes#10498)

Fix front matter, federation command-line tools (kubernetes#10500)

Clean up glossary entry (kubernetes#10399)

update slack link (kubernetes#10536)

typo in StatefulSet docs (kubernetes#10558)

fix discription about horizontal pod autoscale (kubernetes#10557)

Remove redundant symbols (kubernetes#10556)

Fix issue kubernetes#10520 (kubernetes#10554)

Signed-off-by: William Zhang <warmchang@outlook.com>

Update api-concepts.md (kubernetes#10534)

Revert "Fix command issue (kubernetes#10515)"

This reverts commit c02a7fb.

Update memory-constraint-namespace.md (kubernetes#10530)

update memory request to 100MiB corresponding the yaml content

Blog: Introducing Volume Snapshot Alpha for Kubernetes (kubernetes#10562)

* blog post for azure vmss

* snapshot blog post

Resolve merge conflicts in OWNERS*

Minor typo fix (kubernetes#10567)

Not sure what's supposed to be here, proposing removing it.

* Feedback from gochist

Tweaks to feedback

* Feedback from ClaudiaJKang
markthink pushed a commit to markthink/website that referenced this pull request Oct 9, 2019
* Update localization guidelines for language labels

Continuing work

Continuing work

Continuing work

More work in progress

Add local OWNERS folders

Add an OWNERS file to Chinese

Remove shortcode for repos

Add Japanese

Alphabetize languages, change weights accordingly

More updates

Add Korean in Korean

Add English to languageName

Feedback from gochist

Move Chinese content from cn/ to zh/

Move OWNERS from cn/ to zh/

Resolve merge conflicts by updating from master

Add files back in to prep for resolution

After rebase on upstream/master, remove files

Review and update localization guidelines

Feedback from gochist, tnir, cstoku

Add a trailing newline to content/ja/OWNERS

Add a trailing newline to content/zh/OWNERS

Drop requirement for GH repo project

Clarify language about forks/branches

Edits and typos

Remove a shortcode specific to a multi-repo language setup

Update aliases and owners

Add explicit OWNERS for content/en

Migrate content from Chinese repo, update regex in config.toml

Remove untranslated strings

Add trailing newline to content/en/OWNERS

Add trailing newlines to OWNERS files

add Jaguar project description (kubernetes#10433)

* add Jaguar project description

[Jaguar](https://gitlab.com/sdnlab/jaguar) is an open source solution for Kubernetes's network based on OpenDaylight.
Jaguar provides overlay network using vxlan and Jaguar CNIPlugin provides one IP address per pod.

* Minor newline tweak

blog post for azure vmss (kubernetes#10538)

Add microk8s to pick-right-solution.md (kubernetes#10542)

* Add microk8s to pick-right-solution.md

Microk8s is a single-command installation of upstream Kubernetes on any Linux and should be included in the list of local-machine solutions.

* capitalized Istio

Add microk8s to foundational.md (kubernetes#10543)

* Add microk8s to foundational.md

Adding microk8s as credible and stable alternative to get started with Kubernetes on a local machine. This is especially attractive for those not wanting to incur the overhead of running a VM for a local cluster.

* Update foundational.md

Thank you for your suggestions! LMK if this works now?

* Rewrote first paragraph

And included a bullet list of features of microk8s

* Copyedit

fix typo (kubernetes#10545)

Fix the kubectl subcommands links. (kubernetes#10550)

Signed-off-by: William Zhang <warmchang@outlook.com>

Fix command issue (kubernetes#10515)

Signed-off-by: mooncake <xcoder@tenxcloud.com>

remove imported community files per issue 10184 (kubernetes#10501)

networking.md: Markdown fix (kubernetes#10498)

Fix front matter, federation command-line tools (kubernetes#10500)

Clean up glossary entry (kubernetes#10399)

update slack link (kubernetes#10536)

typo in StatefulSet docs (kubernetes#10558)

fix discription about horizontal pod autoscale (kubernetes#10557)

Remove redundant symbols (kubernetes#10556)

Fix issue kubernetes#10520 (kubernetes#10554)

Signed-off-by: William Zhang <warmchang@outlook.com>

Update api-concepts.md (kubernetes#10534)

Revert "Fix command issue (kubernetes#10515)"

This reverts commit c02a7fb.

Update memory-constraint-namespace.md (kubernetes#10530)

update memory request to 100MiB corresponding the yaml content

Blog: Introducing Volume Snapshot Alpha for Kubernetes (kubernetes#10562)

* blog post for azure vmss

* snapshot blog post

Resolve merge conflicts in OWNERS*

Minor typo fix (kubernetes#10567)

Not sure what's supposed to be here, proposing removing it.

* Feedback from gochist

Tweaks to feedback

* Feedback from ClaudiaJKang
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/en Issues or PRs related to English language language/zh Issues or PRs related to Chinese language lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/architecture Categorizes an issue or PR as relevant to SIG Architecture. 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.

None yet