From 39754e693a986f665251ad18c8f1bf61ed38206c Mon Sep 17 00:00:00 2001 From: Robert Wallach Date: Mon, 7 May 2018 15:43:39 -0500 Subject: [PATCH] Create modeling-grouping-tagging.md (#221) * Create grouping-tagging.md * Update grouping-tagging.md * Update grouping-tagging.md --- articles/modeling/grouping-tagging.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 articles/modeling/grouping-tagging.md diff --git a/articles/modeling/grouping-tagging.md b/articles/modeling/grouping-tagging.md new file mode 100644 index 0000000..a4442a8 --- /dev/null +++ b/articles/modeling/grouping-tagging.md @@ -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