Skip to content

Commit 33f29ea

Browse files
committed
Reorganized the article
1 parent 6828447 commit 33f29ea

File tree

1 file changed

+5
-27
lines changed

1 file changed

+5
-27
lines changed

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

Lines changed: 5 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -23,39 +23,17 @@ With {% data variables.product.prodname_discussions %}, the community for your p
2323

2424
You might use repository discussions to discuss topics that are specific to the repository. If your project spans multiple repositories, {% data variables.product.prodname_discussions %} can also be used for broader conversations that affect the entire organization.
2525

26-
{% data reusables.discussions.closing-discussions %} For more information, see [Closing a discussion](/discussions/managing-discussions-for-your-community/managing-discussions#closing-a-discussion).
26+
Anyone who can has access to a repository can create and participate in discussions once a repository administrator or project maintainer has enabled {% data variables.product.prodname_discussions %}. Similarly, if an organization owner enables {% data variables.product.prodname_discussions %} for an organization, anyone who can view the source repository can create an organization discussion.
2727

28-
Anyone who can has access to a repository can create and participate in discussions once a repository administrator or project maintainer has enabled {% data variables.product.prodname_discussions %}. Similarly, if an organization owner enables {% data variables.product.prodname_discussions %} for an organization, anyone who can view the source repository can create an organization discussion.
29-
30-
Repository administrators and project maintainers can manage discussions and discussion categories in a repository, and pin discussions to increase the visibility of a topic. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. For organization discussions, the role of a user in the source repository determines how a user can interact with organization discussions. For more information, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization).
31-
32-
For more information about management of discussions, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions).
33-
34-
## About polls
35-
36-
If you're looking to gauge interest in new ideas or project direction, you can create polls in the polls category of {% data variables.product.prodname_discussions %}. Anyone with read access to your repository can create polls, vote in polls, and view poll results.{% ifversion fpt or ghec %} Signed out users can view the results of polls in public repositories.{% endif %}
37-
38-
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.
39-
40-
Voters cannot change their vote. Editing a poll will reset any votes that have already been cast.
28+
{% data variables.product.prodname_discussions %} offers you varying levels of granularity for organizing discussions. Discussions are opened in categories defined by anyone with maintain or admin permissions. Categories come with different formats, such as announcements, question and answer, polls, or open-ended, and categories can be further organized under sections you specify. Individual discussions can be categorized with more specificity by applying labels. For more information about managing categories, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions).
4129

4230
For more information on creating polls, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-poll).
4331

44-
## About discussion organization
32+
Repository administrators and project maintainers can manage discussions and discussion categories in a repository. Discussions can be pinned to give topics more visibility. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. For organization discussions, the role of a user in the source repository determines how a user can interact with organization discussions. For more information about organization repository roles, see [AUTOTITLE](/organizations/managing-user-access-to-your-organizations-repositories/managing-repository-roles/repository-roles-for-an-organization).
4533

46-
Discussions can be organized with categories, sections, and labels.
47-
48-
{% data reusables.discussions.you-can-categorize-discussions %} {% data reusables.discussions.about-categories-and-formats %} {% data reusables.discussions.repository-category-limit %}
49-
50-
For discussions with a question/answer format, an individual comment within the discussion can be marked as the discussion's answer. {% data reusables.discussions.github-recognizes-members %}
51-
52-
{% data reusables.discussions.about-announcement-format %}
53-
54-
{% data reusables.discussions.category-sections %} For more information, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-categories-for-discussions).
55-
56-
{% data reusables.discussions.you-can-label-discussions %}
34+
For more information about management of discussions, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions).
5735

58-
## Best practices for {% data variables.product.prodname_discussions %}
36+
## Use cases for {% data variables.product.prodname_discussions %}
5937

6038
As a community member or maintainer, start a discussion to ask a question or discuss information that affects the community. For more information, see [AUTOTITLE](/discussions/collaborating-with-your-community-using-discussions/collaborating-with-maintainers-using-discussions).
6139

0 commit comments

Comments
 (0)