chore(gateway): 3.16 doc QA - #7233
Merged
Merged
Conversation
✅ Deploy Preview for kongdeveloper ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
cloudjumpercat
approved these changes
Sep 15, 2026
cloudjumpercat
left a comment
cloudjumpercat
left a comment
Contributor
There was a problem hiding this comment.
Approved so you aren't blocked, just a few wording nitpicks and the two node GET requests I left suggestions to make those into the curl blocks to make them actionable.
Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
lena-larionova
commented
Sep 15, 2026
lena-larionova
added a commit
that referenced
this pull request
Sep 15, 2026
* bootstrap Gateway 3.16 release branch * Generate Kong configuration JSON for version 3.16 (#6721) Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> * Download Plugin Schemas and Metadata for 3.16 (#6723) Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> * scaffold governance plugin * Download Plugin Schemas and Metadata for 3.16 (#6737) * Download Plugin Schemas and Metadata for 3.16 * rename Governance plugin to entitlement-enforcement --------- Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> Co-authored-by: lena-larionova <lena.larionova@konghq.com> * chore(gateway): Update support matrix for 3.16 (#7053) * update support matrix for 3.16 * add os eols * docs(sandboxing): add kong.client.get_principal to strict mode allowlist (#6563) * feat(gateway): Add metrics PDK functions for sandbox (#6571) * feat(gateway): Add metrics PDK functions for sandbox Signed-off-by: Icarus Wu <icaruswu66@qq.com> * add version tag --------- Signed-off-by: Icarus Wu <icaruswu66@qq.com> Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> * feat(gateway): add new debugger span attributes (#6572) * feat: update debugger span attributes * add version tags --------- Co-authored-by: lena-larionova <lena.larionova@konghq.com> * add FAQ for new analytics_enabled option (#7087) * feat(gateway): Dynamic log levels for data planes (#7095) * dynamic log levels for data planes * fix table and use consistent punctuation * Apply batched suggestions from code review Co-authored-by: jbaross <james.baross@konghq.com> Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> --------- Co-authored-by: jbaross <james.baross@konghq.com> * Autodocs update from next/3.16.x.x (#7106) * Autodocs update * fix version directory names * fix indent error --------- Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> Co-authored-by: lena-larionova <lena.larionova@konghq.com> * tap only mode for request validator (#7097) * feat(gateway): Proxy caching by principal (#7102) * proxy caching by principal * Apply batched suggestions from code review Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --------- Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * docs(gateway): explain dynamic plugin ordering and the plugin_ordering_algorithm option Add a standalone explainer for dynamic plugin ordering and document the new `plugin_ordering_algorithm` option that selects which ordering algorithm runs. * app/gateway/plugins/plugin-ordering.md (new): the principle behind dynamic ordering ("at each step, run the highest-priority plugin whose `after` requirements are already met"), a hand-worked step-by-step example so readers can predict the exact order, a new-vs-legacy comparison (including the FTI-7177 displacement and the `before` != `after` asymmetry, with concrete sorted results), the guarantees and non-guarantees, how request scope changes the result, and how to adopt `new` on upgrade. * app/_gateway_entities/plugin.md: trim the "Dynamic plugin ordering" reference section to link to the new explainer, and note the `plugin_ordering_algorithm` option under known limitations. * app/_indices/gateway.yaml: add the new page to the "How Gateway Works" navigation. FTI-7177 Signed-off-by: Walker Zhao <walker.zhao@konghq.com> Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Added works_on to the frontmatter in plugin-ordering.md:11-13: works_on: - on-prem - konnect Signed-off-by: Walker Zhao <walker.zhao@konghq.com> Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * docs(gateway): update plugin ordering guide for priority_preserving The doc was written against an early build and still called the algorithm "new" -- the shipped option is `legacy` / `priority_preserving` (kong.conf.default). Rename throughout, replace the placeholder A/B/C and e/d/c/b/a examples with real kong-ee plugins and priorities, and add a worked example (with the fix) for the one documented hard limitation: an unconfigured plugin can occasionally move further than a hand-picked order would need, in roughly one configuration in twenty that uses `ordering`. Also fixes a real accuracy bug carried by the old examples: an unconfigured plugin's absolute slot can shift when a mover passes through it, even though its order relative to other unconfigured plugins does not -- the old text claimed it "stays put" / "keeps its place," which wasn't true for the abstract example's `c`. Adds a short section on plugins that share a priority (routine for cloned plugins that don't override it) and bumps min_version to 3.16, matching the changelog entries this doc describes. Signed-off-by: Walker Zhao <walker.zhao@konghq.com> * docs(gateway): split plugin ordering into legacy and priority_preserving pages One merged page made it hard to say which algorithm produced which behavior. Split it into plugin-ordering-legacy.md and plugin-ordering-priority-preserving.md, each self-contained, and redirect the old URL to the priority_preserving page. The legacy page documents its real mechanism for the first time: a DFS post-order topological sort driven by a priority-ordered outer loop, where before/after build the identical dependency edge and a plugin's whole dependency chain gets appended ahead of everything else the moment the walk reaches it. Verified against the real module (topsort_plugins.lua + plugin_dependency.lua), including that its unguarded recursion does NOT overflow the stack at realistic -- or even 500,000-plugin -- chain lengths, so that is not listed as a limitation. The priority_preserving page keeps last round's content, reorganized so every comparison names which algorithm produced which result, with the legacy contrast moved up next to the worked example instead of appearing several sections later. Updates the two cross-links in plugin.md, the one nav entry in _indices/gateway.yaml, and adds a redirect for the retired URL. Signed-off-by: Walker Zhao <walker.zhao@konghq.com> * chore(gateway): OTEL metrics for 3.16 (#7107) * generate metrics for 3.16, add missing 3.15 metrics * Apply batched suggestions from code review Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> --------- Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * feat(gateway/docs-improvements): Skill for writing plugin examples for Kong plugins (#7103) * skill for writing plugin examples for Kong plugins * Apply batched suggestions from code review Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --------- Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * Download Plugin Schemas and Metadata for 3.16 (#7166) Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> * comment out plugin example to prevent failing check * feat(gateway): Simple json transformation for kafka producer plugins (#7189) * simple json transformation for kafka * add nullable to dictionary * - update public benchmark perf results for 3.16.0.0-rc.3 and minor updates for p95 data correction for previous release (#7192) * support for otel identity metrics (#7188) * fips 140-3 support in 3.16 (#7177) * feat(gateway): Metrics PDK (#7138) * draft metrics pdk docs * test how-to guide, add metrics collection pipeline, and rewrite most of the PDK ref * Apply batched suggestions from code review Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * apply reviewer feedback --------- Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * feat(gateway): Datakit and principals (#7099) * add configuration example * add principal property * fix: example title * fix: version * fix: remove callout * add principal in the use case table * how-to * related resources * Apply batched suggestions from code review Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * Apply suggestion from @juliamrch --------- Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * feat(gateway): add PostgreSQL privileges reference for Kong Gateway (#7070) * Add PostgreSQL privileges reference for Kong Gateway Document the minimal PostgreSQL role attributes and privileges Kong Gateway needs for migrations, runtime, and admin CLI operations, since no existing page covered least-privilege database setup. Cross-link it from the datastore how-to and the sibling PostgreSQL reference pages. * Apply suggestion from @juliamrch * Apply batched suggestions from code review Co-authored-by: Julia <101819212+juliamrch@users.noreply.github.com> * Update app/gateway/postgresql-privileges-reference.md * Apply suggestion from @juliamrch * Apply batched suggestions from code review Co-authored-by: Julia <101819212+juliamrch@users.noreply.github.com> * Apply suggestion from @juliamrch * Apply suggestion from @juliamrch * Update app/gateway/postgresql-privileges-reference.md * Update app/gateway/postgresql-privileges-reference.md * fix: table * fix: table - blanck lines * fix: table - quotes * Apply batched suggestions from code review Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> * fix formatting --------- Co-authored-by: Julia <101819212+juliamrch@users.noreply.github.com> Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> Co-authored-by: lena-larionova <lena.larionova@konghq.com> * feat(gateway): Dynamic plugin expression fields (#7172) * dynamic plugin expression fields * adjust prereqs to cover more cases * adjust link names * add security considerations to PDK and to expressible reference * export control plane ID programmatically instead of manually * Apply batched suggestions from code review Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> --------- Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * feat(gateway): Kafka message compression and decompression (#7203) * kafka message compression and decompression * add codec to dictionary * Apply batched suggestions from code review Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --------- Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * add oauth tab and refactor includes (#7204) * debugger changes in 3.16 (#7220) * example and description of custom CA certs for datakit call nodes (#7218) * Generate Gateway and plugins changelogs for version 3.16.0.0 (#7227) Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> * feat(gateway/m&b): Entitlement enforcement plugin docs (#7015) * entitlement enforcement plugin docs * remove credit checks feature and mark konnect-only * Apply batched suggestions from code review Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * add breaking changes entry and limitations section to plugin * minor adjustments based on demo * add diagram and rephrase limitation as configurable setting --------- Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * Regenerate Kong Gateway Admin API specs (3.16) (#7231) Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> * chore(gateway): cel-rust to cel-cpp migration breaking changes (#7229) * breaking change for cel update * clean up * feat(gateway): OIDC actor tokens and MCP protected resource metadata (#7215) * oidc mcp parity features * fix incorrect tool key * Update app/_kong_plugins/openid-connect/index.md Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> --------- Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * SBOM link for gateway 3.16 (#7232) * chore(gateway): 3.16 doc QA (#7233) * QA 3.16 docs against PM demos * Apply batched suggestions from code review Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * fix on-prem API request * minor phrasing edit --------- Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * feat(gateway): How-to guide for datakit CA certs on outbound calls (#7219) * ca cert guide draft * test and adjust * Apply batched suggestions from code review Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * test on konnect and fix all the things --------- Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> * Generate Gateway and plugins changelogs for version 3.16.0.0 (#7249) * Generate Gateway and plugins changelogs for version 3.16.0.0 * manually add breaking change entry for cel lib --------- Co-authored-by: lena-larionova <54370747+lena-larionova@users.noreply.github.com> Co-authored-by: lena-larionova <lena.larionova@konghq.com> --------- Signed-off-by: Icarus Wu <icaruswu66@qq.com> Signed-off-by: Walker Zhao <walker.zhao@konghq.com> Co-authored-by: kong-documentation-app[bot] <247127266+kong-documentation-app[bot]@users.noreply.github.com> Co-authored-by: kong-apiops <122612077+kong-apiops@users.noreply.github.com> Co-authored-by: Jay Jijie Chen <1180092+jijiechen@users.noreply.github.com> Co-authored-by: Icarus Wu <icaruswu66@qq.com> Co-authored-by: Akash Thomas <50582261+akashtjohn@users.noreply.github.com> Co-authored-by: jbaross <james.baross@konghq.com> Co-authored-by: Diana <75819066+cloudjumpercat@users.noreply.github.com> Co-authored-by: Walker Zhao <walker.zhao@konghq.com> Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Co-authored-by: Walker Zhao <findns94@gmail.com> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> Co-authored-by: tonydongkong <101685497+tonydongkong@users.noreply.github.com> Co-authored-by: Julia <101819212+juliamrch@users.noreply.github.com> Co-authored-by: Zachary Hu <6426329+outsinre@users.noreply.github.com>
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
2 participants
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.
Checked the 3.16 docs against demos in https://github.com/Kong/kong-technical-enablement/tree/main/api-gateway/3.16.
Added some details and clarifications.