[2022-11-14]: Category specific pins in Discussions - [GA] (#32476)
Co-authored-by: github-actions <github-actions@github.com> Co-authored-by: Anne-Marie <102995847+am-stead@users.noreply.github.com>
This commit is contained in:
Sophie
Binary file not shown.
|
After Width: | Height: | Size: 21 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 50 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 50 KiB |
BIN
assets/images/help/discussions/overview-pinned-discussions.png
Normal file
BIN
assets/images/help/discussions/overview-pinned-discussions.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 431 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 16 KiB |
BIN
assets/images/help/discussions/pin-discussion-to-category.png
Normal file
BIN
assets/images/help/discussions/pin-discussion-to-category.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 46 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 50 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 49 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 48 KiB |
@@ -20,6 +20,8 @@ As a discussions maintainer, you can create community resources to encourage dis
|
||||
|
||||
When a discussion yields an idea or bug that is ready to be worked on, you can create a new issue from a discussion. For more information, see "[Creating an issue](/issues/tracking-your-work-with-issues/creating-an-issue#creating-an-issue-from-a-discussion)."
|
||||
|
||||
You can pin a discussion to the top of the list of discussions for the repository or organization. {% ifversion discussions-category-specific-pins %}You can also pin a discussion to a specific category.{% endif %} For more information, see "[Pinning a discussion](/discussions/managing-discussions-for-your-community/managing-discussions#pinning-a-discussion)."
|
||||
|
||||
For more information on facilitating a healthy discussion, see "[Moderating comments and conversations](/communities/moderating-comments-and-conversations)."
|
||||
|
||||
{% data reusables.discussions.you-can-label-discussions %}
|
||||
@@ -40,23 +42,63 @@ 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" %}.
|
||||
|
||||
|
||||
|
||||
|
||||
1. Click a category.
|
||||
|
||||
|
||||
|
||||
|
||||
## Pinning a discussion
|
||||
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
You can pin a discussion above the list of discussions for the repository or organization. You can also pin a discussion to a specific category. The globally pinned discussions will be shown in addition to the discussions pinned to a specific category.
|
||||
|
||||
This is what it looks like when you have a globally pinned discussion and a discussion pinned to the Ideas category.
|
||||
|
||||
|
||||
|
||||
### Pinning a discussion globally
|
||||
{% endif %}
|
||||
|
||||
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 %}
|
||||
{% 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**.
|
||||
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
|
||||
{% else %}
|
||||
|
||||
{% endif %}
|
||||
|
||||
1. Optionally, customize the look of the pinned discussion.
|
||||
|
||||
|
||||
|
||||
|
||||
1. Click **Pin discussion**.
|
||||
|
||||
|
||||
|
||||
|
||||
{% 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.
|
||||
|
||||
{% 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**.
|
||||
|
||||
|
||||
|
||||
2. To confirm, click **Pin to CATEGORY**.
|
||||
|
||||
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Editing a pinned discussion
|
||||
|
||||
@@ -66,21 +108,60 @@ Editing a pinned discussion will not change the discussion's category. For more
|
||||
{% 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 %}
|
||||
|
||||
 {% else %}
|
||||
|
||||
|
||||
{% endif %}
|
||||
|
||||
1. Customize the look of the pinned discussion.
|
||||
|
||||
|
||||
|
||||
|
||||
1. Click **Pin discussion**.
|
||||
|
||||
|
||||
|
||||
|
||||
## Unpinning a discussion
|
||||
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
|
||||
You can unpin a discussion from the list of discussions for the repository or organization, or from the list of discussions in a specific category.
|
||||
|
||||
### Unpinning a globally pinned discussion
|
||||
|
||||
You can unpin a globally pinned discussion. This will not delete the discussion, but the discussion will no longer be displayed above the list of discussions.
|
||||
{% endif %}
|
||||
|
||||
{% 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" %} **Unpin discussion**.
|
||||
|
||||
|
||||
|
||||
|
||||
1. Read the warning, then click **Unpin discussion**.
|
||||
|
||||
|
||||
|
||||
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
### Unpinning a discussion from a category
|
||||
|
||||
You can unpin a discussion pinned to a specific category. This will not delete the discussion, but the discussion will no longer be displayed at the top of the 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" %} **Unpin discussion from this category**.
|
||||
|
||||
|
||||
|
||||
1. Read the warning, then click **Unpin from this category**.
|
||||
|
||||
|
||||
|
||||
{% endif %}
|
||||
|
||||
## Transferring a discussion
|
||||
|
||||
@@ -89,12 +170,21 @@ To transfer a discussion, you must have permissions to create discussions in the
|
||||
{% 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 "arrow-right" aria-label="The right arrow icon" %} **Transfer discussion**.
|
||||
|
||||
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 %}
|
||||
|
||||
 {% else %}
|
||||
|
||||
|
||||
{% 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.
|
||||
|
||||
|
||||
|
||||
|
||||
1. Click **Transfer discussion**.
|
||||
|
||||
|
||||
|
||||
|
||||
## Deleting a discussion
|
||||
|
||||
@@ -102,9 +192,16 @@ To transfer a discussion, you must have permissions to create discussions in the
|
||||
{% data reusables.discussions.discussions-tab %}
|
||||
{% data reusables.discussions.click-discussion-in-list %}
|
||||
1. In the right sidebar, click {% octicon "trash" aria-label="The trash arrow icon" %} **Delete discussion**.
|
||||
|
||||
{% ifversion discussions-category-specific-pins %}
|
||||
|
||||
{% else %}
|
||||
|
||||
|
||||
{% endif %}
|
||||
|
||||
1. Read the warning, then click **Delete this discussion**.
|
||||
|
||||
|
||||
|
||||
|
||||
## Converting issues based on labels
|
||||
|
||||
|
||||
7
data/features/discussions-category-specific-pins.yml
Normal file
7
data/features/discussions-category-specific-pins.yml
Normal file
@@ -0,0 +1,7 @@
|
||||
# Issues 8452
|
||||
# Category specific pins in Discussions
|
||||
versions:
|
||||
fpt: '*'
|
||||
ghec: '*'
|
||||
ghes: '>=3.8'
|
||||
ghae: '>=3.8'
|
||||
Reference in New Issue
Block a user