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

Add a glossary of Rancher-specific terms #358

Open
martyav opened this issue Jan 5, 2023 · 4 comments
Open

Add a glossary of Rancher-specific terms #358

martyav opened this issue Jan 5, 2023 · 4 comments
Assignees
Labels
docs-site-meta meta issues about the docs site, such as site design, search, organization, etc.

Comments

@martyav
Copy link
Contributor

martyav commented Jan 5, 2023

Summary:
Rancher (and other SUSE projects/products) use some jargon that can be confusing for newbies.

Details:

Kubernetes already has some overhead in the form of jargon ("charts", "pods", etc.)

Rancher and other SUSE projects and products also come with their own jargon. It can sometimes be difficult to tell if something is a general Kubernetes term or if it's specific to Rancher or RKE.

Examples:

  • Rancher using "project" for, roughly, "namespace" (I realize this is because projects predate namespaces)
  • RKE 2 using "machine" for "node"

Let's compile a list of our jargon and put it in the docs as a glossary.


The glossary pages we added to the docset include a lot of HTML tags. This note was originally listed on the glossary page files, explaining why:

This page uses HTML definition list tags. dl indicates the start and end of a definition list. dt indicates the defined term, and dd the definition. These will stay in place until we upgrade to Docusaurus 3 and are able to add the remark-definition-list plugin for native Markdown syntax. We are currently blocked as the plugin requires a handler that isn't currently exposed. See facebook/docusaurus#8743 (comment) and facebook/docusaurus#9674

More context on this from #1125:

We (@martyav & @sunilarjun) looked into adding a plugin that would provide native Markdown syntax for definition lists. We landed on this page , which has instructions on adding remark-deflist (repo) to your Docusaurus instance, but the instructions didn't seem to work for our config. I tried remark-definition-list (repo), but that didn't work either. While looking for a solution, I ran across this facebook/docusaurus#8743 (reply in thread) an https://github.com/facebook/docusaurus/discussions/8743complaining that the instructions for adding Remark plugins needed improvement. It seems that the plugins need a remark-rehype handler to be configured. There was a https://github.com/facebook/docusaurus/pull/9674to add this functionality to the Docusaurus config file, but I don't think it's available yet on Docusaurus 2. We might need to upgrade to Docusaurus 3. In the meantime, the HTML tags are perfectly functional.

@martyav martyav added the docs-site-meta meta issues about the docs site, such as site design, search, organization, etc. label Jan 31, 2023
@martyav
Copy link
Contributor Author

martyav commented Feb 1, 2024

List of terms to define

  • Apps
  • Apps & Marketplace
  • Catalogs (section)
  • Catalogs (Helm chart repos)
  • Cloud credentials
  • Community (Rancher edition) -> discuss with Cam
  • Deployment
  • Downstream cluster
  • Extensions
  • External auth
  • Hosted cluster
  • Imported
  • Integrations
  • Hosted cluster
  • Hosted pools
  • K3s
  • Local auth
  • Local cluster
  • Machine pool
  • Managed cluster
  • Neuvector Prime
  • Node template
  • Prime
  • Project
  • Project resource quotas
  • PSA
  • PSA Config Template
  • PSP
  • Rancher chart
  • Rancher CLI
  • Rancher Enterprise
  • Rancher Kubernetes API (RK-API)
  • Rancher Kubernetes Engine
  • Rancher Prime
  • Rancher server
  • Registered cluster
  • RKE1
  • RKE2
  • RKE Government
  • Roles
  • UI
  • Upstream cluster
  • Users
  • Workload

@sunilarjun
Copy link
Contributor

Core concepts/terms from Fleet to be considered: https://fleet.rancher.io/concepts

@martyav martyav self-assigned this Feb 9, 2024
@martyav martyav mentioned this issue Feb 14, 2024
46 tasks
@martyav
Copy link
Contributor Author

martyav commented Jun 5, 2024

From #1125:

For the purposes of dividing up the word on definitions --

@LucasSaintarbor, could you do Managed Clusters through Rancher Enterprise, and @sunilarjun could you take RK-API through Upstream clusters? I tried to do it evenly so that we each have 8 or 9 entries.

If we add more it should be roughly,
Me - Icons, Numbers, Symbols to L
Lucas - M to Rancher E
Sunil - Rancher F to Z

If something is already filled out, feel free to modify and review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs-site-meta meta issues about the docs site, such as site design, search, organization, etc.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants