44 lines
2.2 KiB
Markdown
44 lines
2.2 KiB
Markdown
# Publishing
|
|
|
|
|
|
|
|
## What
|
|
|
|
Publishing your documentation has never been easier. Stoplight has added:
|
|
- New **Integrations** for Segment, Intercom, and Google Analytics to allow for traffic monitoring and additional analytics
|
|
- New **Authorizations** to make sure your documentation is secure at all times. This includes basic user/password authentication and SSO provider integration, powered by Auth0, SAML, and more.
|
|
- New **Builds** section for tracking published Hubs, including when a Hub was published, who published it, and under what domain.
|
|
|
|
>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** under Stoplight's tech-docs.io domain
|
|
- 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 display at the bottom of the screen, letting you know that the Hub 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**
|
|
|
|
---
|
|
**Related Articles**
|
|
- [Documentation with Hubs](/documentation/introduction)
|
|
- [Routing](/documentation/getting-started/routing)
|
|
- [Headers](/documentation/getting-started/header-footer)
|
|
- [Pages](/documentation/getting-started/pages)
|
|
- [Subpages](/documentation/getting-started/subpages)
|
|
- [Blocks](/documentation/blocks)
|