docs: professionalize docs — document web UI/operator/day-2 ops, fix site-wide table rendering#5238
Merged
Merged
Conversation
On Astro 6.4.x the implicit GFM default (tables, strikethrough, autolinks) is dropped when integrations pass the deprecated markdown.remarkPlugins hook, so every table on the published site currently renders as literal pipe text (verify on https://ksail.devantler.tech/support-matrix/). Pin markdown.gfm: true so table rendering cannot silently regress again. Also adds the new feature pages to the sidebar. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…ture pages New pages for previously undocumented surfaces: - Web UI & Desktop App (ksail ui / ksail desktop / in-cluster UI) - Kubernetes Operator (Helm chart, Cluster CRD, OIDC, read-only mode) - Day-2 Operations (diagnose health scoring, switch picker, repair) Expanded the stub feature pages with real content: backup/restore (scoping flags, restore policies, migration walkthrough), CI/CD (composite action inputs/outputs, GitOps and scanning recipes), registry management (local vs mirror registries, syntax explained), and workload management (full command map grouped by task). Freshness fixes: concepts now lists all six distributions plus the AWS provider; the homepage no longer overstates EKS support and gains tiles for diagnostics, the web UI, and the operator. Presentation: the features overview is reorganized into journey-grouped LinkCards (run clusters / ship workloads / scale out); custom.css gains theme-matched LinkCard and kbd styling with reduced-motion guards. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Contributor
✅MegaLinter analysis: Success✅ Linters with no issuesactionlint, bash-exec, git_diff, hadolint, jscpd, jsonlint, lychee, markdown-table-formatter, markdownlint, prettier, prettier, shellcheck, shfmt, stylelint, syft, trivy-sbom, trufflehog, v8r, v8r, yamllint Notices📣 MegaLinter 9.5.0 is out! Discover the new features and security recommendations in the release announcement. (Skip this info by defining See detailed reports in MegaLinter artifacts
|
Target the LinkCard title span directly instead of the descendant anchor, so the selector's key element no longer conflicts with the higher-specificity markdown link rule above it. Same computed style (verified in preview). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
![ksail-bot[bot]](https://avatars.githubusercontent.com/in/2880167?s=60&v=4){kind=small}
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
A documentation professionalization pass: closes the biggest content gaps, fixes stale claims, upgrades presentation — and fixes a site-wide rendering regression found along the way.
🐛 Site-wide fix: GFM tables broken in production
Every markdown table on the published site currently renders as literal pipe text (see the live support matrix). On Astro 6.4.x the implicit GFM default is dropped when integrations use the deprecated
markdown.remarkPluginshook. Pinningmarkdown: { gfm: true }inastro.config.mjsrestores tables everywhere (verified: support-matrix goes from 0 to 8<table>elements).📄 New pages (previously undocumented features)
ksail ui,ksail desktop, and the in-cluster UI; one UI, three surfaces, with a mermaid overview and read-only/OIDC guidanceClusterCRD usage, web UI enablement, OIDC, uninstall caveatscluster diagnose(health scoring, JSON output, AI integration),cluster switch(picker, history, filtering),cluster repair✍️ Stub pages expanded with real content
[user:pass@]host[=upstream]syntax explained, declarative config🧭 Freshness & presentation
<kbd>styling, reduced-motion guards; sidebar gains the new pagesValidation
npm run buildsucceeds (176 pages); all changed pages verified to contain rendered<table>elementscli-flags/pages untouched)🤖 Generated with Claude Code