Skip to content

feat(portal): Map apps to consumers#5847

Merged
cloudjumpercat merged 5 commits into
mainfrom
feat/app-map-consumer
Jul 14, 2026
Merged

feat(portal): Map apps to consumers#5847
cloudjumpercat merged 5 commits into
mainfrom
feat/app-map-consumer

Conversation

@cloudjumpercat

@cloudjumpercat cloudjumpercat commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Description

Splits the Dev Portal docs from the Identity ones (Dev Portal goes GA next Monday)

Preview Links

/dev-portal/self-service/
/identity/principals/

Checklist

  • Tested how-to docs. If not, note why here.
  • All pages contain metadata.
  • Any new docs link to existing docs.
  • All autogenerated instructions render correctly (API, decK, Konnect, Kong Manager).
  • Style guide (capitalized gateway entities, placeholder URLs) implemented correctly.
  • Every page has a description entry in frontmatter.
  • Add new pages to the product documentation index (if applicable).

@cloudjumpercat cloudjumpercat added do not merge Issues/ PRs whose changes should not be merged at this time release-docs Docs for release labels Jul 6, 2026
@netlify

netlify Bot commented Jul 6, 2026

Copy link
Copy Markdown

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit 97ccbf6
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6a5535e5362f1800080cce71
😎 Deploy Preview https://deploy-preview-5847--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.

@cloudjumpercat
cloudjumpercat force-pushed the feat/app-map-consumer branch 2 times, most recently from 7cd3823 to c124506 Compare July 7, 2026 13:28
@cloudjumpercat
cloudjumpercat marked this pull request as ready for review July 7, 2026 13:47
@cloudjumpercat
cloudjumpercat requested a review from a team as a code owner July 7, 2026 13:47
Copilot AI review requested due to automatic review settings July 7, 2026 13:47

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

This PR reorganizes documentation ahead of Dev Portal GA by moving “developer self-service” content from a Dev Portal landing page into a reference page, and updating Identity/Dev Portal docs to describe application↔principal↔Consumer mapping for plugin application.

Changes:

  • Replace the Dev Portal “self-service” landing page with a new reference doc at /dev-portal/self-service/.
  • Update principals documentation to include Dev Portal application mapping and add a latency note.
  • Update ACE/KAA docs and the Identity landing page to link to the new “apply plugins to applications” guidance.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
app/kong-identity/principals-and-directories.md Updates principal entity mapping to include Dev Portal applications; adds a latency note under limitations.
app/dev-portal/self-service.md New reference page consolidating self-service guidance and new “apply plugins” instructions (API + UI).
app/_landing_pages/identity.yaml Adds a CTA from Identity landing page to the new Dev Portal “apply plugins” section.
app/_landing_pages/dev-portal/self-service.yaml Removes the old landing-page implementation of the self-service content.
app/_includes/plugins/ace/ace-overview.md Adds guidance about principal lookups when applying plugins to Dev Portal applications.
app/_includes/dev-portal/kaa-vs-ace.md Adds guidance about principal lookups for app→Consumer/principal plugin application flows.

Comment thread app/kong-identity/principals-and-directories.md Outdated
Comment thread app/_includes/plugins/ace/ace-overview.md Outdated
Comment thread app/_includes/dev-portal/kaa-vs-ace.md Outdated

@juliamrch juliamrch left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Added some reviews, they might be out of scope since the content comes from an older file, apply if you find them relevant. Regarding cache, and similar operations, I think it's especially important to avoid passive voice and to clarify what and who does the action. Users sometimes think they are the ones who need to empty the control plane cache, for example.

Comment thread app/_includes/dev-portal/kaa-vs-ace.md Outdated
Comment thread app/_includes/dev-portal/kaa-vs-ace.md Outdated
Comment thread app/_includes/plugins/ace/ace-overview.md Outdated
Comment thread app/dev-portal/self-service.md
@cloudjumpercat
cloudjumpercat force-pushed the feat/app-map-consumer branch from e1738c4 to 86f513a Compare July 8, 2026 19:02
Base automatically changed from release/kong-identity-m0 to main July 10, 2026 20:10
cloudjumpercat and others added 4 commits July 10, 2026 15:44
* Update reference content

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Dev portal variable, caching infos

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* UI step for link consumer, API steps for principal/plugin link, convert yaml to md

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* fix principal requests

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Apply PM/eng feedback

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Adjust kaa vs ace wording

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Fix section lead in

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Apply suggestions from copilot

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Fix consumer viewer role thingy

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
Co-authored-by: Julia <101819212+juliamrch@users.noreply.github.com>
Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
@cloudjumpercat
cloudjumpercat force-pushed the feat/app-map-consumer branch from 86f513a to 6adbf00 Compare July 10, 2026 20:45
Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
@cloudjumpercat
cloudjumpercat merged commit 06f36f0 into main Jul 14, 2026
17 checks passed
@cloudjumpercat
cloudjumpercat deleted the feat/app-map-consumer branch July 14, 2026 17:02
juliamrch added a commit that referenced this pull request Jul 17, 2026
* feat(portal): Apply plugins to apps (#5663)

* Update reference content

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Dev portal variable, caching infos

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* UI step for link consumer, API steps for principal/plugin link, convert yaml to md

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* fix principal requests

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Apply PM/eng feedback

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Adjust kaa vs ace wording

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Fix section lead in

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Apply suggestions from copilot

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Fix consumer viewer role thingy

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Re-add all Dev Portal stuff and uncomment the one thing

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Apply suggestions from code review

Co-authored-by: Julia <101819212+juliamrch@users.noreply.github.com>

* Finish applying feedback

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

* Add app and dev automation

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>

---------

Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Julia <101819212+juliamrch@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do not merge Issues/ PRs whose changes should not be merged at this time release-docs Docs for release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants