Adjust welcome discussion workflows

Author: Timna Brown

.github/workflows/discussions-welcome.yml

@@ -1,8 +1,6 @@
 name: Ensure Welcome Discussion
 
 on:
-  schedule:
-    - cron: '30 6 * * 1'
   workflow_dispatch:
 
 permissions:
@@ -31,5 +29,5 @@ jobs:
           ARCHIVE_CONFIG: docs/discussions/archive.json
           WELCOME_TEMPLATE: docs/welcome-draft.md
           WELCOME_TITLE: Welcome to the organization Discussions
-          WELCOME_CATEGORY: General
+          WELCOME_CATEGORY: Announcements
         run: python .github/workflows/ensure_welcome_discussion.py

.github/workflows/ensure-welcome-discussion.yml

@@ -33,6 +33,9 @@
         id
         title
         url
+                category {
+                    name
+                }
       }
       pageInfo {
         hasNextPage
@@ -139,10 +142,15 @@ def find_category_id(categories, name):
     return None
 
 
-def find_discussion_by_title(discussions, title):
+def find_discussion_by_title(discussions, title, category_name=None):
     title_normalized = normalize_title(title)
+    category_normalized = normalize_title(category_name) if category_name else None
     for item in discussions:
         if normalize_title(item.get("title")) == title_normalized:
+            if category_normalized:
+                item_category = item.get("category") or {}
+                if normalize_title(item_category.get("name")) != category_normalized:
+                    continue
             return item
     return None
 
@@ -175,7 +183,7 @@ def main():
         raise RuntimeError(f"Category not found: {WELCOME_CATEGORY}")
 
     discussions = fetch_discussions(org, TOKEN)
-    existing = find_discussion_by_title(discussions, WELCOME_TITLE)
+    existing = find_discussion_by_title(discussions, WELCOME_TITLE, WELCOME_CATEGORY)
 
     if existing:
         discussion_id = existing.get("id")

.github/workflows/ensure_welcome_discussion.py

@@ -11,6 +11,16 @@ Last updated: 2026-03-04
 
 > This repository is the **home of GitHub Discussions** for the organization.
 
+<details>
+<summary>Table of contents</summary>
+
+- [Start here](#start-here)
+- [Categories](#categories)
+- [Automation](#automation)
+- [How we keep discussions useful](#how-we-keep-discussions-useful)
+
+</details>
+
 > E.g: 
 
 <img width="1896" height="782" alt="image" src="https://github.com/user-attachments/assets/313bb41a-d11f-4f19-b5a4-7255a67e40c8" />
@@ -21,6 +31,7 @@ Use it to:
 - Propose ideas and gather feedback
 - Host lightweight RFCs / design discussions
 
+
 ## Start here
 
 - **Want to ask a question?** Create a Discussion in [Q&A](https://github.com/orgs/MicrosoftCloudEssentials-LearningHub/discussions/categories/q-a) and include:
@@ -43,6 +54,16 @@ Quick pointers:
 - [Show and tell](https://github.com/orgs/MicrosoftCloudEssentials-LearningHub/discussions/categories/show-and-tell): what you built (demos/integrations)
 - [Events](https://github.com/orgs/MicrosoftCloudEssentials-LearningHub/discussions/categories/events): meetups/livestreams/webinars
 
+## Automation
+
+| Workflow | Trigger | Purpose | Secrets |
+|---|---|---|---|
+| [Archive Discussions](.github/workflows/archive-discussions.yml) | Monthly (1st 06:20 UTC), manual | Sync org discussions into docs/discussions | `TRAFFIC_TOKEN` |
+| [Create Monthly Catalog Discussion](.github/workflows/create-monthly-catalog-discussion.yml) | Monthly (1st 06:05 UTC), manual | Create the monthly catalog discussion, then archive it | `TRAFFIC_TOKEN` |
+| [Ensure Welcome Discussion](.github/workflows/ensure-welcome-discussion.yml) | Manual (run once) | Create and pin the welcome discussion | `TRAFFIC_TOKEN` |
+| [Update Last Modified Date](.github/workflows/update-md-date.yml) | Pull request to main | Stamp changed markdown files with Last updated | `GITHUB_TOKEN` |
+| [Use Visitor Counter Logic](.github/workflows/use-visitor-counter.yml) | Pull request to main, manual | Refresh view counter badges and metrics | `TRAFFIC_TOKEN` |
+
 ## How we keep discussions useful
 
 - **Search first** (duplicate threads slow everyone down)