Compare commits

...

6 Commits

Author SHA1 Message Date
Robert Wallach
c807d33202 Update grouping-tagging.md 2018-05-07 15:43:23 -05:00
Marc MacLeod
68ca5c9774 Update grouping-tagging.md 2018-05-05 14:24:20 -05:00
Robert Wallach
934dfa18af Create grouping-tagging.md 2018-04-30 13:53:17 -05:00
Marc MacLeod
0bb74e95b7 Update changelog-4-25-18.md 2018-04-30 12:50:11 -05:00
Marc MacLeod
11a7d87a52 Update changelog-4-25-18.md 2018-04-30 12:49:52 -05:00
Robert Wallach
55df020176 Create export-static-html.md (#220)
* Create export-static-html.md

* Update export-static-html.md
2018-04-27 10:43:32 -05:00
3 changed files with 58 additions and 7 deletions

View File

@@ -0,0 +1,31 @@
# Download Static HTML & CSS
![Download Static HTML and CSS](https://github.com/stoplightio/docs/blob/develop/assets/gifs/export-static-html.gif?raw=true)
> Requires a Pro Docs plan
## What
If you would rather host your documentation outside of Stoplight's hosted servers, you can download a built version of your Hub. Downloading a build will produce a `.zip` containing all of the minified assets necessary to load your Hub. These assets will include HTML, JAvascript, CSS, and JSON files.
## How to Download
1. Click the **Publish** icon on the far left toolbar
2. Select or create a **domain**
3. Choose a **Hub** or **OAS** file to create a build from
4. Click the **Build** button to start the build process.
> If this is your first build, it will also publish to your selected domain
5. Once your **Hub** has finished building, it will appear in the **Builds** section. Click the download icon to the right of the build
---
**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)
- [Referencing Other Data Sources](/documentation/referencing-other-data-sources)
- [Publishing](/documentation/publishing)
- [Theming](/documentation/design/theming)
- [Custom CSS](/documentation/design/custom-css)

View File

@@ -0,0 +1,16 @@
# Grouping & Tagging Endpoints in OpenAPI
![Tagging and Grouping Endpoints](https://github.com/stoplightio/docs/blob/develop/assets/gifs/modeling-tagging.gif?raw=true)
## What
Use tags to group API endpoints and provide an additional layer of organization in your OpenAPI files. When rendering your OpenAPI in read view, Stoplight will group API endpoints by their first tag.
## How
1. Click **Tag** in the top Modeling toolbar
2. Input a **Name**
3. Input a **Tag description** (optional)
4. Select the endpoint you want to tag
5. Open the **tags** dropdown, and select the tag that you just created
6. Switch to read view and you should see the endpoint grouped under that tag in the sidebar

View File

@@ -1,15 +1,19 @@
# Stoplight v4.1.0Fair Use Billing, Magic Links, Custom CSS, Landing Pages, Token Generation
The first major update to Stoplight Next is live! Weve been hard at work building out a bunch of new exciting features based on all your invaluable feedback. Now lets dig in!
# Stoplight v4.1.0 Release
This update includes fair use billing, magic links, custom css, and more.
## New 🚀
- **[Fair Use Billing](https://docs.stoplight.io/platform/getting-started/billing)**: We instituted a fair use billing policy because we wanted our users to only pay for what they use. This means that you will only pay for the users actively contributing on your account in any given 30 day billing cycle. Unleash your Engineers! 
- **Annual Billing**: We enabled a year long billing option that helps you save up to 20%. 
- **[Magic Invite Links](https://docs.stoplight.io/platform/organizations/invite-people)**: Invite people to your Organization or Project simply by generating a link and sending it. Abra Kadabra. 
- **[Fair Use Billing](https://docs.stoplight.io/platform/getting-started/billing)**: Our paid plans now only count active members that have created a project or updated project files in the past 30 days. This better aligns cost to value, and results in a lower bill in all cases. Now your members will only be added to your bill if and when they start creating content on Stoplight. Unleash your Engineers! 
- **Annual Billing**: Save up to 20%.
- **[Magic Invite Links](https://docs.stoplight.io/platform/organizations/invite-people)**: Share it via email, Slack, and other channels to easily onboard members in your organization. Fair use billing means they wont count until they actually start creating content. Abra Kadabra. 
- **[Custom CSS](https://docs.stoplight.io/documentation/design/custom-css)**: Add some custom style and flair to your documentation with Custom CSS. 
- **Custom HTML Landing Pages**: Create beautiful custom landing pages to greet and direct your users. 
- **[OAuth2 Token Generation in Hubs Try it Out](https://docs.stoplight.io/documentation/oauth-hubs)**: If your API is protected by OAuth2, you can now generate tokens to enable Try it Out. 
- **[OAuth2 Token Generation in Hubs Try it Out](https://docs.stoplight.io/documentation/oauth-hubs)**: If your API is protected by OAuth2, you can now generate tokens in the Try it Out block.
## Enhancements 💪
- **IE 11 Support for Published Hubs**: IE 11 now renders documentation created in Hubs. 
- **Relative $refs**: References from one file to another in the same project are now represented with relative URLs. For example, `./models/user.json` instead of `https://exporter.stoplight.io/45/master/models/user.json`. This has a number of benefits, such as increased portability. It also sets the stage for better desktop local file editing and versioning.
- **Published hubs now support Internet Explorer 11**
Please reach out via chat or support@stoplight.io if you have any questions about the above changes.