Skip to content

Cloud native glossary#55287

Open
Creativeklvn wants to merge 2 commits intokubernetes:mainfrom
Creativeklvn:Cloud-Native-Glossary
Open

Cloud native glossary#55287
Creativeklvn wants to merge 2 commits intokubernetes:mainfrom
Creativeklvn:Cloud-Native-Glossary

Conversation

@Creativeklvn
Copy link
Copy Markdown
Contributor

@Creativeklvn Creativeklvn commented Apr 7, 2026

This PR adds guidance to the documentation style guide on linking to the CNCF Cloud Native Glossary to improve accessibility for new users.

What this PR does

  • Adds a new section to the Documentation Style Guide describing when and how to link to the Cloud Native Glossary
  • Provides do/don’t examples to guide contributors on appropriate usage

Why this is needed

Kubernetes documentation includes many cloud native terms that may be unfamiliar to new users.

The CNCF Cloud Native Glossary offers simple, beginner-friendly definitions. Providing guidance on when to link to it helps improve accessibility while maintaining readability.

Fixes #39792

@k8s-ci-robot
Copy link
Copy Markdown
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 nate-double-u for approval. For more information see the Code Review Process.

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

Details 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 language/en Issues or PRs related to English language size/S Denotes a PR that changes 10-29 lines, ignoring generated files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Apr 7, 2026
@netlify
Copy link
Copy Markdown

netlify bot commented Apr 7, 2026

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit c30787d
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/69d4fbeaf434ff0008236953
😎 Deploy Preview https://deploy-preview-55287--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.

@lmktfy
Copy link
Copy Markdown
Member

lmktfy commented Apr 7, 2026

This PR improves the accessibility of Kubernetes documentation by linking key cloud native terms to the CNCF Cloud Native Glossary.

What this PR does

  • Adds guidance in the documentation style guide to encourage linking to the Cloud Native Glossary where beneficial
  • Updates glossary entries (for example, CNCF) to include "Further reading" links to the Cloud Native Glossary
  • Introduces selective linking of cloud native terms to beginner-friendly definitions

It doesn't.

/hold

Please update the PR description to match the changes the PR makes. We shouldn't merge PRs where there is an obvious and material discrepancy.

@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 Apr 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

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/en Issues or PRs related to English language size/S Denotes a PR that changes 10-29 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Links to Cloud Native Glossary to become more newbie-friendly

3 participants