Skip to content

Commit b168597

Browse files
committed
Update about-discussions.md for scanability
1 parent 46e13e4 commit b168597

File tree

1 file changed

+9
-8
lines changed

1 file changed

+9
-8
lines changed

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

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -12,27 +12,28 @@ versions:
1212

1313
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.
1414

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
1819
* Upvote discussions and comments to give higher visibility to ideas you find valuable
1920
* Foster an inviting atmosphere for visitors and contributors to discuss goals, development, administration, and workflows
2021

2122
![Screenshot of the "Discussions" page for a repository, showing a list of discussions such as "Feedback on the new layout" and "Project direction".](/assets/images/help/discussions/hero.png)
2223

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.
2425

2526
{% data reusables.discussions.closing-discussions %} For more information, see [Closing a discussion](/discussions/managing-discussions-for-your-community/managing-discussions#closing-a-discussion).
2627

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.
2829

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).
3031

3132
For more information about management of discussions, see [AUTOTITLE](/discussions/managing-discussions-for-your-community/managing-discussions).
3233

3334
## About polls
3435

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 %}
3637

3738
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.
3839

@@ -42,7 +43,7 @@ For more information on creating polls, see [AUTOTITLE](/discussions/collaborati
4243

4344
## About discussion organization
4445

45-
You can organize discussions with categories, sections, and labels.
46+
Discussions can be organized with categories, sections, and labels.
4647

4748
{% data reusables.discussions.you-can-categorize-discussions %} {% data reusables.discussions.about-categories-and-formats %} {% data reusables.discussions.repository-category-limit %}
4849

0 commit comments

Comments
 (0)