refactor: organize services into categories

- move service implementations to categorized subdirectories under pkg/services/
- reorganize documentation structure to match categorized directories under docs/services/
- update service map imports to reference new categorized paths
- modify generator imports for router and xoauth2 components
- update mkdocs configuration to reflect new documentation structure
- revise service overview to group services by category
- update documentation generation script to handle categorized directories
- adjust slack guide links to accommodate reorganized structure

Author: nicholas-fedor

.gitignore

@@ -25,4 +25,4 @@ coverage.txt
 *.coverprofile
 dist
 site/
-docs/services/*/config.md
+docs/services/*/*/config.md

build/mkdocs/mkdocs.yaml

@@ -113,34 +113,35 @@ nav:
       - Go Package: usage/go-package/index.md
   - Services:
       - Overview: services/overview.md
-      - Messaging:
-          - Discord: services/discord/index.md
-          - Google Chat: services/googlechat/index.md
-          - Hangouts: services/hangouts/index.md
-          - Lark: services/lark/index.md
-          - Matrix: services/matrix/index.md
-          - Mattermost: services/mattermost/index.md
-          - Rocketchat: services/rocketchat/index.md
-          - Signal: services/signal/index.md
-          - Slack: services/slack/index.md
-          - Teams: services/teams/index.md
-          - Telegram: services/telegram/index.md
-          - WeCom: services/wecom/index.md
-          - Zulip Chat: services/zulip/index.md
-      - Webhooks:
-          - Generic Webhook: services/generic/index.md
-          - IFTTT: services/ifttt/index.md
-      - Push Notifications:
-          - Bark: services/bark/index.md
-          - Gotify: services/gotify/index.md
-          - Join: services/join/index.md
-          - Ntfy: services/ntfy/index.md
-          - Pushbullet: services/pushbullet/index.md
-          - Pushover: services/pushover/index.md
-      - Other:
-          - Email: services/email/index.md
-          - Logger: services/logger/index.md
-          - OpsGenie: services/opsgenie/index.md
+      - Chat and Messaging Platforms:
+          - Discord: services/chat/discord/index.md
+          - Google Chat: services/chat/googlechat/index.md
+          - Hangouts: services/chat/hangouts/index.md
+          - Lark: services/chat/lark/index.md
+          - Matrix: services/chat/matrix/index.md
+          - Mattermost: services/chat/mattermost/index.md
+          - Rocket.Chat: services/chat/rocketchat/index.md
+          - Signal: services/chat/signal/index.md
+          - Slack: services/chat/slack/index.md
+          - Teams: services/chat/teams/index.md
+          - Telegram: services/chat/telegram/index.md
+          - WeCom: services/chat/wecom/index.md
+          - Zulip: services/chat/zulip/index.md
+      - Push Notification Services:
+          - Bark: services/push/bark/index.md
+          - Gotify: services/push/gotify/index.md
+          - IFTTT: services/push/ifttt/index.md
+          - Join: services/push/join/index.md
+          - Ntfy: services/push/ntfy/index.md
+          - Pushbullet: services/push/pushbullet/index.md
+          - Pushover: services/push/pushover/index.md
+      - Incident and Alert Management:
+          - OpsGenie: services/incident/opsgenie/index.md
+      - Email Services:
+          - SMTP: services/email/smtp/index.md
+      - Specialized Services:
+          - Generic: services/specialized/generic/index.md
+          - Logger: services/specialized/logger/index.md
   - Guides:
       - Configuring Slack: guides/slack/index.md
       - Proxy Setup: guides/proxy/index.md
@@ -159,6 +160,7 @@ plugins:
   # Displays last updated dates on pages, formatted as time ago.
   - git-revision-date-localized:
       enable_creation_date: true
+      enable_git_follow: false
       type: timeago
 
 # Build Directories: https://www.mkdocs.org/user-guide/configuration/#build-directories

docs/guides/slack/index.md

@@ -2,7 +2,7 @@
 
 ## Overview
 
-Guides for setting up the [Slack](../../services/slack/index.md) service, including obtaining tokens (Bot API or Webhook) and channel IDs. The Slack service supports customization options like bot name, icon, color, title, and threading.
+Guides for setting up the [Slack](../../services/chat/slack/index.md) service, including obtaining tokens (Bot API or Webhook) and channel IDs. The Slack service supports customization options like bot name, icon, color, title, and threading.
 
 ## Getting a Token
 
@@ -18,7 +18,7 @@ To send messages, use either a Bot API token (preferred for full features) or a
    <figure><img alt="Copy OAuth token screenshot" src="app-api-copy-oauth-token.png" height="209" /></figure>
 <!-- markdownlint-restore -->
 !!! example
-    Given the API token `xoxb-123456789012-1234567890123-4mt0t4l1YL3g1T5L4cK70k3N` and channel ID `C001CH4NN3L` (obtained via the [guide below](#getting-the-channel-id)), the Shoutrrr URL should look like:
+    Given the API token `xoxb-123456789012-1234567890123-4mt0t4l1YL3g1T5L4cK70k3N` and channel ID `C001CH4NN3L` (obtained via the [Slack service docs](../../services/chat/slack/index.md#getting_the_channel_id)), the Shoutrrr URL should look like:
     ```url
     slack://xoxb:123456789012-1234567890123-4mt0t4l1YL3g1T5L4cK70k3N@C001CH4NN3L
     ```

docs/services/bark/index.md

@@ -21,7 +21,7 @@ To send messages to a specific thread in a Discord channel, include the `thread_
 
 You can obtain the `thread_id` by right-clicking a thread in Discord and selecting "Copy ID" (requires Developer Mode to be enabled in Discord settings).
 
---8<-- "docs/services/discord/config.md"
+--8<-- "docs/services/chat/discord/config.md"
 
 ## Creating a webhook in Discord