Publishing And Sharing Documentation
Publish selected architecture evidence and control reader access
Publishing creates a versioned documentation experience from an Architecture View. Publication access and guest share links are separate controls.
1. Prepare The View
Open Documentation → Views, select a View, and open its documentation area. Review generated and manually edited content, referenced Architecture Documents, images, and selected model evidence.
2. Configure The Publication
Choose Publish and configure:
- Publication title and optional description
- Public or private visibility
- The sections appropriate for the audience
- A preset Preview Theme
- Expiration: never, one day, one week, one month, or a custom date
Available sections include Systems, Relationships, Data Model, Context Map, Capability Map, Behavior Model, Coupling, Complexity, Blast Radius, Workflows, Deployments, Architecture Handbook, and selected Architecture Documents. Empty or unavailable sections should not be included merely for completeness.
3. Review Publication History
Publication history records prior releases and their version. Preview the result before sharing it, especially after changing section selection, theme, expiration, or the active architecture version.
Republish after a meaningful architecture update. Unpublish or let the publication expire when the material should no longer be available.
Public And Private Publications
A public publication can be opened through its public URL until it is unpublished or expires.
A private publication requires controlled guest access. Publishing privately does not automatically create a reusable guest token.
Guest Share Links
From the View preview, create a named share link for a private publication. A link can have:
- An optional expiration
- An optional maximum-use limit
- Usage and last-used tracking
- A preset creator theme
The full share URL is sensitive and may only be shown when it is created. Copy it then and distribute it through an appropriate channel. Revoke the token when access is no longer required.
Preview, Print, And Reader Experience
Use Preview to verify the exact reader experience. Published documentation is responsive and includes navigation for the selected sections. The browser print flow can be used for printing or PDF capture where appropriate.
Checklist Before Sharing
- Confirm the intended architecture version.
- Remove irrelevant or sensitive sections.
- Verify referenced Documents and images.
- Confirm public versus private access.
- Set an expiration for temporary reviews.
- Test the URL in a signed-out browser session.
- Record who owns republishing and revocation.