Skip to content

task(docs): split kongctl declarative configuration by topic - #7950

Open
rspurgeon wants to merge 2 commits into
mainfrom
docs/kongctl-declarative-topics
Open

rspurgeon wants to merge 2 commits into
mainfrom
docs/kongctl-declarative-topics

Conversation

@rspurgeon

@rspurgeon rspurgeon commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

The declarative guide mixes introductory workflows with detailed language and resource lifecycle rules. Replace it with a short overview and twelve child pages, with navigation and parent breadcrumbs. Keep decK integration on its existing reference page.

Preserve compatibility anchors, including #environment-management, and update incoming links. Consolidate tag rules in their topic pages and clarify sync-plan execution, namespace guardrails, AI Gateway child ownership, typed references, and recovery through fresh planning instead of replaying an old plan.

Based on updated main, including merged #7890. Companion kongctl repository PR: Kong/kongctl#2729.

Validation:

  • Full production Jekyll build passed; final rendering checked all thirteen overview/topic pages for headings and duplicate anchors.
  • Frontmatter and Vale passed with zero alerts.
  • Checked 119 local Markdown destinations and parsed 97 YAML examples across both repositories; both quick starts matched the installed portal schema.
  • git diff --check passed.

@rspurgeon
rspurgeon requested a review from a team as a code owner November 6, 2026 16:58
@kong-ksai

kong-ksai Bot commented Nov 6, 2026

Copy link
Copy Markdown
Contributor

⏹️ KSAI Review: Skipped

Note

Triage found nothing to review: a change on an auth path decides who gets in. Push a change to reviewable code and ask again to run a full review.

@netlify

netlify Bot commented Nov 6, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit 2e60a77
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6aee5e571b510d915ae1dc48
😎 Deploy Preview https://deploy-preview-7950--kongdeveloper.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

@rspurgeon

Copy link
Copy Markdown
Contributor Author

@Kong/team-docs let's coordinate the merging of this PR with Kong/kongctl#2729 as that will possibly break links in docs

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant