[2023-03-31] Make images accessible in the images/help/discussions directory (#34871)

Co-authored-by: Laura Coursen <lecoursen@github.com>

content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md

@@ -16,7 +16,7 @@ With {% data variables.product.prodname_discussions %}, the community for your p
 - Upvote discussions and comments to give higher visibility to ideas you find valuable
 - Foster an inviting atmosphere for visitors and contributors to discuss goals, development, administration, and workflows
 
-![Discussions tab for a repository](/assets/images/help/discussions/hero.png)
+![Screenshot of the "Discussions" page for a {% data variables.product.company_short %} repository.](/assets/images/help/discussions/hero.png)
 
 You might use repository discussions to discuss topics that are specific to the repository. If your project spans multiple repositories, you might use organization discussions to discuss topics that aren't specific to a single repository in your organization.
 
@@ -32,7 +32,7 @@ For more information about management of discussions, see "[AUTOTITLE](/discussi
 
 You can create polls in the polls category to gauge interest in new ideas and project direction. Anyone with read access to your repository can create polls, vote in polls, and view their results.{% ifversion fpt or ghec %} Signed out users can view the results of polls in public repositories.{% endif %}
 
-Polls require a question and at least two options. You can add a maximum of eight options and the options can contain a maximum of 128 characters. 
+Polls require a question and at least two options. You can add a maximum of eight options and the options can contain a maximum of 128 characters.
 
 Voters cannot change their vote. Editing a poll will reset any votes that have already been cast.
 

content/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions.md

@@ -12,7 +12,7 @@ versions:
 
 {% data reusables.discussions.about-discussions %} If you use or contribute to a project, you can start a discussion to make suggestions and engage with maintainers and community members about your plans, questions, ideas, and feedback. For more information, see "[AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/about-discussions)."
 
-{% data reusables.discussions.about-categories-and-formats %} {% data reusables.discussions.about-announcement-format %} 
+{% data reusables.discussions.about-categories-and-formats %} {% data reusables.discussions.about-announcement-format %}
 
 Repository administrators and project maintainers can delete a discussion in that repository. Similarly, administrators and maintainers of the source repository for an organization's discussions can delete a discussion in that organization. For more information, see "[AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions#deleting-a-discussion)."
 
@@ -20,7 +20,7 @@ Repository administrators and project maintainers can delete a discussion in tha
 
 As your project grows, you can grant higher access permissions to active members of your community. For more information, see "[AUTOTITLE](/discussions/guides/granting-higher-permissions-to-top-contributors)."
 
-![Most helpful contributors to discussions for a project](/assets/images/help/discussions/most-helpful.png)
+![Screenshot of the "Discussions" page in a repository. The "Most helpful" section is outlined in dark orange.](/assets/images/help/discussions/most-helpful.png)
 
 Community members can upvote discussions and top-level comments inside discussions to communicate with maintainers about ideas that matter to them. Project maintainers can then sort discussions and comments based on upvotes to gain insight into what community members value.
 
@@ -47,9 +47,10 @@ You can search for discussions and filter the list of discussions in a repositor
 {% data reusables.discussions.navigate-to-repo-or-org %}
 {% data reusables.discussions.discussions-tab %}
 1. In the **Search all discussions** field, type a search query. Optionally, to the right of the search field, click a button to further filter the results.
-  ![Search bar and buttons for filtering discussions](/assets/images/help/discussions/search-and-filter-controls.png)
+
+   ![Screenshot of the search bar and buttons for filtering discussions.](/assets/images/help/discussions/search-and-filter-controls.png)
+
 1. In the list of discussions, click the discussion you want to view.
-  ![Discussion search results](/assets/images/help/discussions/search-result.png)
 
 ## Sorting the list of discussions
 
@@ -57,11 +58,12 @@ You can choose how to sort the list of discussions.
 
 {% data reusables.discussions.navigate-to-repo-or-org %}
 {% data reusables.discussions.discussions-tab %}
-1. To the right of the **Search all discussions** field, select **New**, or select **Top** and choose a time period from the drop down menu.
+1. To the right of the **Search all discussions** field, select the **Sort by** dropdown menu, and click a time period.
 
    ![Buttons for sorting discussions](/assets/images/help/discussions/sort-discussions-buttons.png)
 
-    - Sort by **New** to display the discussions with the most recent activity at the top of the list.
+    - Sort by **Latest activity** to display the discussions with the most recent activity at the top of the list.
+    - Sort by **Date created** to display the discussions that were created most recently at the top of the list.
     - Sort by **Top** to display the discussions with the most upvotes at the top of the list. You can limit the list to only display discussions from a specific time period.
 
 ## Sorting top-level comments in discussions
@@ -73,7 +75,7 @@ You can choose how to sort top-level comments in discussions. Comment threads do
 {% data reusables.discussions.click-discussion-in-list %}
 1. Under the main discussion post, select **Oldest**, **Newest**, or **Top**.
 
-   ![Buttons for sorting comments in discussions](/assets/images/help/discussions/sort-comments-buttons.png)
+   ![Screenshot of a discussion. The buttons for sorting comments in discussions are outlined in dark orange.](/assets/images/help/discussions/sort-comments-buttons.png)
 
     - Sort by **Oldest** to display the oldest top-level comments first.
     - Sort by **Newest** to display the newest top-level comments first.

content/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion.md

@@ -49,7 +49,8 @@ You can upvote discussions to give more visibility to the topics that matter to
 1. In the list of discussions, find the discussion you want to upvote.
 1. To the left of the discussion, click the upvote arrow.
 
-   ![Discussion list and upvote button for upvoting discussions](/assets/images/help/discussions/upvote-discussion-button.png)
+   ![Screenshot of the discussion list. A button, labeled with an upwards arrow and "5", is outlined in dark orange.](/assets/images/help/discussions/upvote-discussion-button.png)
+
 1. Optionally, click the upvote arrow again to remove your upvote.
 
 ## Upvoting a comment
@@ -59,8 +60,9 @@ You can upvote top-level comments in discussions, and sort top-level comments to
 {% data reusables.repositories.navigate-to-repo %}
 {% data reusables.discussions.discussions-tab %}
 {% data reusables.discussions.click-discussion-in-list %}
-1. In the discussion, find a top-level comment you want to upvote. 
+1. In the discussion, find a top-level comment you want to upvote.
 1. Click on the upvote arrow at the bottom left of the comment.
 
-   ![Top-level comment and upvote button for upvoting comments](/assets/images/help/discussions/upvote-comment-button.png)
+   ![Screenshot of the top-level comment on a discussion. A button, labeled with an upwards arrow and "1", is outlined in dark orange.](/assets/images/help/discussions/upvote-comment-button.png)
+
 1. Optionally, click the upvote arrow again to remove your upvote.

content/discussions/guides/finding-your-discussions.md

@@ -12,7 +12,9 @@ redirect_from:
 ## Finding discussions
 
 1. In the top-right corner of {% data variables.location.product_location %}, click your profile photo, then click **Your discussions**.
-  !["Your discussions" in drop-down menu for profile photo on {% data variables.product.product_name %}](/assets/images/help/discussions/your-discussions.png)
+
+   ![Screenshot of the account dropdown on {% data variables.product.product_name %}. The "Your discussions" option is outlined in dark orange.](/assets/images/help/discussions/your-discussions.png)
+
 1. Toggle between **Created** and **Commented** to see the discussions you've created or participated in.
 
 ## Further reading

content/discussions/guides/granting-higher-permissions-to-top-contributors.md

@@ -16,7 +16,8 @@ The most helpful contributors for the past 30 days are highlighted on the {% dat
 {% data reusables.discussions.navigate-to-repo-or-org %}
 {% data reusables.discussions.discussions-tab %}
 1. Compare the list of contributors with their access permissions to the repository or, for organization discussions, to the source repository to see who qualifies to moderate the discussion.
-  ![Screenshot of most helpful contributors](/assets/images/help/discussions/most-helpful.png)
+
+   ![Screenshot of the discussions tab in a repository. The "Most helpful" section is outlined in dark orange.](/assets/images/help/discussions/most-helpful.png)
 
 ## Step 2: Review permission levels for {% data variables.product.prodname_discussions %}
 

content/discussions/managing-discussions-for-your-community/managing-categories-for-discussions.md

@@ -35,11 +35,11 @@ Each category must have a unique name and emoji pairing, and can be accompanied
 {% data reusables.discussions.discussions-tab %}
 {% data reusables.discussions.edit-categories %}
 1. Click **New category**.
-  !["New category" button above list of discussion categories for a repository](/assets/images/help/discussions/click-new-category-button.png)
+
+   ![Screenshot of the "Manage discussion categories" page.  A green button, labeled "New category", is highlighted with an orange outline.](/assets/images/help/discussions/click-new-category-button.png)
+
 1. Edit the emoji, title, description, and discussion format for the category. For more information about discussion formats, see "[AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/about-discussions#about-categories-and-formats-for-discussions)."
-  ![Emoji, title, description, and discussion format for new category](/assets/images/help/discussions/edit-category-details.png)
 1. Click **Create**.
-  !["Create" button for new category](/assets/images/help/discussions/new-category-click-create-button.png)
 
 ## Editing a category
 
@@ -47,12 +47,10 @@ You can edit a category to change the category's emoji, title, description, and
 
 1. On {% data variables.location.product_location %}, navigate to the main page of the repository or organization where you want to edit a category.
 {% data reusables.discussions.discussions-tab %}
+{% data reusables.discussions.edit-categories %}
 1. To the right of a category in the list, click {% octicon "pencil" aria-label="The pencil icon" %}.
-  ![Edit button to the right of category in list of categories for a repository](/assets/images/help/discussions/click-edit-for-category.png)
 1. {% data reusables.discussions.edit-category-details %}
-  ![Editing emoji, title, description, and discussion format for existing category](/assets/images/help/discussions/edit-existing-category-details.png)
 1. Click **Save changes**.
-  !["Save changes" button for existing category](/assets/images/help/discussions/existing-category-click-save-changes-button.png)
 
 ## Deleting a category
 
@@ -61,8 +59,5 @@ When you delete a category, {% data variables.product.product_name %} will move
 1. On {% data variables.location.product_location %}, navigate to the main page of the repository or organization where you want to delete a category.
 {% data reusables.discussions.discussions-tab %}
 1. To the right of a category in the list, click {% octicon "trash" aria-label="The trash icon" %}.
-  ![Trash button to the right of category in list of categories for a repository](/assets/images/help/discussions/click-delete-for-category.png)
-1. Use the drop-down menu, and choose a new category for any discussions in the category you're deleting.
-  ![Drop-down menu for choosing new category when deleting an existing category](/assets/images/help/discussions/choose-new-category.png)
-1. Click **Delete & Move**.
-  ![Drop-down menu for choosing new category when deleting an existing category](/assets/images/help/discussions/click-delete-and-move-button.png)
+1. Select the dropdown menu, and click a new category for any discussions in the category you're deleting.
+1. Click **Delete & Move**.

content/discussions/managing-discussions-for-your-community/managing-discussions.md

@@ -42,13 +42,8 @@ You can also move a discussion to a different category. It's not possible to mov
 {% data reusables.discussions.discussions-tab %}
 {% data reusables.discussions.click-discussion-in-list %}
 1. In the right sidebar, to the right of "Category", click {% octicon "gear" aria-label="The gear icon" %}.
-
-   ![Screenshot of the "Category" with gear icon](/assets/images/help/discussions/category-in-sidebar.png)
-
 1. Click a category.
 
-   ![Screenshot of the "Change category" drop-down menu](/assets/images/help/discussions/change-category-drop-down.png)
-
 ## Pinning a discussion
 
 {% ifversion discussions-category-specific-pins %}
@@ -61,7 +56,7 @@ This is what it looks like when you have a globally pinned discussion and a disc
 ### Pinning a discussion globally
 {% endif %}
 
-You can pin up to four important discussions above the list of discussions for the repository or organization. 
+You can pin up to four important discussions above the list of discussions for the repository or organization.
 
 
 {% data reusables.discussions.navigate-to-repo-or-org %}
@@ -70,34 +65,26 @@ You can pin up to four important discussions above the list of discussions for t
 1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Pin discussion**.
 {% ifversion discussions-category-specific-pins %}
 
-   ![Screenshot of the "Pin discussion" option in right sidebar for discussion](/assets/images/help/discussions/click-pin-discussion-with-category-pins.png){% else %}
+   ![Screenshot of the right sidebar of a discussion. The "Pin discussion" option is highlighted with an orange outline.](/assets/images/help/discussions/click-pin-discussion-with-category-pins.png){% else %}
 
-   ![Screenshot of the "Pin discussion" option in right sidebar for discussion](/assets/images/help/discussions/click-pin-discussion.png){% endif %}
+   ![Screenshot of the right sidebar of a discussion. The "Pin discussion" option is highlighted with an orange outline.](/assets/images/help/discussions/click-pin-discussion.png){% endif %}
 
 1. Optionally, customize the look of the pinned discussion.
-
-   ![Screenshot of customization options for a pinned discussion](/assets/images/help/discussions/customize-pinned-discussion.png)
-
 1. Click **Pin discussion**.
 
-   ![Screenshot of the "Pin discussion" button under customization options for pinned discussion](/assets/images/help/discussions/click-pin-discussion-button.png)
-
 {% ifversion discussions-category-specific-pins %}
 ### Pinning a discussion to a category
 
-You can pin up to four important discussions above the list of discussions in a specific category. 
+You can pin up to four important discussions above the list of discussions in a specific category.
 
 {% data reusables.discussions.navigate-to-repo-or-org %}
 {% data reusables.discussions.discussions-tab %}
 {% data reusables.discussions.click-discussion-in-list %}
 1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Pin discussion to CATEGORY**.
-   
-   ![Screenshot of the "Pin discussion to CATEGORY" option in right sidebar for discussion](/assets/images/help/discussions/pin-discussion-to-category.png)
 
-2. To confirm, click **Pin to CATEGORY**.
-
-   ![Screenshot of the "Pin discussion to CATEGORY" modal](/assets/images/help/discussions/pin-discussion-to-category-modal.png)
+   ![Screenshot of the right sidebar of a discussion. The "Pin discussion to Q&A" option is outlined in dark orange.](/assets/images/help/discussions/pin-discussion-to-category.png)
 
+1. To confirm, click **Pin to CATEGORY**.
 {% endif %}
 
 ## Editing a pinned discussion
@@ -107,22 +94,12 @@ Editing a pinned discussion will not change the discussion's category. For more
 {% data reusables.discussions.navigate-to-repo-or-org %}
 {% data reusables.discussions.discussions-tab %}
 {% data reusables.discussions.click-discussion-in-list %}
-1. In the right sidebar, click {% octicon "pencil" aria-label="The pencil icon" %} **Edit pinned discussion**.
-  {% ifversion discussions-category-specific-pins %}
-
-   ![Screenshot of the "Edit pinned discussion" option in right sidebar for discussion](/assets/images/help/discussions/edit-pinned-discussion-with-category-pins.png) {% else %}
-
-
-   ![Screenshot of the "Edit pinned discussion" option in right sidebar for discussion](/assets/images/help/discussions/click-edit-pinned-discussion.png){% endif %}
+1. In the right sidebar, click {% octicon "pencil" aria-label="The pencil icon" %} **Edit pinned discussion**. {% ifversion discussions-category-specific-pins %}
 
+   ![Screenshot of the right sidebar of a discussion. The "Edit pinned discussion" option is outlined in dark orange.](/assets/images/help/discussions/edit-pinned-discussion-with-category-pins.png){% endif %}
 1. Customize the look of the pinned discussion.
-
-  ![Screenshot of customization options for a pinned discussion](/assets/images/help/discussions/customize-pinned-discussion.png)
-
 1. Click **Pin discussion**.
 
-  ![Screenshot of the "Pin discussion" button under customization options for pinned discussion](/assets/images/help/discussions/click-pin-discussion-button.png)
-
 ## Unpinning a discussion
 
 {% ifversion discussions-category-specific-pins %}
@@ -143,8 +120,6 @@ You can unpin a globally pinned discussion. This will not delete the discussion,
 
 1. Read the warning, then click **Unpin discussion**.
 
-  ![Screenshot of the "Unpin discussion" button beneath warning in modal](/assets/images/help/discussions/click-unpin-discussion-button.png)
-
 {% ifversion discussions-category-specific-pins %}
 ### Unpinning a discussion from a category
 
@@ -155,12 +130,9 @@ You can unpin a discussion pinned to a specific category. This will not delete t
 {% data reusables.discussions.click-discussion-in-list %}
 1. In the right sidebar, click {% octicon "pin" aria-label="The pin icon" %} **Unpin discussion from this category**.
 
-   ![Screenshot of the "Unpin discussion from this category" option in right sidebar for discussion](/assets/images/help/discussions/unpin-discussion-from-category.png)
+   ![Screenshot of the right sidebar of a discussion. The "Unpin discussion from this category" option is outlined in dark orange.](/assets/images/help/discussions/unpin-discussion-from-category.png)
 
 1. Read the warning, then click **Unpin from this category**.
-
-   ![Screenshot of the "Unpin from this category" button in the "Unpin this discussion from this category" modal](/assets/images/help/discussions/unpin-discussion-from-category-modal.png)
-
 {% endif %}
 
 ## Transferring a discussion
@@ -173,19 +145,14 @@ To transfer a discussion, you must have permissions to create discussions in the
 1. In the right sidebar, click {% octicon "arrow-right" aria-label="The right arrow icon" %} {% ifversion discussions-category-specific-pins %}**Transfer this discussion**{% else %}**Transfer discussion**{% endif %}.
 {% ifversion discussions-category-specific-pins %}
 
-   ![Screenshot of the "Transfer discussion" option in right sidebar for discussion](/assets/images/help/discussions/transfer-discussion-with-category-pin.png) {% else %}
+   ![Screenshot of the right sidebar of a discussion. The "Transfer this discussion" option is outlined in dark orange.](/assets/images/help/discussions/transfer-discussion-with-category-pin.png) {% else %}
 
-  
-   ![Screenshot of the "Transfer discussion" option in right sidebar for discussion](/assets/images/help/discussions/click-transfer-discussion.png){% endif %}
 
-1. Select the **Choose a repository** drop-down, and click the repository you want to transfer the discussion to. If you want to transfer a discussion to an organization, choose the source repository for the organization's discussions.
-
-   ![Screenshot of the "Choose a repository" drop-down, "Find a repository" search field, and repository in list](/assets/images/help/discussions/use-choose-a-repository-drop-down.png)
+   ![Screenshot of the right sidebar of a discussion. The "Transfer this discussion" option is outlined in dark orange.](/assets/images/help/discussions/click-transfer-discussion.png){% endif %}
 
+1. Select the repository you want to transfer the discussion to. You can also search for repositories. If you want to transfer a discussion to an organization, choose the source repository for the organization's discussions.
 1. Click **Transfer discussion**.
 
-   ![Screenshot of the "Transfer discussion" button](/assets/images/help/discussions/click-transfer-discussion-button.png)
-
 ## Deleting a discussion
 
 {% data reusables.discussions.navigate-to-repo-or-org %}
@@ -194,15 +161,10 @@ To transfer a discussion, you must have permissions to create discussions in the
 1. In the right sidebar, click {% octicon "trash" aria-label="The trash arrow icon" %} **Delete discussion**.
 {% ifversion discussions-category-specific-pins %}
 
-   ![Screenshot of the "Delete discussion" option in right sidebar for discussion](/assets/images/help/discussions/delete-discussion-with-category-pins.png){% else %}
-
-
-   ![Screenshot of the "Delete discussion" option in right sidebar for discussion](/assets/images/help/discussions/click-delete-discussion.png){% endif %}
+   ![Screenshot of the right sidebar of a discussion. The "Delete discussion" option is outlined in dark orange.](/assets/images/help/discussions/delete-discussion-with-category-pins.png){% endif %}
 
 1. Read the warning, then click **Delete this discussion**.
 
-   ![Screenshot of the "Delete this discussion" button beneath warning in modal](/assets/images/help/discussions/click-delete-this-discussion-button.png)
-
 ## Converting issues based on labels
 
 You can convert all issues with the same label to discussions in bulk. Future issues with this label will also automatically convert to the discussion and category you configure.

content/discussions/managing-discussions-for-your-community/moderating-discussions.md

@@ -23,14 +23,11 @@ It's appropriate to lock a conversation when the entire conversation is not cons
 {% data reusables.discussions.discussions-tab %}
 1. In the list of discussions, click the discussion you want to lock.
 
-   ![Screenshot of the discussion to be locked](/assets/images/help/discussions/unanswered-discussion.png)
+   ![Screenshot of the list of discussions with an unanswered discussion.](/assets/images/help/discussions/unanswered-discussion.png)
 
 1. In the right margin of a discussion, click **Lock conversation**.
 1. Read the information about locking conversations.{% ifversion discussions-lock-allow-reactions %}
-1. Optionally, to allow emoji reactions while the discussion is locked, select **Allow reactions**.
-
-   ![Screenshot of the lock discussion modal with the allow reactions option emphasized](/assets/images/help/discussions/allow-reactions-locked-discussion.png){% endif %}
-
+1. Optionally, to allow emoji reactions while the discussion is locked, select **Allow reactions**.{% endif %}
 1. To lock the conversation, click **Lock conversation**.
 1. When you're ready to unlock the conversation, click **Unlock conversation** in the right margin of a discussion, then click **Unlock conversation**.
 
@@ -50,5 +47,5 @@ When you convert an issue to a discussion, the discussion is automatically creat
 
 Organization owners and moderators can block a user from the organization if their comments don't align with the community's code of conduct. When you block a user, they will no longer be able to comment on discussions. You can also hide all of the comments a user has made in the organization. For more information, see "[AUTOTITLE](/communities/maintaining-your-safety-on-github/blocking-a-user-from-your-organization)."
 
-{% data reusables.organizations.blocking-a-user %} 
+{% data reusables.organizations.blocking-a-user %}
 {% endif %}

content/discussions/managing-discussions-for-your-community/viewing-insights-for-your-discussions.md

@@ -19,17 +19,18 @@ You can use discussions insights to help understand the contribution activity, p
 
 ![Screenshot of the discussions dashboard](/assets/images/help/discussions/discussions-dashboard.png)
 
-{% tip %}
+{% note %}
 
-**Tip:** To view the exact data for a time period, hover over that time period in the graph.
+**Note:** To view the exact data for a time period, hover over that time period in the graph.
 
-{% endtip %}
+{% endnote %}
 
 ## Viewing discussions insights
 
 {% data reusables.repositories.navigate-to-repo %} For organization discussions, navigate to the main page of the source repository.
 {% data reusables.repositories.accessing-repository-graphs %}
-3. In the left sidebar, click **Community**.
-![Screenshot of the left sidebar. The "Community" tab is highlighted with an orange outline.](/assets/images/help/graphs/graphs-sidebar-community-tab.png)
+1. In the left sidebar, click **Community**.
+
+   ![Screenshot of the "Community" tab in left sidebar](/assets/images/help/graphs/graphs-sidebar-community-tab.png)
+
 1. Optionally, in the upper-right corner of the page, select the **Period** dropdown menu and click the time period for which you want to view data: **30 days**, **3 months**, or **1 year**.
-![Screenshot of the date range selector for discussions insights](/assets/images/help/discussions/discussions-dashboard-date-selctor.png)

content/discussions/quickstart.md

@@ -23,12 +23,15 @@ When you first enable {% data variables.product.prodname_discussions %}, you wil
 {% data reusables.repositories.navigate-to-repo %}
 1. Under your repository name, click {% octicon "gear" aria-label="The gear icon" %}
 **Settings**.
-![Public settings button](/assets/images/help/discussions/public-repo-settings.png)
-1. Under "Features", click **Set up discussions**.
-  ![Set up a discussion button under "Features" for enabling or disabling GitHub Discussions for a repository](/assets/images/help/discussions/setup-discussions-button.png)
+
+   ![Screenshot of the tabs in a {% data variables.product.company_short %} repository. The "Settings" option is outlined in dark orange.](/assets/images/help/discussions/public-repo-settings.png)
+
+1. Scroll down to the "Features" section and click **Set up discussions**.
+
+   ![Screenshot of the "Discussions" option in the repository's settings. A green button, labeled "Set up discussions", is outlined in dark orange.](/assets/images/help/discussions/setup-discussions-button.png)
+
 1. Under "Start a new discussion," edit the template to align with the resources and tone you want to set for your community.
 1. Click **Start discussion**.
-  !["Start discussion" button](/assets/images/help/discussions/new-discussion-start-discussion-button.png)
 
 ## Enabling {% data variables.product.prodname_discussions %} on your organization
 

content/get-started/quickstart/communicating-on-github.md

@@ -29,19 +29,19 @@ You can create and participate in issues, pull requests and team discussions, de
 {% endif %}
 
 ### {% data variables.product.prodname_github_issues %}
-- are useful for discussing specific details of a project such as bug reports, planned improvements and feedback. 
-- are specific to a repository, and usually have a clear owner. 
+- are useful for discussing specific details of a project such as bug reports, planned improvements and feedback.
+- are specific to a repository, and usually have a clear owner.
 - are often referred to as {% data variables.product.prodname_dotcom %}'s bug-tracking system.
-  
+
 ### Pull requests
 - allow you to propose specific changes.
-- allow you to comment directly on proposed changes suggested by others. 
-- are specific to a repository. 
- 
+- allow you to comment directly on proposed changes suggested by others.
+- are specific to a repository.
+
 {% ifversion fpt or ghec %}
 ### {% data variables.product.prodname_discussions %}
--  are like a forum, and are best used for open-form ideas and discussions where collaboration is important. 
--  may span many repositories. 
+-  are like a forum, and are best used for open-form ideas and discussions where collaboration is important.
+-  may span many repositories.
 -  provide a collaborative experience outside the codebase, allowing the brainstorming of ideas, and the creation of a community knowledge base.
 -  often don’t have a clear owner.
 -  often do not result in an actionable task.
@@ -49,7 +49,7 @@ You can create and participate in issues, pull requests and team discussions, de
 
 ### Team discussions
 - can be started on your team's page for conversations that span across projects and don't belong in a specific issue or pull request. Instead of opening an issue in a repository to discuss an idea, you can include the entire team by having a conversation in a team discussion.
-- allow you to hold discussions with your team about planning, analysis, design, user research and general project decision making in one place.{% ifversion ghes or ghae %} 
+- allow you to hold discussions with your team about planning, analysis, design, user research and general project decision making in one place.{% ifversion ghes or ghae %}
 - provide a collaborative experience outside the codebase, allowing the brainstorming of ideas.
 - often don’t have a clear owner.
 - often do not result in an actionable task.{% endif %}
@@ -65,11 +65,11 @@ You can create and participate in issues, pull requests and team discussions, de
 
 #### Issue example
 
-This example illustrates how a {% data variables.product.prodname_dotcom %} user created an issue in our documentation open source repository to make us aware of a bug, and discuss a fix. 
+This example illustrates how a {% data variables.product.prodname_dotcom %} user created an issue in our documentation open source repository to make us aware of a bug, and discuss a fix.
 
 ![Example of issue](/assets/images/help/issues/issue-example.png)
 
-- A user noticed that the blue color of the banner at the top of the page in the Chinese version of the {% data variables.product.prodname_dotcom %} Docs makes the text in the banner unreadable. 
+- A user noticed that the blue color of the banner at the top of the page in the Chinese version of the {% data variables.product.prodname_dotcom %} Docs makes the text in the banner unreadable.
 - The user created an issue in the repository, stating the problem and suggesting a fix (which is, use a different background color for the banner).
 - A discussion ensues, and eventually, a consensus will be reached about the fix to apply.
 - A contributor can then create a pull request with the fix.
@@ -83,7 +83,7 @@ This example illustrates how a {% data variables.product.prodname_dotcom %} user
 
 #### Pull request example
 
-This example illustrates how a {% data variables.product.prodname_dotcom %} user created a pull request in our documentation open source repository to fix a typo. 
+This example illustrates how a {% data variables.product.prodname_dotcom %} user created a pull request in our documentation open source repository to fix a typo.
 
 In the **Conversation** tab of the pull request, the author explains why they created the pull request.
 
@@ -109,7 +109,7 @@ The **Files changed** tab of the pull request shows the implemented fix.
 
 This example shows the {% data variables.product.prodname_discussions %} welcome post for the {% data variables.product.prodname_dotcom %} Docs open source repository, and illustrates how the team wants to collaborate with their community.
 
-![Example of {% data variables.product.prodname_discussions %}](/assets/images/help/discussions/github-discussions-example.png)
+![Screenshot of an example of a discussion, with the title "Welcome to GitHub Docs Discussions."](/assets/images/help/discussions/github-discussions-example.png)
 
 This community maintainer started a discussion to welcome the community, and to ask members to introduce themselves. This post fosters an inviting atmosphere for visitors and contributors. The post also clarifies that the team's happy to help with contributions to the repository.
 

content/issues/tracking-your-work-with-issues/creating-an-issue.md

@@ -110,7 +110,9 @@ When you create an issue from a discussion, the contents of the discussion post
 {% data reusables.discussions.discussions-tab %}
 {% data reusables.discussions.click-discussion-in-list %}
 1. In the right sidebar, click {% octicon "issue-opened" aria-label="The issues icon" %} **Create issue from discussion**.
-   ![Button to create issue from discussion](/assets/images/help/discussions/create-issue-from-discussion.jpg)
+
+   ![Screenshot of the sidebar in a discussion. The "Create issue from discussion" option is outlined in dark orange.](/assets/images/help/discussions/create-issue-from-discussion.png)
+
 {% data reusables.repositories.type-issue-title-and-description %}
 {% data reusables.repositories.assign-an-issue-as-project-maintainer %}
 {% data reusables.repositories.submit-new-issue %}

content/organizations/managing-organization-settings/managing-discussion-creation-for-repositories-in-your-organization.md

@@ -20,10 +20,8 @@ By default, organization members with read access can create discussions if a re
 {% data reusables.profile.access_org %}
 {% data reusables.profile.org_settings %}
 {% data reusables.organizations.member-privileges %}
-5. Under "Repository discussions", select or deselect **Allow users with read access to create discussions**.
-  ![Checkbox to allow people with read access to create discussions](/assets/images/help/discussions/toggle-allow-users-with-read-access-checkbox.png)
-6. Click **Save**.
-  !["Save" button for discussions settings](/assets/images/help/discussions/click-save.png)
+1. In the "Admin repository permissions" section, under "Repository discussions", select or deselect **Allow users with read access to create discussions**.
+1. Click **Save**.
 
 ## Further reading
 

data/reusables/discussions/click-discussion-in-list.md

@@ -1,2 +1 @@
-1. In the list of discussions, click the discussion you want to view.
-  ![Discussion in list of discussions for a repository](/assets/images/help/discussions/click-discussion-in-list.png)
+1. In the list of discussions, click the discussion you want to view.

data/reusables/discussions/discussions-tab.md

@@ -1,2 +1,3 @@
 1. Under your repository or organization name, click {% octicon "comment-discussion" aria-label="The discussion icon" %} **Discussions**.
-  !["Discussions" tab for a repository](/assets/images/help/discussions/repository-discussions-tab.png)
+
+   ![Screenshot of the tabs in a {% data variables.product.company_short %} repository. The "Discussions" option is outlined in dark orange.](/assets/images/help/discussions/repository-discussions-tab.png)

data/reusables/discussions/edit-categories.md

@@ -1,2 +1,3 @@
-1. To the right of "Categories", click {% octicon "pencil" aria-label="The pencil icon" %}.
-  ![Pencil icon for editing categories](/assets/images/help/discussions/click-edit-categories.png)
+1. In the left sidebar, to the right of "Categories", click {% octicon "pencil" aria-label="The pencil icon" %}.
+
+   ![Screenshot of the "Categories" menu on the Discussions page. The pencil icon for editing categories is highlighted with an orange outline.](/assets/images/help/discussions/click-edit-categories.png)

data/reusables/discussions/enabling-or-disabling-github-discussions-for-your-organization.md

@@ -1,8 +1,9 @@
 1. On {% data variables.location.product_location %}, navigate to the main page of your organization.
 1. Under your organization name, click {% octicon "gear" aria-label="The gear icon" %}
 **Settings**.
-![Organization settings button](/assets/images/help/discussions/org-settings.png)
+
+   ![Screenshot of the tabs in an organization's profile. The "Settings" tab is outlined in dark orange.](/assets/images/help/discussions/org-settings.png)
+
 1. Under "Discussions", select **Enable discussions for this organization**.
-1. Select a repository to use as the source repository for your organization discussions.
-  ![Settings to enable discussions for an organization](/assets/images/help/discussions/enable-org-discussions.png)
+1. Use the dropdown menu to select a repository to use as the source repository for your organization discussions.
 1. Click **Save**.

data/reusables/discussions/enabling-or-disabling-github-discussions-for-your-repository.md

@@ -3,6 +3,7 @@ You can enable or disable {% data variables.product.prodname_discussions %} for
 {% data reusables.repositories.navigate-to-repo %}
 1. Under your repository name, click {% octicon "gear" aria-label="The gear icon" %}
 **Settings**.
-![Repository settings button](/assets/images/help/discussions/public-repo-settings.png)
-1. Under "Features", select **Discussions**.
-    ![Checkbox under "Features" for enabling or disabling {% data variables.product.prodname_discussions %} for a repository](/assets/images/help/discussions/select-discussions-checkbox.png)
+
+   ![Screenshot of the tabs in a {% data variables.product.company_short %} repository. The "Settings" option is outlined in dark orange.](/assets/images/help/discussions/public-repo-settings.png)
+
+1. Scroll down to the "Features" section and select **Discussions**.

data/reusables/discussions/marking-a-comment-as-an-answer.md

@@ -2,15 +2,19 @@ You can mark a comment in the discussion as an answer to the discussion if a dis
 
 When you mark a question as an answer, {% data variables.product.product_name %} will highlight the comment and replies to the comment to help visitors quickly find the answer.
 
-![Comment marked as answer to a discussion](/assets/images/help/discussions/comment-marked-as-answer.png)
+![Screenshot of a comment marked as the answer to a discussion.](/assets/images/help/discussions/comment-marked-as-answer.png)
 
 You can't mark a threaded comment in response to a comment as the answer to a discussion. You also can't mark a minimized comment as the answer to a discussion.
 
 {% data reusables.discussions.navigate-to-repo-or-org %}
 {% data reusables.discussions.discussions-tab %}
 1. In the list of discussions, click the unanswered discussion you want to mark as answered.
-  ![Unanswered discussion](/assets/images/help/discussions/unanswered-discussion.png)
+
+   ![Screenshot of the list of discussions with an unanswered discussion.](/assets/images/help/discussions/unanswered-discussion.png)
+
 1. In the discussion, find the comment you want to mark as the answer.
-1. In the upper-right corner of the comment, click {% octicon "check-circle" aria-label="The circular check icon" %}.
-  !["Mark as answer" circular check icon for marking comment as answer in a discussion](/assets/images/help/discussions/comment-mark-as-answer-button.png)
-1. Optionally, to unmark a comment as the answer, click {% octicon "check-circle-fill" aria-label="The filled circular check icon" %}.
+1. Below the comment, click **Mark as answer**.
+
+   ![Screenshot of a discussion comment. A button, labeled "Mark as answer", is outlined in dark orange.](/assets/images/help/discussions/comment-mark-as-answer-button.png)
+
+2. Optionally, to unmark a comment as the answer, click **Unmark as answer**.

data/reusables/discussions/starting-a-discussion.md

@@ -1,10 +1,12 @@
 1. On {% data variables.location.product_location %}, navigate to the main page of the repository or organization where you want to start a discussion.
 {% data reusables.discussions.discussions-tab %}
-1. Click **New discussion**.
-  !["New discussion" button within the "Discussions" tab for a repository](/assets/images/help/discussions/new-discussion-button.png)
-1. Select the **Select Category** drop-down menu, and click a category for your discussion.
-  !["Select Category" drop-down menu and list of available categories in a repository](/assets/images/help/discussions/new-discussion-select-category-dropdown-menu.png)
-1. Type a title and body for your discussion.
-  ![Text fields for new discussion's title and body](/assets/images/help/discussions/new-discussion-title-and-body-fields.png)
+1. On the right side of the page, click **New discussion**.
+1. Select a discussion category by clicking **Get started**.
+
+   ![Screenshot of the "Select a discussion category" page.  A button, labeled "Get started", is outlined in dark orange.](/assets/images/help/discussions/new-discussion-select-category-dropdown-menu.png)
+
+1. Under "Discussion title", type a title for your discussion, and under "Write", type the body of your discussion.
+
+   ![Screenshot of the text fields for the title and body for a new discussion.](/assets/images/help/discussions/new-discussion-title-and-body-fields.png)
+
 1. Click **Start discussion**.
-  !["Start discussion" button](/assets/images/help/discussions/new-discussion-start-discussion-button.png)

data/reusables/discussions/starting-a-poll.md

@@ -1,16 +1,18 @@
 {% data reusables.repositories.navigate-to-repo %}
 {% data reusables.discussions.discussions-tab %}
 1. In the list of categories, click **Polls**.
-  ![Screenshot showing "Poll" category](/assets/images/help/discussions/poll-category.png)
-1. On the right, click **Start poll**.
-  ![Screenshot showing the "Start poll" button](/assets/images/help/discussions/start-poll-button.png)
-1. Type a title and optional body for your poll.
-  ![Screenshot showing text fields for title and body](/assets/images/help/discussions/new-poll-title-and-body-fields.png)
-1. Type a question for your poll.
-  ![Screenshot showing text fields for the poll's question](/assets/images/help/discussions/new-poll-question.png)
-1. Type at least two options for your poll.
-  ![Screenshot showing text fields for the poll's options](/assets/images/help/discussions/new-poll-options.png)
-1. Optionally, to add an extra poll option, click **Add an option**.
-  ![Screenshot showing "Add an option" button](/assets/images/help/discussions/new-poll-add-option.png)
-1. Click **Start poll**.
-  ![Screenshot showing the "Start poll" button](/assets/images/help/discussions/new-poll-start-poll-button.png)
+
+   ![Screenshot of the categories section in the "Discussions" tab. The "Poll" category is outlined in dark orange.](/assets/images/help/discussions/poll-category.png)
+
+1. On the right, click **New discussion**.
+1. Under "Discussion title", type a title and optionally, under "Write", type a body for your poll.
+
+   ![Screenshot of the page to start a new poll.](/assets/images/help/discussions/new-poll-title-and-body-fields.png)
+
+1. Under "Poll question", type a question for your poll.
+1. Under "Poll options", type at least two options for your poll.
+1. Optionally, to add an extra poll option, click **{% octicon "plus" aria-label="The plus icon" %} Add an option**.
+
+   ![Screenshot of the page to start a new poll. The plus icon and "Add an option" are outlined in dark orange.](/assets/images/help/discussions/new-poll-add-option.png)
+
+1. Click **Start poll**.