Update publishing.md
This commit is contained in:
@@ -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**
|
||||
|
||||
Reference in New Issue
Block a user