add tags to SWML docs (#182)

Author: Devon-White

config/presets.ts

@@ -34,6 +34,8 @@ const presets: PresetConfig[] = [
           [require("../plugins/remark-plugin-a11y-checker"), { stopOnError: false }],
           [require("../plugins/remark-plugin-image-to-figure"), {}],
         ],
+        tags: 'tags.yml',
+        onInlineTags: 'throw'
       },
       blog: {
         blogSidebarCount: "ALL",

docs/home/calling/fax/getting-started/common-fax-errors.mdx

@@ -2,10 +2,10 @@
 slug: /fax/getting-started/common-fax-errors
 title: Common Fax Errors
 description: Our guide to understanding and troubleshooting the most common fax error messages.
-tags: 
-  - product:fax
 x-custom:
   ported_from_readme: true
+  tags:
+    - product:fax
 ---
 
 # Common Fax Errors

docs/sdks/reference/browser-sdk/video/video-roomsession.mdx

@@ -1,9 +1,6 @@
 ---
 title: "RoomSession"
 sidebar_position: 0
-tags:
-  - Browser SDK
-  - Video
 ---
 
 import MethodOff from "../../_common/_method_off.mdx";

docs/swml/get-started/index.mdx

@@ -4,6 +4,8 @@ description: Get started with SWML (SignalWire Markup Language), a markup and sc
 sidebar_position: 0
 sidebar_label: Introduction
 slug: /swml
+tags: ['swml']
+keywords: ['swml', 'signalwire markup language']
 ---
 
 import UiAccordion from '/docs/_common/dashboard/_ui-accordion.mdx'

docs/swml/guides/AI/ai_agent_with_background_audio.mdx

@@ -1,6 +1,8 @@
 ---
 slug: /swml/guides/ai/background_audio
 sidebar_label: AI Agent with Background Audio
+tags: ['swml']
+description: Learn how to create an AI agent with background audio.
 ---
 
 

docs/swml/guides/AI/back_to_back_functions.mdx

@@ -1,6 +1,8 @@
 ---
 slug: /swml/guides/ai/back_to_back_functions
 draft: true
+tags: ['swml']
+description: Learn how to use the `back_to_back_functions` property in SWAIG functions.
 x-custom:
   tags:
     - favorite

docs/swml/guides/AI/context_switch.mdx

@@ -1,5 +1,7 @@
 ---
 slug: /swml/guides/ai/context_switch
+tags: ['swml']
+description: Learn how to use `context_switch` to shift the focus of the conversation.
 x-custom:
   tags:
     - favorite

docs/swml/guides/AI/executing_swml.mdx

@@ -1,6 +1,8 @@
 ---
 sidebar_label: Executing SWML from a SWAIG function
 slug: /swml/guides/ai/executing_swml
+tags: ['swml']
+description: Learn how to execute SWML from a SWAIG function.
 x-custom:
   tags:
     - favorite

docs/swml/guides/AI/holiday-special-santa-ai/index.mdx

@@ -1,6 +1,7 @@
 ---
 slug: /swml/guides/ai/holiday_special_santa_ai
 title: Holiday Special - Creating a Santa AI with SWML
+tags: ['swml']
 x-custom:
   tags:
     - sdk:swml

docs/swml/guides/AI/index.mdx

@@ -1,6 +1,8 @@
 ---
 title: SWML AI guides
 slug: /swml/guides/ai
+tags: ['swml']
+description: Guides for using AI with SWML.
 sidebar_custom_props:
   hideFromIndex: true
 ---

docs/swml/guides/AI/set_meta_data.mdx

@@ -1,6 +1,8 @@
 ---
 slug: /swml/guides/ai/set_meta_data
 title: Use `set_meta_data`
+description: Learn how to use `set_meta_data` to store metadata to reference later.
+tags: ['swml']
 x-custom:
   tags:
     - favorite

docs/swml/guides/AI/swaig/functions/data_map/index.mdx

@@ -3,6 +3,7 @@ slug: /swml/guides/ai/swaig/functions/data_map
 title: Understanding `data_map` in SWML SWAIG Functions
 sidebar_label: Data Map
 description: Learn how to use `data_map` in SWML SWAIG functions to process, transform, and utilize incoming data effectively.
+tags: ['swml']
 x-custom:
   tags:
     - sdk:swml

docs/swml/guides/AI/swaig/functions/index.mdx

@@ -1,8 +1,12 @@
 ---
 title: SWAIG.Function Guides
 slug: /swml/guides/ai/swaig/functions
+description: Guides for using SWAIG.functions with SignalWire.
+tags: ['swml']
 ---
 
-This section contains guides for using SWAIG.Function with SignalWire.
+[swaig-function]: /swml/methods/ai/swaig/functions
+
+This section contains guides for using [SWAIG.Function][swaig-function] with SignalWire.
 
 <DocCardList />

docs/swml/guides/AI/swaig/index.mdx

@@ -1,8 +1,12 @@
 ---
 title: AI.SWAIG Guides
+description: Guides for using ai.SWAIG with SignalWire.
 slug: /swml/guides/ai/swaig
+tags: ['swml']
 ---
 
-This section contains guides for using SWAIG.AI with SignalWire.
+[ai-swaig]: /swml/methods/ai/swaig
+
+This section contains guides for using [ai.SWAIG][ai-swaig] with SignalWire.
 
 <DocCardList />

docs/swml/guides/AI/toggle_functions.mdx

@@ -1,5 +1,7 @@
 ---
 slug: /swml/guides/ai/toggle_functions
+tags: ['swml']
+description: Learn how to use `toggle_functions` to toggle functions on and off.
 x-custom:
   tags:
     - sdk:swml

docs/swml/guides/AI/voicemail_bot_example.mdx

@@ -1,15 +1,16 @@
 ---
 slug: /swml/guides/ai/voicemail_bot_example
+title: Creating a Voicemail Bot
+description: Learn how to create a voicemail bot using SWML.
 sidebar_label: Creating a Voicemail Bot
+tags: ['swml']
 x-custom:
   tags:
     - sdk:swml
     - product:ai
     - product:voice
 ---
 
-# Creating a Voicemail Bot
-
 ```yaml andJson
 version: 1.0.0
 sections:

docs/swml/guides/call-whisper/index.mdx

@@ -2,6 +2,7 @@
 title: Call whisper
 slug: /swml/guides/call-whisper
 description: A guide that shows you how to perform a Call Whisper using SWML.
+tags: ['swml']
 x-custom:
   tags:
   - favorite

docs/swml/guides/creating-ivr-with-swml/index.mdx

@@ -1,6 +1,8 @@
 ---
 slug: /swml/guides/creating_ivr
 title: Create an IVR with SWML
+description: Learn how to create an IVR with SWML.
+tags: ['swml']
 x-custom:
   tags:
     - favorite

docs/swml/guides/index.mdx

@@ -1,7 +1,9 @@
 ---
 title: Overview
+description: Guides for using SWML.
 slug: /swml/guides
 sidebar_position: 0
+tags: ['swml']
 sidebar_custom_props:
   hideFromIndex: true
 ---

docs/swml/guides/methods/goto-execute-transfer-disambiguation/index.mdx

@@ -2,10 +2,9 @@
 title: How are the methods goto, execute and transfer different?
 slug: /swml/guides/methods/goto_execute_transfer_disambiguation
 description: Learn how to use the goto, execute, and transfer methods in SWML.
+tags: ['swml']
 ---
 
-# How are the methods goto, execute and transfer different?
-
 SWML offers a lot of flexibility in how you control program flow with it's control methods.
 Of these, [`goto`], [`execute`], and [`transfer`] allow you to unconditionally control program flow.
 

docs/swml/guides/methods/index.mdx

@@ -1,6 +1,8 @@
 ---
 title: Methods
 slug: /swml/guides/methods
+tags: ['swml']
+description: Guides for using methods with SWML.
 ---
 
 This section contains guides for using methods with SWML.

docs/swml/guides/methods/request/index.mdx

@@ -1,10 +1,11 @@
 ---
 slug: /swml/guides/methods/request
+title: Request
+description: Learn how to use the request method in SWML to send HTTP requests to a web server.
+tags: ['swml']
 ---
 
 
-# Request
-
 Let us take a deep dive into the [`request`] method. Using this method, you can send HTTP requests to
 a web server open to internet. It is a simple but powerful way to add all kinds of external functionality to
 SWML scripts.

docs/swml/guides/swml_remote_server.mdx

@@ -1,12 +1,13 @@
 ---
 slug: /swml/guides/remote_server
 title: Handle incoming calls from code
+tags: ['swml']
 x-custom:
   tags:
     - sdk:swml
     - language:nodejs
     - product:voice
-description: Use Node.js and Express.js to dynamically create SWML scripts to handle calls based on incoming call information. 
+description: Learn how to handle incomming calls from a remote server using SWML.
 sidebar_custom_props:
   platform: javascript
 

docs/swml/methods/ai/ai_languages.mdx

@@ -5,6 +5,8 @@ hide_title: false
 sidebar_position: 1
 slug: /swml/methods/ai/languages
 title: ai.languages
+description: Configure the spoken language of your AI Agent, as well as the TTS engine, voice, and fillers.
+tags: ['swml']
 ---
 
 # ai.languages

docs/swml/methods/ai/ai_params/conscience.mdx

@@ -5,12 +5,14 @@ hide_title: false
 sidebar_position: 1
 slug: /swml/methods/ai/params/conscience
 title: params.conscience
+description: A prompt for AI that reinforces the AI agent's behavior and guardrails throughout the conversation.
+tags: ['swml']
 ---
 
 
 A prompt for AI that can be passed in `ai.conscience` at the top level of the [`ai` Method](./index.mdx).
 
-Used to reinforce the AI agent's behavior after SWAIG calls.
+Used to reinforce the AI agent's behavior and guardrails throughout the conversation.
 
 | Name                                                       | Type     | Default                                                                                              | Description                                                                           |
 |:-----------------------------------------------------------|:---------|:-----------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------|

docs/swml/methods/ai/ai_params/hold_music.mdx

@@ -5,6 +5,8 @@ hide_title: false
 sidebar_position: 1
 slug: /swml/methods/ai/params/hold_music
 title: params.hold_music
+description: A URL for the hold music to play, accepting WAV, Mp3, and FreeSWITCH tone_stream.
+tags: ['swml']
 ---
 
 

docs/swml/methods/ai/ai_params/index.mdx

@@ -5,6 +5,8 @@ hide_title: false
 sidebar_position: 0
 title: ai.params
 slug: /swml/methods/ai/params
+description: Parameters for AI that can customize the AI agent's behavior.
+tags: ['swml']
 ---
 
 [functions-fillers]: /swml/methods/ai/swaig/functions/fillers

docs/swml/methods/ai/ai_params/interrupt_prompt.mdx

@@ -5,10 +5,12 @@ hide_title: false
 sidebar_position: 1
 slug: /swml/methods/ai/params/interrupt_prompt
 title: params.interrupt_prompt
+description: A prompt for AI that can be passed for when the AI agent is interrupted by the user.
+tags: ['swml']
 ---
 
 
-A prompt for AI that can be passed in `ai.interrupt_prompt` at the top level of the [`ai` Method](./index.mdx).
+A prompt for AI that can be passed for when the AI agent is interrupted by the user.
 
 | Name                                                             | Type     | Default                                                                                                                                                                                                                                   | Description                                                          |
 |:-----------------------------------------------------------------|:---------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------|

docs/swml/methods/ai/ai_post_prompt.mdx

@@ -4,6 +4,8 @@ hide_title: false
 sidebar_position: 1
 slug: /swml/methods/ai/post_prompt
 title: ai.post_prompt
+description: The final set of instructions and configuration settings to send to the agent.
+tags: ['swml']
 ---
 
 The final set of instructions and configuration settings to send to the agent.

docs/swml/methods/ai/ai_post_prompt_url.mdx

@@ -5,6 +5,8 @@ hide_title: false
 sidebar_position: 1
 slug: /swml/methods/ai/post_prompt_url
 title: ai.post_prompt_url
+description: The URL that the user defines to which to send status callbacks and reports.
+tags: ['swml']
 ---
 
 

docs/swml/methods/ai/ai_pronounce.mdx

@@ -4,6 +4,8 @@ hide_title: false
 sidebar_position: 1
 slug: /swml/methods/ai/pronounce
 title: ai.pronounce
+description: Use this object to clarify AI's pronunciation of certain words or expressions.
+tags: ['swml']
 ---
 
 

docs/swml/methods/ai/ai_swaig/defaults/defaults.web_hook_url.mdx

@@ -3,6 +3,7 @@ slug: /swml/methods/ai/swaig/defaults/web_hook_url
 title: defaults.web_hook_url
 sidebar_label: defaults.web_hook_url
 description: The default URL that the user defines to which to send status callbacks and reports.
+tags: ['swml']
 ---
 import WebHookUrl from '../../../_sharedtables/web_hook_url_.mdx';
 

docs/swml/methods/ai/ai_swaig/defaults/index.mdx

@@ -2,6 +2,7 @@
 slug: /swml/methods/ai/swaig/defaults
 title: SWAIG.defaults
 description: The default settings for all SWAIG functions.
+tags: ['swml']
 ---
 
 

docs/swml/methods/ai/ai_swaig/functions/ai_swaig.data_map/data_map.expressions.mdx

@@ -3,6 +3,8 @@ sidebar_position: 1
 sidebar_label: data_map.expressions
 slug: /swml/methods/ai/swaig/functions/data_map/expressions
 title: data_map.expressions
+description: An array of objects that define plain string or regex patterns to match against the user's input.
+tags: ['swml']
 ---
 
 

docs/swml/methods/ai/ai_swaig/functions/ai_swaig.data_map/data_map.output.mdx

@@ -3,6 +3,8 @@ sidebar_position: 1
 sidebar_label: data_map.output
 slug: /swml/methods/ai/swaig/functions/data_map/output
 title: data_map.output
+description: The output object for the SWAIG function.
+tags: ['swml']
 ---
 
 

docs/swml/methods/ai/ai_swaig/functions/ai_swaig.data_map/data_map.webhooks/foreach.mdx

@@ -2,6 +2,8 @@
 sidebar_label: webhooks.foreach
 slug: /swml/methods/ai/swaig/functions/data_map/webhooks/foreach
 title: webhooks.foreach
+description: Iterates over an array of objects and processes an output based on each element in the array.
+tags: ['swml']
 ---
 
 Iterates over an array of objects and processes an output based on each element in the array.

docs/swml/methods/ai/ai_swaig/functions/ai_swaig.data_map/data_map.webhooks/index.mdx

@@ -3,6 +3,8 @@ sidebar_position: 1
 sidebar_label: data_map.webhooks
 slug: /swml/methods/ai/swaig/functions/data_map/webhooks
 title: data_map.webhooks
+description: An array of objects that define external API calls.
+tags: ['swml']
 ---
 
 

docs/swml/methods/ai/ai_swaig/functions/ai_swaig.data_map/index.mdx

@@ -1,6 +1,8 @@
 ---
 slug: /swml/methods/ai/swaig/functions/data_map
 title: functions.data_map
+description: Defines how a SWAIG function should process and respond to the user's input data.
+tags: ['swml']
 ---
 
 

docs/swml/methods/ai/ai_swaig/functions/fillers.mdx

@@ -3,6 +3,7 @@ slug: /swml/methods/ai/swaig/functions/fillers
 title: functions.fillers
 sidebar_label: functions.fillers
 description: The fillers object for the SWAIG function.
+tags: ['swml']
 ---
 
 import SupportedLanguageCodes from '../../../_sharedtables/supported_langauge_codes.mdx';