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

DOCS: CE-661 Refactor CNI plugin content #23707

Merged
merged 15 commits into from
Aug 6, 2024
Merged

DOCS: CE-661 Refactor CNI plugin content #23707

merged 15 commits into from
Aug 6, 2024

Conversation

aimeeu
Copy link
Contributor

@aimeeu aimeeu commented Jul 30, 2024

  • Pulled common content from multiple pages into new partials
  • Refactored install/index to be OS-based so I could add linux-distro-based instructions to install-consul-cni-plugins.mdx partial. The tab groups on the install/index page do match and change focus as expected.
  • Moved CNI overview-type content to networking/index
  • Refactored networking/cni to include install CNI plugins and configuration content (from install/index).
  • Moved CNI plugins explanation in bridge mode configuration section into bullet points. They had been #### headings, which aren't rendered in the R page TOC. I tried to simplify and format the bullet point content to be easier to scan.

Jira: CE-661

Deploy previews:

Fixes: #23229
Fixes: #23583

@aimeeu aimeeu added the theme/docs Documentation issues and enhancements label Jul 30, 2024
Copy link
Member

@tgross tgross left a comment

Choose a reason for hiding this comment

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

This looks great @aimeeu!

One meta-comment on formatting. We've always hard-wrapped documentation in the Nomad repository because it makes it easier to review changes. If the documentation teams want to standardize on non-hard-wrapped markdown across the org, I suppose we'll need to go along with that. But if not, it'd be nice to stay consistent with the rest of the repo. That'll keep PR diffs a little more reasonably sized as well.

website/content/docs/networking/index.mdx Outdated Show resolved Hide resolved
website/content/docs/networking/cni.mdx Outdated Show resolved Hide resolved
website/content/docs/networking/cni.mdx Outdated Show resolved Hide resolved
website/content/partials/install/cgroup-controllers.mdx Outdated Show resolved Hide resolved
Copy link
Contributor

@tunzor tunzor left a comment

Choose a reason for hiding this comment

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

Great job! A few organization edits and suggestions and other general clean-up but looks good 👍

website/content/docs/install/index.mdx Show resolved Hide resolved
website/content/partials/install/manual-install.mdx Outdated Show resolved Hide resolved
website/content/docs/install/index.mdx Outdated Show resolved Hide resolved
website/content/docs/install/index.mdx Outdated Show resolved Hide resolved
website/content/docs/install/index.mdx Outdated Show resolved Hide resolved
website/content/docs/networking/index.mdx Outdated Show resolved Hide resolved
website/content/docs/networking/index.mdx Outdated Show resolved Hide resolved
website/content/docs/networking/index.mdx Outdated Show resolved Hide resolved
website/content/docs/networking/index.mdx Outdated Show resolved Hide resolved
website/content/docs/networking/index.mdx Outdated Show resolved Hide resolved
@aimeeu aimeeu changed the title DOCS: CE-661 Refactor CNI plugin content DOCS: CE-661 Refactor CNI plugin content. WIP Jul 31, 2024
@aimeeu aimeeu marked this pull request as draft July 31, 2024 20:27
Copy link
Contributor

@boruszak boruszak left a comment

Choose a reason for hiding this comment

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

Great work!

I reviewed for style, focusing on the partials.

Also, to format deployment preview links so that they use a stable branch that automatically updates after each new Vercel deployment, format the URL as <repo>-git-<branch-name>-hashicorp.vercel.app. For this PR, it's https://nomad-git-docs-ce661-hashicorp.vercel.app/

website/content/partials/install/bridge-iptables.mdx Outdated Show resolved Hide resolved
website/content/partials/install/bridge-iptables.mdx Outdated Show resolved Hide resolved
website/content/partials/install/bridge-iptables.mdx Outdated Show resolved Hide resolved
website/content/partials/install/bridge-iptables.mdx Outdated Show resolved Hide resolved
website/content/partials/install/cgroup-controllers.mdx Outdated Show resolved Hide resolved
website/content/partials/install/install-cni-plugins.mdx Outdated Show resolved Hide resolved
website/content/partials/install/install-cni-plugins.mdx Outdated Show resolved Hide resolved
website/content/docs/networking/cni.mdx Outdated Show resolved Hide resolved
@aimeeu aimeeu changed the title DOCS: CE-661 Refactor CNI plugin content. WIP DOCS: CE-661 Refactor CNI plugin content Aug 2, 2024
@aimeeu aimeeu marked this pull request as ready for review August 2, 2024 19:21
Copy link
Contributor

@boruszak boruszak left a comment

Choose a reason for hiding this comment

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

A couple of minor nits. Otherwise LGTM!

Approving so that you're not blocked on my end!

website/content/partials/install/cgroup-controllers.mdx Outdated Show resolved Hide resolved

This configuration uses the following CNI reference plugins:

- loopback: The loopback plugin sets the default local interface, lo0, created
Copy link
Contributor

Choose a reason for hiding this comment

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

This is the only list item without a link to the plugin

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@boruszak there is no documentation for the loopback plugin. It never had docs - I went back several release. The plugin was deprecated in 2019, but it is still distributed as part of the CNI plugins release.

@tgross tgross added backport/1.6.x backport to 1.6.x release line backport/1.7.x backport to 1.7.x release line backport/ent/1.6.x+ent Changes are backported to 1.6.x+ent backport/ent/1.7.x+ent Changes are backported to 1.7.x+ent backport/1.8.x backport to 1.8.x release line theme/cni theme/networking labels Aug 6, 2024
@tgross
Copy link
Member

tgross commented Aug 6, 2024

I've added a couple of Fixes: links to the description so that we'll close out some open GitHub issues with the post-installation improvements here.

@tgross tgross merged commit 021692e into main Aug 6, 2024
7 checks passed
@tgross tgross deleted the docs-ce661 branch August 6, 2024 18:47
tgross pushed a commit that referenced this pull request Aug 6, 2024
- Pulled common content from multiple pages into new partials
- Refactored install/index to be OS-based so I could add linux-distro-based instructions to install-consul-cni-plugins.mdx partial. The tab groups on the install/index page do match and change focus as expected.
- Moved CNI overview-type content to networking/index
- Refactored networking/cni to include install CNI plugins and configuration content (from install/index).
- Moved CNI plugins explanation in bridge mode configuration section into bullet points. They had been #### headings, which aren't rendered in the R page TOC. I tried to simplify and format the bullet point content to be easier to scan.

Ref: https://hashicorp.atlassian.net/browse/CE-661
Fixes: #23229
Fixes: #23583
tgross pushed a commit that referenced this pull request Aug 6, 2024
- Pulled common content from multiple pages into new partials
- Refactored install/index to be OS-based so I could add linux-distro-based instructions to install-consul-cni-plugins.mdx partial. The tab groups on the install/index page do match and change focus as expected.
- Moved CNI overview-type content to networking/index
- Refactored networking/cni to include install CNI plugins and configuration content (from install/index).
- Moved CNI plugins explanation in bridge mode configuration section into bullet points. They had been #### headings, which aren't rendered in the R page TOC. I tried to simplify and format the bullet point content to be easier to scan.

Ref: https://hashicorp.atlassian.net/browse/CE-661
Fixes: #23229
Fixes: #23583
tgross pushed a commit that referenced this pull request Aug 6, 2024
- Pulled common content from multiple pages into new partials
- Refactored install/index to be OS-based so I could add linux-distro-based instructions to install-consul-cni-plugins.mdx partial. The tab groups on the install/index page do match and change focus as expected.
- Moved CNI overview-type content to networking/index
- Refactored networking/cni to include install CNI plugins and configuration content (from install/index).
- Moved CNI plugins explanation in bridge mode configuration section into bullet points. They had been #### headings, which aren't rendered in the R page TOC. I tried to simplify and format the bullet point content to be easier to scan.

Ref: https://hashicorp.atlassian.net/browse/CE-661
Fixes: #23229
Fixes: #23583
tgross added a commit that referenced this pull request Aug 6, 2024
)

- Pulled common content from multiple pages into new partials
- Refactored install/index to be OS-based so I could add linux-distro-based instructions to install-consul-cni-plugins.mdx partial. The tab groups on the install/index page do match and change focus as expected.
- Moved CNI overview-type content to networking/index
- Refactored networking/cni to include install CNI plugins and configuration content (from install/index).
- Moved CNI plugins explanation in bridge mode configuration section into bullet points. They had been #### headings, which aren't rendered in the R page TOC. I tried to simplify and format the bullet point content to be easier to scan.

Ref: https://hashicorp.atlassian.net/browse/CE-661
Fixes: #23229
Fixes: #23583

Co-authored-by: Aimee Ukasick <[email protected]>
tgross added a commit that referenced this pull request Aug 6, 2024
)

- Pulled common content from multiple pages into new partials
- Refactored install/index to be OS-based so I could add linux-distro-based instructions to install-consul-cni-plugins.mdx partial. The tab groups on the install/index page do match and change focus as expected.
- Moved CNI overview-type content to networking/index
- Refactored networking/cni to include install CNI plugins and configuration content (from install/index).
- Moved CNI plugins explanation in bridge mode configuration section into bullet points. They had been #### headings, which aren't rendered in the R page TOC. I tried to simplify and format the bullet point content to be easier to scan.

Ref: https://hashicorp.atlassian.net/browse/CE-661
Fixes: #23229
Fixes: #23583

Co-authored-by: Aimee Ukasick <[email protected]>
tgross pushed a commit that referenced this pull request Aug 6, 2024
- Pulled common content from multiple pages into new partials
- Refactored install/index to be OS-based so I could add linux-distro-based instructions to install-consul-cni-plugins.mdx partial. The tab groups on the install/index page do match and change focus as expected.
- Moved CNI overview-type content to networking/index
- Refactored networking/cni to include install CNI plugins and configuration content (from install/index).
- Moved CNI plugins explanation in bridge mode configuration section into bullet points. They had been #### headings, which aren't rendered in the R page TOC. I tried to simplify and format the bullet point content to be easier to scan.

Ref: https://hashicorp.atlassian.net/browse/CE-661
Fixes: #23229
Fixes: #23583

Co-authored-by: Aimee Ukasick <[email protected]>
Copy link

I'm going to lock this pull request because it has been closed for 120 days ⏳. This helps our maintainers find and focus on the active contributions.
If you have found a problem that seems related to this change, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Dec 21, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
backport/ent/1.6.x+ent Changes are backported to 1.6.x+ent backport/ent/1.7.x+ent Changes are backported to 1.7.x+ent backport/1.6.x backport to 1.6.x release line backport/1.7.x backport to 1.7.x release line backport/1.8.x backport to 1.8.x release line theme/cni theme/docs Documentation issues and enhancements theme/networking
Projects
None yet
4 participants