diff --git a/articles/hubs/publishing.md b/articles/hubs/publishing.md index 8b13789..58d738a 100644 --- a/articles/hubs/publishing.md +++ b/articles/hubs/publishing.md @@ -1 +1,32 @@ +# Publishing +## What + +Publishing your documentation has never been easier. Stoplight NEXT has added: +- New **Integrations** for Segment, Intercom, and Google Analytics to allow for traffic monitoring and additional analytics +- New **Authorizations** including Username/Password Logins, Auth0, and SAML for different levels of security like SSO +- New **Builds** section displays additional information and access to Live Builds + +Take that Gutenberg! + +## Who + +- **Organization Owners**, **Account Owners**, and **Administrators** can publish Hubs + +## How + +1. From the Stoplight editor, click on **Publish** in the far left-hand toolbar +2. Input a **subdomain** to host on Stoplight's .tech-docs.io + - Or input a **custom domain** (optional) +3. Once completed, click **Next ->** +4. Select the Hub you wish to publish under **Hub File** +5. Add Integrations to **Segment**, **Intercom**, and **Google Analytics** under Integrations (optional) +6. Add security via **Username/Passwords Login**, **Auth0**, or **SAML** (optional) +7. Once completed, click **Publish** in the top left +8. A confirmation window will ask you to confirm your selection, click **Okay** +9. Once confirmed, **Build Logs** will display your current progress + - The process usually takes 2-5 minutes +10. Once the process has completed, a **green success message** will popup letting you know it was published succesfully +11. Once a Hub is published, it will appear under **Builds** +12. To unpublish a Hub, select **Unpublish** in the **Danger Zone** underneath **Builds** + - If you wish to delete all builds and release the domain you are currently using, select **Remove Domain**