feat(portal): Map apps to consumers#5847
Conversation
✅ Deploy Preview for kongdeveloper ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
7cd3823 to
c124506
Compare
There was a problem hiding this comment.
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. |
juliamrch
left a comment
There was a problem hiding this comment.
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.
e1738c4 to
86f513a
Compare
* 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>
86f513a to
6adbf00
Compare
Signed-off-by: Diana <75819066+cloudjumpercat@users.noreply.github.com>
* 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>
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
descriptionentry in frontmatter.