Skip to content

Conversation

@botantler
Copy link
Contributor

@botantler botantler bot commented Feb 11, 2026

Summary

Adds the ksail cluster update command to the main usage workflows in both README.md and docs/src/content/docs/index.mdx to ensure documentation consistency across all files.

Changes

  • ✅ Add ksail cluster update to README.md usage section (step 5)
  • ✅ Add ksail cluster update to docs/index.mdx Quick Start section (step 5)
  • ✅ Renumber subsequent steps (Connect with K9s is now step 6)

Context

The cluster update command was introduced in v5.30.0 (#2041) and was already documented in:

  • docs/src/content/docs/features.mdx (command table)
  • .github/copilot-instructions.md (CLI reference)
  • docs/src/content/docs/cli-flags/cluster/cluster-update.mdx (auto-generated)

However, it was missing from the main usage workflows shown to users in:

  • README.md (GitHub landing page)
  • docs/src/content/docs/index.mdx (documentation homepage)

This PR closes the documentation gap by adding the cluster update command to both locations, ensuring users see the complete cluster lifecycle workflow.

Related

AI generated by Update Docs

- Add ksail cluster update to main usage workflow in README.md
- Add ksail cluster update to Quick Start section in docs/index.mdx
- Ensures consistency with features.mdx and copilot-instructions.md
- References feature introduced in v5.30.0 (#2041)

The cluster update command was documented in features.mdx and
copilot-instructions.md but was missing from the README and docs
homepage, causing documentation inconsistency.
@github-actions
Copy link
Contributor

⚠️MegaLinter analysis: Success with warnings

⚠️ MARKDOWN / markdownlint - 38 errors
.github/aw/create-agentic-workflow.md:84 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Read the gh-aw instructions"]
.github/aw/create-shared-agentic-workflow.md:16 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Build on agentic workflows"]
.github/aw/create-shared-agentic-workflow.md:23 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Prefer Docker Solutions"]
.github/aw/create-shared-agentic-workflow.md:30 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Support Read-Only Tools"]
.github/aw/create-shared-agentic-workflow.md:37 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Move Write Operations to Safe ..."]
.github/aw/create-shared-agentic-workflow.md:44 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Process Agent Output in Safe J..."]
.github/aw/create-shared-agentic-workflow.md:57 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Documentation"]
.github/aw/create-shared-agentic-workflow.md:153 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Example: Processing Agent Outp..."]
.github/aw/debug-agentic-workflow.md:19 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Example: Debugging from a work..."]
.github/aw/debug-agentic-workflow.md:25 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/debug-agentic-workflow.md:39 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/debug-agentic-workflow.md:53 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Prerequisites"]
.github/aw/debug-agentic-workflow.md:60 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Key Commands Available"]
.github/aw/debug-agentic-workflow.md:91 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/debug-agentic-workflow.md:124 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/debug-agentic-workflow.md:162 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/debug-agentic-workflow.md:199 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/debug-agentic-workflow.md:208 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/debug-agentic-workflow.md:218 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/debug-agentic-workflow.md:256 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/debug-agentic-workflow.md:468 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/serena-tool.md:118 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/serena-tool.md:126 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/serena-tool.md:135 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/serena-tool.md:174 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/update-agentic-workflow.md:58 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Read the gh-aw instructions"]
.github/aw/update-agentic-workflow.md:523 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/aw/upgrade-agentic-workflows.md:13 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Prerequisites"]
.github/aw/upgrade-agentic-workflows.md:20 error MD036/no-emphasis-as-heading Emphasis used instead of a heading [Context: "Key Commands Available"]
.github/aw/upgrade-agentic-workflows.md:265 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/skills/refactor/SKILL.md:37 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/skills/refactor/SKILL.md:563 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/workflows/promote-ksail.md:118 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/workflows/promote-ksail.md:126 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
.github/workflows/update-docs.md:145 error MD028/no-blanks-blockquote Blank line inside blockquote
docs/src/content/docs/faq.md:226 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
pkg/svc/chat/docs/faq.md:226 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]
vsce/README.md:98 error MD040/fenced-code-language Fenced code blocks should have a language specified [Context: "```"]

✅ Linters with no issues

actionlint, bash-exec, git_diff, hadolint, jscpd, jsonlint, lychee, markdown-table-formatter, prettier, prettier, shellcheck, shfmt, stylelint, syft, trivy-sbom, trufflehog, v8r, v8r, yamllint

See detailed reports in MegaLinter artifacts

MegaLinter is graciously provided by OX Security

@devantler devantler marked this pull request as ready for review February 11, 2026 21:28
@devantler devantler self-requested a review as a code owner February 11, 2026 21:28
Copilot AI review requested due to automatic review settings February 11, 2026 21:28
@devantler devantler merged commit ae4342c into main Feb 11, 2026
10 checks passed
@devantler devantler deleted the docs/sync-readme-cluster-update-8b3e3d04c525557c branch February 11, 2026 21:28
@github-project-automation github-project-automation bot moved this from 🏃🏻‍♂️ In Progress to ✅ Done in 🌊 Project Board Feb 11, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds ksail cluster update to the primary “happy path” workflows shown to users (GitHub README and docs homepage), aligning the quick-start lifecycle steps with the already-existing reference documentation for the command.

Changes:

  • Add a “Update cluster configuration” step to the README usage workflow.
  • Add the same step to the docs homepage Quick Start workflow.
  • Renumber the subsequent “Connect with K9s” step accordingly.

Reviewed changes

Copilot reviewed 1 out of 1 changed files in this pull request and generated no comments.

File Description
README.md Adds ksail cluster update to the main usage workflow so the GitHub landing page reflects the full cluster lifecycle.
docs/src/content/docs/index.mdx Updates the documentation homepage Quick Start workflow to include ksail cluster update and renumbers steps.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

1 participant