Update collaborative platform documentation to include detailed instructions for marking comments as answers, converting discussions to issues, and pinning discussions. Enhanced clarity and usability with step-by-step guidance and visual references.

Author: Randy Pagels

learn-pr/github/introduction-to-github/5-platform-management.yml

@@ -3,11 +3,11 @@ uid: learn.github.introduction-to-github.platform-management
 title: GitHub platform management
 metadata:
   title: GitHub platform management
-  description: In this unit, we're learning about how to manage your GitHub notifications, subscriptions, and how to publicize your project on GitHub pages.
+  description: Learn how to manage your GitHub notifications, subscriptions, and repositories to stay informed and organize your work efficiently.
   ms.date: 09/12/2024
   author: a-a-ron
   ms.author: aastewar
   ms.topic: unit
-durationInMinutes: 4
+durationInMinutes: 10
 content: |
   [!include[](includes/5-platform-management.md)]

learn-pr/github/introduction-to-github/includes/4-collaborative-platform.md

@@ -102,3 +102,34 @@ Each category must have a unique name, emoji pairing, and a detailed description
 1. Select **Start discussion**.
 
 That covers a little about how GitHub inspires collaboration. Now let's move to how you can manage notifications, subscribe to threads, and get started with GitHub pages.
+
+### Marking a comment as an answer
+
+In a Q&A style discussion, you can mark a comment as the accepted answer to the original question.
+
+1. Navigate to the discussion.
+2. Locate the comment that best answers the original question.
+3. Select **Mark as answer** below the comment.
+
+The comment will be highlighted, making it easy for others to find the solution quickly. You can also unmark an answer if needed.
+
+### Converting a discussion to an issue
+
+If a discussion leads to work that needs to be tracked, you can convert the discussion into an issue.
+
+1. Navigate to the discussion you want to convert.
+2. Select the **`...`** (three dots) menu at the top-right of the discussion.
+3. Select **Convert to issue**.
+4. Confirm the conversion and select a repository to create the new issue in.
+
+This keeps track of actionable work that originates from community conversations.
+
+### Pinning a discussion
+
+You can pin important discussions to the top of the Discussions page for better visibility.
+
+1. Navigate to the discussion you want to pin.
+2. Select the **`...`** (three dots) menu at the top-right of the discussion.
+3. Select **Pin discussion**.
+
+Pinned discussions are helpful for highlighting announcements, important questions, or ongoing topics the community should notice.

learn-pr/github/introduction-to-github/includes/5-platform-management.md

@@ -8,22 +8,54 @@ In this unit, we'll cover:
 
 ## Managing notifications and subscriptions
 
-You can choose to receive ongoing updates about specific activity on GitHub.com through a subscription. Notifications are the updates that you receive for specific activity to which you're subscribed.
+Notifications help you stay up to date on important activity across your repositories and teams. Managing your subscriptions ensures you only get updates for the work that matters most to you.
 
-### Subscription options
+You can subscribe to notifications for:
 
-You can choose to subscribe to notifications for:
+- Specific issues, pull requests, or gists
+- Repository activity like issues, pull requests, releases, or discussions
+- Workflow statuses for repositories using GitHub Actions
+- All activity across a repository
 
-- A conversation in a specific issue, pull request, or gist.
-- CI activity, such as the status of workflows in repositories set up with GitHub Actions.
-- Repository issues, pull requests, releases, security alerts, or discussions (if enabled).
-- All activity in a repository.
+You're automatically subscribed when you interact with conversations (commenting, opening an issue, being assigned), but you can also manually manage subscriptions as needed.
 
-In some instances, you're automatically subscribed to conversations on GitHub. Examples include opening a pull request or issue, commenting on a thread, or being assigned to an issue or pull request.
+If you're no longer interested in receiving updates, you can unsubscribe, unwatch, or customize the types of notifications you receive.
 
-If you're no longer interested in a conversation, you can unsubscribe, unwatch, or customize the types of notifications you'll receive in the future.
+## Subscribing to threads and finding threads where you're mentioned
 
-If you're ever interested in issues that mention a certain user, you can use *mentions:* as the qualifier to find those specific issues.
+Subscribing to individual threads, such as a particular issue or pull request, ensures you receive updates even if you weren't originally involved.
+
+You can subscribe to a thread by:
+
+- Selecting **Subscribe** on the right-hand sidebar of an issue, pull request, or discussion.
+
+To find conversations where you're mentioned:
+
+- Use the search qualifier `mentions:<username>` in the GitHub search bar to locate issues and pull requests where you were @mentioned.
+
+This makes it easy to keep track of discussions that require your input.
+
+### Filtering notifications
+
+GitHub allows you to filter notifications using watch settings:
+
+- **Watching**: Receive notifications for all activity.
+- **Not watching**: Receive notifications only when you're participating or @mentioned.
+- **Ignore**: No notifications at all for a repository.
+- **Custom**: Fine-tune what types of activity (like pull requests, issues, or discussions) trigger notifications.
+
+You can manage watch settings by selecting **Watch** at the top of a repository page.
+
+### Configuring notification settings
+
+You can configure where you receive notifications:
+
+- **Email**: Notifications delivered to your registered email address.
+- **Web**: Notifications viewed directly in your GitHub dashboard.
+- **Mobile**: Push notifications using the GitHub mobile app.
+- **Custom notifications**: Configure specific event types for different channels.
+
+Notification settings are managed under your GitHub account settings in **Notifications**.
 
 ## What are GitHub Pages?