You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/discussions/collaborating-with-your-community-using-discussions/about-discussions.md
+9-8Lines changed: 9 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,27 +12,28 @@ versions:
12
12
13
13
With {% data variables.product.prodname_discussions %}, the community for your project can create and participate in conversations within the project's repository or organization. Discussions empower a project's maintainers, contributors, and visitors to gather and accomplish the following goals in a central location, without third-party tools.
14
14
15
-
* Share announcements and information, gather feedback, plan, and make decisions
16
-
* Ask questions, discuss and answer the questions, and mark the discussions as answered
17
-
* Create polls to gauge community opinion
15
+
* Share announcements and information
16
+
* Plan and make decisions with community input
17
+
* Encourage and answer questions, and mark them answered as you respond to them
18
+
* Gather feedback using polls to gauge community opinion
18
19
* Upvote discussions and comments to give higher visibility to ideas you find valuable
19
20
* Foster an inviting atmosphere for visitors and contributors to discuss goals, development, administration, and workflows
20
21
21
22

22
23
23
-
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.
24
+
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.
24
25
25
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
27
27
-
If a repository administrator or project maintainer enables {% data variables.product.prodname_discussions %} for a repository, anyone who has access to the repository can create and participate in discussions for the repository. 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.
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.
28
29
29
-
Repository administrators and project maintainers can manage discussions and discussion categories in a repository, and pin discussions to increase the visibility of the discussion. Moderators and collaborators can mark comments as answers, lock discussions, and convert issues to discussions. Similarly, 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).
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).
30
31
31
32
For more information about management of discussions, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions).
32
33
33
34
## About polls
34
35
35
-
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 %}
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 %}
36
37
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.
38
39
@@ -42,7 +43,7 @@ For more information on creating polls, see [AUTOTITLE](/discussions/collaborati
42
43
43
44
## About discussion organization
44
45
45
-
You can organize discussions with categories, sections, and labels.
46
+
Discussions can be organized with categories, sections, and labels.
46
47
47
48
{% data reusables.discussions.you-can-categorize-discussions %} {% data reusables.discussions.about-categories-and-formats %} {% data reusables.discussions.repository-category-limit %}
0 commit comments