Skip to content

task(docs): refresh kongctl documentation for v1.14 - #7039

Open
rspurgeon wants to merge 3 commits into
mainfrom
task/kongctl-1-14-docs
Open

task(docs): refresh kongctl documentation for v1.14#7039
rspurgeon wants to merge 3 commits into
mainfrom
task/kongctl-1-14-docs

Conversation

@rspurgeon

@rspurgeon rspurgeon commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Refresh the kongctl conceptual and resource documentation for capabilities through the upcoming v1.14 release.
  • Add complete sync-scope safety guidance, AI Gateway GA resource coverage, audit-log pull and follow workflows, token lifecycle commands, output controls, templates, lookup and secret behavior, and current dump behavior.
  • Add an end-to-end AI Gateway OpenAI quickstart and improve landing-page, command-page, and Konnect discoverability.
  • Correct works_on metadata for Konnect-only commands without editing generated CLI help.

Release gating

This draft targets publication after kongctl v1.14.0.

Keep this PR in draft until the remaining release dependencies are complete.

Validation

  • make validate-frontmatters
  • Vale on every changed Markdown and landing-page file: 0 errors, warnings, or suggestions
  • Vale on extracted Markdown frontmatter: 0 errors, warnings, or suggestions
  • git diff --check

A full local site build could not run on this host. The pinned Ruby 3.4.4 native dependencies google-protobuf and liquid-c fail to compile against the installed C toolchain because the Ruby headers do not provide the expected bool definitions. This is an environment dependency failure; the PR should still receive the normal CI build and link checks.

Closes Kong/kongctl#1998

@netlify

netlify Bot commented Aug 31, 2026

Copy link
Copy Markdown

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit 024ea68
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6a95ec3d9f13b60008a7894c
😎 Deploy Preview https://deploy-preview-7039--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.

Comment thread app/kongctl/audit-logs.md Outdated
Comment thread app/kongctl/audit-logs.md
Comment thread app/kongctl/audit-logs.md Outdated
Comment thread app/kongctl/audit-logs.md Outdated
Comment thread app/kongctl/audit-logs.md Outdated
Comment thread app/kongctl/declarative.md Outdated
Comment thread app/kongctl/supported-resources.md Outdated
@rspurgeon
rspurgeon force-pushed the task/kongctl-1-14-docs branch from 3b250ed to c2488c5 Compare August 31, 2026 17:23
@rspurgeon
rspurgeon marked this pull request as ready for review August 31, 2026 17:32
@rspurgeon
rspurgeon requested a review from a team as a code owner August 31, 2026 17:32
@rspurgeon
rspurgeon force-pushed the task/kongctl-1-14-docs branch from 4cf18ca to 72cf292 Compare August 31, 2026 19:40
@rspurgeon
rspurgeon force-pushed the task/kongctl-1-14-docs branch from 72cf292 to 024ea68 Compare August 31, 2026 21:03
@rspurgeon
rspurgeon marked this pull request as draft August 31, 2026 21:04
@rspurgeon
rspurgeon marked this pull request as ready for review August 31, 2026 21:08
@lena-larionova lena-larionova self-assigned this Aug 31, 2026
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.

task(docs): refresh developer site for current kongctl capabilities

2 participants