Link to the Synapse docs component and add a distribution licence page#54
Open
alexolivier wants to merge 2 commits into
Open
Link to the Synapse docs component and add a distribution licence page#54alexolivier wants to merge 2 commits into
alexolivier wants to merge 2 commits into
Conversation
Signed-off-by: Alex Olivier <alex@alexolivier.me>
alexolivier
marked this pull request as ready for review
July 15, 2026 08:10
alexolivier
enabled auto-merge (squash)
July 16, 2026 11:26
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
1 participant
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.
Problem / Intent
Cerbos Synapse now has its own documentation component (published at docs.cerbos.dev/synapse/latest/), so the Hub docs should no longer carry their own Synapse product page or duplicate its content. Cross-component links throughout the site should also use native Antora xrefs rather than hard-coded URLs. The one piece of Synapse-adjacent content that belongs in Hub — distribution licence key management, an organization-settings feature that is not Synapse specific — needs a home of its own.
Approach
Remove the standalone Synapse page and point every Synapse reference (nav, index, concepts, release notes) at the
synapseAntora component via native xrefs. Add a "Cerbos platform" group to the top of the nav linking the PDP, Hub, and Synapse components plus the integrations ecosystem page. Convert the existing hard-coded docs.cerbos.dev PDP links toxref:cerbos:policies:...form. Move the distribution licence key content (issue, rotate, revoke) to a new generic page under Administration, framed around commercial component distribution with Synapse called out as the current use case.