Merge pull request community#190506 from community/category-redesign

Community Category Redesign v1 (#392)

Author: samus-aran

.github/DISCUSSION_TEMPLATE/a-welcome-to-github.yml

@@ -0,0 +1,78 @@
+title: "👋 Hello from {Name/Handle}"
+labels: ["A Welcome to GitHub", "source:ui"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Welcome! This space is **just** for introductions! So say hi and share what you’re excited about here on GitHub.
+        - **Quick nudge:** if your post is really “how do I use GitHub?” or troubleshooting something, please use [**New to GitHub**](https://github.com/community/community/discussions/categories/new-to-github) (or the [most relevant help category](https://github.com/community/community/discussions)) so you can get the best answers.
+        - **Privacy & safety:** please don’t share sensitive personal info (addresses, phone numbers, private emails, etc.).
+        - **One intro per person:** make one intro post and feel free to add updates as replies anytime.
+
+        Keep it friendly and human: a couple links are fine, but no link-dumping, recruiting, or promo-only posts.
+        <img src='https://github.com/user-attachments/assets/baa3b489-1a7c-4f48-bf62-5dce7fb30c54' width='30' alt='Welcome gif' />
+  - type: textarea
+    id: introduce_yourself
+    attributes:
+      label: "Introduce yourself"
+      description: "A few sentences is great. Help us say hi back."
+      placeholder: "Hi everyone I am… I am here because… Ask me about…"
+    validations:
+      required: true
+  - type: textarea
+    id: links
+    attributes:
+      label: "Links (optional)"
+      description: "If you want, share a personal website, blog, or social handle."
+      placeholder: |
+        https://your-site.example
+        https://your-blog.example
+        @your-handle
+    validations:
+      required: false
+  - type: dropdown
+    id: journey
+    attributes:
+      label: "Where are you in your GitHub journey?"
+      description: "Pick the closest match. There is no wrong answer."
+      options:
+        - "Brand new to GitHub"
+        - "Learning the basics"
+        - "Building my first project"
+        - "Looking for the latest developer trends"
+        - "Contributing to open source"
+        - "Maintaining a project or repo owner"
+        - "Here to make connections"
+        - "Student / Leveling up"
+        - "Just exploring"
+        - "Other"
+    validations:
+      required: true
+  - type: textarea
+    id: next_step
+    attributes:
+      label: "And where are you going next on GitHub?"
+      description: "Your next step can be small. This helps others cheer you on or share ideas."
+      placeholder: "My next step is… I want to try… I am looking for…"
+    validations:
+      required: true
+  - type: textarea
+    id: learn_build
+    attributes:
+      label: "What technical skills or projects are you working on?"
+      description: "A sentence or two is perfect."
+      placeholder: "I am working on… I am learning… My current project is…"
+    validations:
+      required: true
+  - type: textarea
+    id: hubber_question
+    attributes:
+      label: "Got a question for us? (optional)"
+      description: "Curious about the platform, community, careers, or how GitHub works behind the scenes? Ask away. For troubleshooting, use [New to GitHub](https://github.com/community/community/discussions/categories/new-to-github)."
+      placeholder: "I have always wondered… What is the story behind… How does GitHub…"
+    validations:
+      required: false
+  - type: markdown
+    attributes:
+      value: |
+        <img src="https://github.com/user-attachments/assets/f427e6a5-c010-422b-9517-845b9608314e" alt="Purple Mona mascot alongside green 3D cube blocks on a light background" />

.github/DISCUSSION_TEMPLATE/accessibility.yml

@@ -1,4 +1,4 @@
-labels: [Accessibility]
+labels: [Accessibility, source:ui]
 body: 
 - type: markdown
   attributes: 
@@ -10,21 +10,19 @@ body:
     To ensure you receive a timely response and connect with the proper team(s), please post in the correct category, questions about access, 2FA, and SMS belong in the [General category](https://github.com/orgs/community/discussions/categories/general?discussions_q=is%3Aopen+category%3AGeneral). Discussions that are posted in the wrong category may be moved. Users who post spam or violate of our [Code of Conduct](https://github.com/github/.github/blob/95e9dcb0b8b70a25cdb75de29f600812a07eb996/CODE_OF_CONDUCT.md) will be blocked.
 - type: dropdown
   attributes:
-    label: Select Topic Area
+    label: "🏷️ Discussion Type"
     description: What would you like to discuss?
     options:
-      - "Question"
-      - "Product Feedback"
       - "Bug"
-      - "Show & Tell"
-      - "General"
+      - "Product Feedback"
+      - "Question"
   validations:
     required: true
 - type: dropdown 
   attributes: 
-      label: GitHub Feature Area
+      label: "💬 Feature/Topic Area"
       description: >
-        What GitHub product/feature area is your Accessibility post related to? 
+        What GitHub product/feature area is your Accessibility post related to? (If applicable)
       options:
         - Actions
         - APIs and Webhooks
@@ -46,6 +44,7 @@ body:
         - Lists
         - Markdown
         - Mobile
+        - Models
         - Notifications
         - Packages
         - Pages
@@ -61,7 +60,7 @@ body:
         - Wiki
         - Other
   validations:
-      required: true
+      required: false
 - type: textarea
   attributes:
     label: Body

.github/DISCUSSION_TEMPLATE/actions.yml

@@ -1,4 +1,4 @@
-labels: [Actions]
+labels: [Actions, source:ui]
 body:
 - type: markdown
   attributes:
@@ -22,19 +22,18 @@ body:
 - type: dropdown
   id: reason
   attributes:
-    label: Why are you starting this discussion?
-    description: Tell us your goal! Are you asking a question, giving feedback, reporting a bug, or sharing something cool?
+    label: "🏷️ Discussion Type"
+    description: Tell us your goal! Are you asking a question, giving feedback, or reporting a bug?
     options:
-      - "Question"
-      - "Product Feedback"
       - "Bug"
-    default: 0
+      - "Product Feedback"
+      - "Question"
   validations:
     required: true
 - type: dropdown
   id: topic
   attributes:
-    label: What GitHub Actions topic or product is this about?
+    label: "💬 Feature/Topic Area"
     description: |
       Choose the single topic or product area most relevant to your discussion - [here is a list of label descriptions to help you decide which option fits best.](https://github.com/community/community/issues/labels?q=Action)
       
@@ -47,12 +46,10 @@ body:
       - "Actions Runner"
       - "Actions Checkout"
       - "Actions Cache"
-      - "General"
       - "Metrics & Insights"
       - "Workflow Deployment"
       - "Workflow Configuration"
       - "Schedule & Cron Jobs"
-    default: 5
   validations:
     required: false
 - type: textarea

.github/DISCUSSION_TEMPLATE/api-and-webhooks.yml

@@ -0,0 +1,48 @@
+labels: ["Apps API and Webhooks","source:ui"]
+
+body:
+  - type: dropdown
+    attributes:
+      label: "🏷️ Discussion Type"
+      description: What would you like to discuss?
+      options:
+        - "Bug"
+        - "Product Feedback"
+        - "Question"
+    validations:
+      required: true
+      
+
+  - type: markdown
+    attributes:
+      value: |
+        Before opening a new discussion, we recommend reviewing our documentation:
+         - [API documentation](https://docs.github.com/en/rest?apiVersion=2022-11-28)
+         - [Webhooks documentation](https://docs.github.com/en/webhooks)
+         - [Apps documentation](https://docs.github.com/en/apps)
+
+
+  - type: dropdown
+    attributes:
+      label: "💬 Feature/Topic Area"
+      description: Which area best matches your post? (If applicable)
+      options:
+        - API
+        - Apps
+        - Webhooks
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Body
+      description: Start your discussion!
+      placeholder: >-
+        Provide a detailed description of your discussion (e.g., What issue are you facing? What feedback do you have? What question do you need answered?)
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        #### Don't forget to mark an [answer as "solved"](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#marking-a-comment-as-an-answer) to help others with similar questions. ✅

.github/DISCUSSION_TEMPLATE/apps-api-and-webhooks.yml

@@ -1,15 +1,13 @@
-labels: [Code Security]
+labels: [Code Security, source:ui]
 body:
 - type: dropdown
   attributes:
-    label: Select Topic Area
+    label: "🏷️ Discussion Type"
     description: What would you like to discuss?
     options:
-      - "Question"
-      - "Product Feedback"
       - "Bug"
-      - "Show & Tell"
-      - "General"
+      - "Product Feedback"
+      - "Question"
   validations:
     required: true
 - type: textarea

.github/DISCUSSION_TEMPLATE/code-search-and-navigation.yml

@@ -1,16 +1,14 @@
-labels: [Codespaces]
+labels: [Codespaces, source:ui]
 body:
 - type: dropdown
   id: topic
   attributes:
-    label: Select Topic Area
+    label: "🏷️ Discussion Type"
     description: What would you like to discuss?
     options:
-      - "Question"
-      - "Product Feedback"
       - "Bug"
-      - "Show & Tell"
-      - "General"
+      - "Product Feedback"
+      - "Question"
   validations:
     required: true
 - type: textarea

.github/DISCUSSION_TEMPLATE/code-security.yml

@@ -1,3 +1,4 @@
+labels: [source:ui]
 body:
 - type: markdown
   attributes:
@@ -8,33 +9,31 @@ body:
       - 🔍 Are you a student/teacher looking to enable Copilot Pro? [Read our guide](https://gh.io/faq-nd-copilot)
 - type: dropdown
   attributes:
-    label: Select Topic Area
+    label: "🏷️ Discussion Type"
     description: What would you like to discuss about GitHub Copilot? Choose your topic area. 
     options:
-      - Question
+      - Bug
       - Product Feedback
-      - Bug 
-      - General
+      - Question
   validations:
     required: true
 - type: dropdown
   id: feature-area
   attributes:
-    label: Copilot Feature Area
-    description: Which Copilot feature or product area is your discussion related to?
+    label: "💬 Feature/Topic Area"
+    description: Which Copilot feature or product area is your discussion related to? (If applicable)
     options:
-      - General
       - Copilot in GitHub
       - Copilot Workspace
       - Copilot Agent Mode
       - Copilot Coding Agent
       - Copilot Enterprise
-      - Account Related 
+      - Account Related
       - VS Code
       - Visual Studio
       - JetBrains & Xcode
   validations:
-    required: true
+    required: false
 - type: textarea
   attributes:
     label: Body

.github/DISCUSSION_TEMPLATE/codespaces.yml

@@ -1,5 +1,5 @@
 title: "<Your question or feedback about the GitHub Discussions product>"
-labels: [Discussions]
+labels: [Discussions, source:ui]
 body:
   - type: markdown
     attributes: