...
Below is a schematic describing how Confluence and Viewport are configured to publish the Synapse Docs website:
...
All drafts are edited, reviewed, and approved in a Confluence space for working drafts, called “Synapse Docs (Working Drafts)”. Think of this space as a kind of staging area for all Synapse Docs content. You are currently reading this doc from within this draft space.
Once an article has been edited, reviewed, and approved, an admin syncs the final draft to a second Confluence space for final drafts.
This final draft space contains only the finished versions of every article in the Synapse Docs library. This Confluence space is hidden to everyone except administrators to avoid confusion; keeping all working drafts in one space and all final drafts in another allows us to separate what is ready to publish and what is not.
Content in the final draft space is built into a user-facing help website using the Viewport app. When an admin triggers a new build, Viewport pulls all content from the final draft space and creates a static site.
How do I contribute?
To flag an issue or request a change to Synapse Docs, follow these steps:
Open a Jira ticket at link it to the Synapse Docs project. Specify the doc location, describe the issue, and suggest a fix.
Leave the ticket unassigned if you want the ticket triaged and managed for you.
Assign the ticket to yourself if you want to make the fix. Find the relevant page in the Synapse Docs (Working Drafts) space and edit the page by clicking the pencil icon (
). Publish your changes to the page with a version comment describing your updates. When you are done, click the Review button at the top of the page and assign an administrator (Stacey or Ryan), who will review and approve your changes and then push them to the live docs site.
For more detail and step-by-step instructions with screen caps for each of these steps, see the sections below.
...
If you or anyone else makes edits to the document after requesting approval (e.g. you enter the Confluence editor and change the text), the approval workflow will automatically revert back to a draft state, canceling the approval process, and you or someone else will have to re-request approval to move your document forward.
Special Cases
Deleting Content & Redirecting
Once a page is deleted in Confluence, its URL is no longer valid. You won’t be able to redirect from deleted content. To work around this, leave the existing page as an interstitial page and include a link to the new content as such (suggested text):
“This is not the content you’re looking for. The content you want is over here <link to new content here>.”
Confluence How To’s
Inserting and removing images
...