chore: Align docs with SSoT

docs/admin/install/index.md → docs/admin/install.md

@@ -58,10 +58,10 @@ The `nautobot-chatops` package supports multiple chat platforms.
 
 Set up your chosen chat platform:
 
-- [Mattermost](./mattermost_setup.md)
-- [Microsoft Teams](./microsoft_teams_setup.md)
-- [Slack](./slack_setup.md)
-- [Cisco Webex](./webex_setup.md)
+- [Mattermost](./platforms/mattermost.md)
+- [Microsoft Teams](./platforms/microsoft_teams.md)
+- [Slack](./platforms/slack.md)
+- [Cisco Webex](./platforms/webex.md)
 
 ## Installation Guide
 
@@ -145,10 +145,10 @@ The `nautobot-chatops` package includes multiple integrations. Each requires ext
 
 Set up integrations using the specific guides:
 
-- [Cisco ACI](./aci_setup.md)
-- [AWX / Ansible Tower](./ansible_setup.md)
-- [Arista CloudVision](./aristacv_setup.md)
-- [Grafana](./grafana_setup.md)
-- [IPFabric](./ipfabric_setup.md)
-- [Cisco Meraki](./meraki_setup.md)
-- [Palo Alto Panorama](./panorama_setup.md)
+- [Cisco ACI](./integrations/aci.md)
+- [AWX / Ansible Tower](./integrations/ansible.md)
+- [Arista CloudVision](./integrations/aristacv.md)
+- [Grafana](./integrations/grafana.md)
+- [IPFabric](./integrations/ipfabric.md)
+- [Cisco Meraki](./integrations/meraki.md)
+- [Palo Alto Panorama](./integrations/panorama.md)

docs/admin/install/aci_setup.md → docs/admin/integrations/aci.md

@@ -6,15 +6,15 @@ This guide will walk you through steps to set up Cisco ACI integration with the
 
 Before configuring the integration, please ensure the following:
 
-- `nautobot-chatops` App was [installed with integration extra dependencies](./index.md#installation-guide).
+- `nautobot-chatops` App was [installed with integration extra dependencies](./../install.md#installation-guide).
     ```shell
     pip install nautobot-chatops[aci]
     ```
-- `nautobot-chatops` App is set up with at least one [enabled chat platform](./index.md#chat-platforms-configuration) and [tested](./index.md#test-your-chatbot).
+- `nautobot-chatops` App is set up with at least one [enabled chat platform](./../install.md#chat-platforms-configuration) and [tested](./../install.md#test-your-chatbot).
 
 ## Command Setup
 
-Create a top-level command named `aci` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./index.md#chat-platforms-configuration).
+Create a top-level command named `aci` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./../install.md#chat-platforms-configuration).
 
 ## Configuration
 
@@ -66,7 +66,7 @@ When executing chat commands, you will be presented with a selection dialog cont
 ## Upgrading from `nautobot-plugin-chatops-aci` App
 
 !!! warning
-    When upgrading from `nautobot-plugin-chatops-aci` App, it's necessary to [avoid conflicts](index.md#potential-apps-conflicts).
+    When upgrading from `nautobot-plugin-chatops-aci` App, it's necessary to [avoid conflicts](../install.md#potential-apps-conflicts).
 
 - Uninstall the old App:
     ```shell

docs/admin/install/ansible_setup.md → docs/admin/integrations/ansible.md

@@ -6,15 +6,15 @@ This guide will walk you through steps to set up AWX / Ansible Tower integration
 
 Before configuring the integration, please ensure the following:
 
-- `nautobot-chatops` App was [installed with integration extra dependencies](./index.md#installation-guide).
+- `nautobot-chatops` App was [installed with integration extra dependencies](./../install.md#installation-guide).
     ```shell
     pip install nautobot-chatops[ansible]
     ```
-- `nautobot-chatops` App is set up with at least one [enabled chat platform](./index.md#chat-platforms-configuration) and [tested](./index.md#test-your-chatbot).
+- `nautobot-chatops` App is set up with at least one [enabled chat platform](./../install.md#chat-platforms-configuration) and [tested](./../install.md#test-your-chatbot).
 
 ## Command Setup
 
-Create a top-level command named `ansible` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./index.md#chat-platforms-configuration).
+Create a top-level command named `ansible` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./../install.md#chat-platforms-configuration).
 
 ## Configuration
 
@@ -52,7 +52,7 @@ PLUGINS_CONFIG = {
 ## Upgrading from `nautobot-plugin-chatops-ansible` App
 
 !!! warning
-    When upgrading from `nautobot-plugin-chatops-ansible` App, it's necessary to [avoid conflicts](index.md#potential-apps-conflicts).
+    When upgrading from `nautobot-plugin-chatops-ansible` App, it's necessary to [avoid conflicts](../install.md#potential-apps-conflicts).
 
 - Uninstall the old App:
     ```shell

docs/admin/install/aristacv_setup.md → docs/admin/integrations/aristacv.md

@@ -6,15 +6,15 @@ This guide will walk you through steps to set up Arista CloudVision integration
 
 Before configuring the integration, please ensure the following:
 
-- `nautobot-chatops` App was [installed with integration extra dependencies](./index.md#installation-guide).
+- `nautobot-chatops` App was [installed with integration extra dependencies](./../install.md#installation-guide).
     ```shell
     pip install nautobot-chatops[aristacv]
     ```
-- `nautobot-chatops` App is set up with at least one [enabled chat platform](./index.md#chat-platforms-configuration) and [tested](./index.md#test-your-chatbot).
+- `nautobot-chatops` App is set up with at least one [enabled chat platform](./../install.md#chat-platforms-configuration) and [tested](./../install.md#test-your-chatbot).
 
 ## Command Setup
 
-Create a top-level command named `aristacv` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./index.md#chat-platforms-configuration).
+Create a top-level command named `aristacv` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./../install.md#chat-platforms-configuration).
 
 ## Configuration
 
@@ -69,7 +69,7 @@ Once you have updated your environment file, restart both nautobot and nautobot-
 ## Upgrading from `nautobot-plugin-chatops-arista-cloudvision` App
 
 !!! warning
-    When upgrading from `nautobot-plugin-chatops-arista-cloudvision` App, it's necessary to [avoid conflicts](index.md#potential-apps-conflicts).
+    When upgrading from `nautobot-plugin-chatops-arista-cloudvision` App, it's necessary to [avoid conflicts](../install.md#potential-apps-conflicts).
 
 - Uninstall the old App:
     ```shell

docs/admin/install/grafana_setup.md → docs/admin/integrations/grafana.md

@@ -6,18 +6,18 @@ This guide will walk you through steps to set up Grafana integration with the `n
 
 Before configuring the integration, please ensure the following:
 
-- `nautobot-chatops` App was [installed with integration extra dependencies](./index.md#installation-guide).
+- `nautobot-chatops` App was [installed with integration extra dependencies](./../install.md#installation-guide).
     ```shell
     pip install nautobot-chatops[grafana]
     ```
-- `nautobot-chatops` App is set up with at least one [enabled chat platform](./index.md#chat-platforms-configuration) and [tested](./index.md#test-your-chatbot).
+- `nautobot-chatops` App is set up with at least one [enabled chat platform](./../install.md#chat-platforms-configuration) and [tested](./../install.md#test-your-chatbot).
 - [Grafana](https://grafana.com/docs/grafana/latest/installation/) application installed and configured with dashboards and panels.
 - [Grafana Image Rendering Service](https://grafana.com/docs/grafana/latest/administration/image_rendering/) installed.
 - [Grafana Image Rending Plugin for Grafana](https://grafana.com/grafana/plugins/grafana-image-renderer/) installed in your Grafana application.
 
 ## Command Setup
 
-Create a top-level command named `grafana` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./index.md#chat-platforms-configuration).
+Create a top-level command named `grafana` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./../install.md#chat-platforms-configuration).
 
 ## Configuration
 
@@ -62,7 +62,7 @@ PLUGINS_CONFIG = {
 ## Upgrading from `nautobot-plugin-chatops-grafana` App
 
 !!! warning
-    When upgrading from `nautobot-plugin-chatops-grafana` App, it's necessary to [avoid conflicts](index.md#potential-apps-conflicts).
+    When upgrading from `nautobot-plugin-chatops-grafana` App, it's necessary to [avoid conflicts](../install.md#potential-apps-conflicts).
 
 - Uninstall the old App:
     ```shell

docs/admin/install/ipfabric_setup.md → docs/admin/integrations/ipfabric.md

@@ -6,11 +6,11 @@ This guide will walk you through steps to set up IPFabric integration with the `
 
 Before configuring the integration, please ensure the following:
 
-- `nautobot-chatops` App was [installed with integration extra dependencies](./index.md#installation-guide).
+- `nautobot-chatops` App was [installed with integration extra dependencies](./../install.md#installation-guide).
     ```shell
     pip install nautobot-chatops[ipfabric]
     ```
-- `nautobot-chatops` App is set up with at least one [enabled chat platform](./index.md#chat-platforms-configuration) and [tested](./index.md#test-your-chatbot).
+- `nautobot-chatops` App is set up with at least one [enabled chat platform](./../install.md#chat-platforms-configuration) and [tested](./../install.md#test-your-chatbot).
 
 ## Version Matrix
 
@@ -25,7 +25,7 @@ Here is a compatibility matrix and the minimum versions required to run this plu
 
 ## Command Setup
 
-Create a top-level command named `ipfabric` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./index.md#chat-platforms-configuration).
+Create a top-level command named `ipfabric` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./../install.md#chat-platforms-configuration).
 
 ## Configuration
 
@@ -59,7 +59,7 @@ PLUGINS_CONFIG = {
 ## Upgrading from `nautobot-plugin-chatops-ipfabric` App
 
 !!! warning
-    When upgrading from `nautobot-plugin-chatops-ipfabric` App, it's necessary to [avoid conflicts](index.md#potential-apps-conflicts).
+    When upgrading from `nautobot-plugin-chatops-ipfabric` App, it's necessary to [avoid conflicts](../install.md#potential-apps-conflicts).
 
 - Uninstall the old App:
     ```shell

docs/admin/install/meraki_setup.md → docs/admin/integrations/meraki.md

@@ -6,15 +6,15 @@ This guide will walk you through steps to set up Cisco Meraki integration with t
 
 Before configuring the integration, please ensure the following:
 
-- `nautobot-chatops` App was [installed with integration extra dependencies](./index.md#installation-guide).
+- `nautobot-chatops` App was [installed with integration extra dependencies](./../install.md#installation-guide).
     ```shell
     pip install nautobot-chatops[meraki]
     ```
-- `nautobot-chatops` App is set up with at least one [enabled chat platform](./index.md#chat-platforms-configuration) and [tested](./index.md#test-your-chatbot).
+- `nautobot-chatops` App is set up with at least one [enabled chat platform](./../install.md#chat-platforms-configuration) and [tested](./../install.md#test-your-chatbot).
 
 ## Command Setup
 
-Create a top-level command named `meraki` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./index.md#chat-platforms-configuration).
+Create a top-level command named `meraki` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./../install.md#chat-platforms-configuration).
 
 ## Configuration
 
@@ -46,7 +46,7 @@ The alternative option is to set the environmental variable:
 ## Upgrading from `nautobot-plugin-chatops-meraki` App
 
 !!! warning
-    When upgrading from `nautobot-plugin-chatops-meraki` App, it's necessary to [avoid conflicts](index.md#potential-apps-conflicts).
+    When upgrading from `nautobot-plugin-chatops-meraki` App, it's necessary to [avoid conflicts](../install.md#potential-apps-conflicts).
 
 - Uninstall the old App:
     ```shell

docs/admin/install/panorama_setup.md → docs/admin/integrations/panorama.md

@@ -6,15 +6,15 @@ This guide will walk you through steps to set up Palo Alto Panorama integration
 
 Before configuring the integration, please ensure the following:
 
-- `nautobot-chatops` App was [installed with integration extra dependencies](./index.md#installation-guide).
+- `nautobot-chatops` App was [installed with integration extra dependencies](./../install.md#installation-guide).
     ```shell
     pip install nautobot-chatops[panorama]
     ```
-- `nautobot-chatops` App is set up with at least one [enabled chat platform](./index.md#chat-platforms-configuration) and [tested](./index.md#test-your-chatbot).
+- `nautobot-chatops` App is set up with at least one [enabled chat platform](./../install.md#chat-platforms-configuration) and [tested](./../install.md#test-your-chatbot).
 
 ## Command Setup
 
-Create a top-level command named `panorama` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./index.md#chat-platforms-configuration).
+Create a top-level command named `panorama` in your enabled chat platform. For detailed instructions related to your specific chat platform, refer to the [platform specific set up](./../install.md#chat-platforms-configuration).
 
 ## Configuration
 
@@ -46,7 +46,7 @@ PLUGINS_CONFIG = {
 ## Upgrading from `nautobot-plugin-chatops-panorama` App
 
 !!! warning
-    When upgrading from `nautobot-plugin-chatops-panorama` App, it's necessary to [avoid conflicts](index.md#potential-apps-conflicts).
+    When upgrading from `nautobot-plugin-chatops-panorama` App, it's necessary to [avoid conflicts](../install.md#potential-apps-conflicts).
 
 - Uninstall the old App:
     ```shell

docs/admin/install/mattermost_setup.md → docs/admin/platforms/mattermost.md

@@ -25,7 +25,7 @@
    - Copy the displayed url matching the Server you want to add the chatbot to.
      - Make sure to include the `http://` or `https://`.
      - If shown, make sure to include the port. Ex. `https://example.com:8065`
-6. Proceed to the [Install Guide](index.md#Install-Guide) section.
+6. Proceed to the [Install Guide](../install.md#Install-Guide) section.
 
 **Note:** For every Slash Command created for Mattermost, a separate token will be generated.
 
@@ -39,4 +39,4 @@
 
 ## General Chat Setup Instructions
 
-See [admin_install](index.md) instructions here for general plugin setup instructions.
+See [admin_install](../install.md) instructions here for general plugin setup instructions.

docs/admin/install/microsoft_teams_setup.md → docs/admin/platforms/microsoft_teams.md

@@ -36,7 +36,7 @@
 1. In the Microsoft Teams client, select “Apps” from the sidebar to the left.
 2. Select “Built for your org.”
 3. Select the tile for the new Nautobot app. Click the blue “Add” button.
-4. Proceed to the [Install Guide](index.md#Install-Guide) section.
+4. Proceed to the [Install Guide](../install.md#Install-Guide) section.
 
 ## Nautobot Config
 
@@ -53,4 +53,4 @@ Reference the [Setting Up Nautobot ChatOps With MSTeams Fall 2022](https://blog.
 
 ## General Chat Setup Instructions
 
-See [admin_install](index.md) instructions here for general plugin setup instructions.
+See [admin_install](../install.md) instructions here for general plugin setup instructions.

docs/admin/install/slack_setup.md → docs/admin/platforms/slack.md

@@ -138,7 +138,7 @@ PLUGINS_CONFIG = {
 
 ![slack integration invite](../../images/add_nautobot.png)
 
-Once these steps are completed, you can proceed to the [Install Guide](index.md#Install-Guide) section.
+Once these steps are completed, you can proceed to the [Install Guide](../install.md#Install-Guide) section.
 
 ## Configuring Multiple Chatbots in a Workspace
 
@@ -186,7 +186,7 @@ PLUGINS_CONFIG = {
 
 ## General Chat Setup Instructions
 
-See [admin_install](index.md) instructions here for general plugin setup instructions.
+See [admin_install](../install.md) instructions here for general plugin setup instructions.
 
 ## Startup Slack Sockets (Socket Mode)
 

docs/admin/install/webex_setup.md → docs/admin/platforms/webex.md

@@ -28,7 +28,7 @@
      - secret: (enter a secret string that you don't mind having passed around as plaintext)
    - Change the `resource` to "attachmentActions" and run the API call again to create a second webhook.
 4. Configure the `webex_signing_secret` in your `.creds.env` to match the Webhook secret string that you selected above.
-5. Proceed to the [Installation Guide](index.md#Install-Guide) section.
+5. Proceed to the [Installation Guide](../install.md#Install-Guide) section.
 
 ## Deprecation Warning
 
@@ -60,4 +60,4 @@ Both settings will currently work, however support for `enable_webex_teams`, `we
 
 ## General Chat Setup Instructions
 
-See [admin_install](index.md) instructions here for general plugin setup instructions.
+See [admin_install](../install.md) instructions here for general plugin setup instructions.

docs/dev/release_checklist.md

@@ -49,7 +49,7 @@ Add the release notes (`docs/release-notes/X.Y.md`) to the table of contents wit
 
 ### Verify and Revise the Installation Documentation
 
-Follow the [installation instructions](../admin/install/index.md) to perform a new production installation of Nautobot ChatOps.
+Follow the [installation instructions](../admin/install.md) to perform a new production installation of Nautobot ChatOps.
 
 The goal of this step is to walk through the entire install process *as documented* to make sure nothing there needs to be changed or updated, to catch any errors or omissions in the documentation, and to ensure that it is current with each release.
 

docs/user/app_getting_started.md

@@ -4,7 +4,7 @@ A step-by-step tutorial on how to get the App going and how to use it.
 
 ## Install the App
 
-To install the App, please follow the instructions detailed in the [Administrator Guide](../admin/install/index.md).
+To install the App, please follow the instructions detailed in the [Administrator Guide](../admin/install.md).
 
 ## Link Nautobot Account
 
@@ -52,10 +52,10 @@ Interact with Nautobot by utilizing the following sub-commands:
 
 The `nautobot-chatops` package includes multiple integrations. Each integration adds chat commands described here:
 
-- [Cisco ACI](./aci_commands.md)
-- [AWX / Ansible Tower](./ansible_commands.md)
-- [Arista CloudVision](./aristacv_commands.md)
-- [Grafana](./grafana_commands.md)
-- [IPFabric](./ipfabric_commands.md)
-- [Cisco Meraki](./meraki_commands.md)
-- [Palo Alto Panorama](./panorama_commands.md)
+- [Cisco ACI](./integrations/aci.md)
+- [AWX / Ansible Tower](./integrations/ansible.md)
+- [Arista CloudVision](./integrations/aristacv.md)
+- [Grafana](./integrations/grafana.md)
+- [IPFabric](./integrations/ipfabric.md)
+- [Cisco Meraki](./integrations/meraki.md)
+- [Palo Alto Panorama](./integrations/panorama.md)

docs/user/aci_commands.md → docs/user/integrations/aci.md

@@ -25,16 +25,16 @@ Interact with Cisco ACI by utilizing the following sub-commands:
 
 ### Slack
 
-![image](../images/aci-slack-get-tenants.png)
+![image](../../images/aci-slack-get-tenants.png)
 
-![image](../images/aci-slack-get-epg-details.png)
+![image](../../images/aci-slack-get-epg-details.png)
 
-![image](../images/aci-slack-get-bds.png)
+![image](../../images/aci-slack-get-bds.png)
 
 ### Cisco Webex
 
-![image](../images/aci-slack-get-tenants.png)
+![image](../../images/aci-slack-get-tenants.png)
 
-![image](../images/aci-slack-get-epg-details.png)
+![image](../../images/aci-slack-get-epg-details.png)
 
-![image](../images/aci-slack-get-bds.png)
+![image](../../images/aci-slack-get-bds.png)

docs/user/aristacv_commands.md → docs/user/integrations/aristacv.md

@@ -20,8 +20,8 @@ Interact with Arista CloudVision by utilizing the following sub-commands:
 
 ## Screenshots
 
-![image](../images/aristacv-get-device-cve.png)
+![image](../../images/aristacv-get-device-cve.png)
 
-![image](../images/aristacv-get-configlet.png)
+![image](../../images/aristacv-get-configlet.png)
 
-![image](../images/aristacv-get-device-cve.png)
+![image](../../images/aristacv-get-device-cve.png)