Skip to content

Commit 6385f79

Browse files
Made list unordered
Also rephrased a couple of paragraphs to simplify the language, as per Acrolinx recommendation.
1 parent 176b205 commit 6385f79

File tree

1 file changed

+14
-14
lines changed

1 file changed

+14
-14
lines changed

docs/ide/developer-community-guidelines.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -27,23 +27,23 @@ If you can't find an existing issue that describes your bug or feature, submit a
2727

2828
### Writing a good bug report or feature suggestion
2929

30-
1. File only one problem or feature request per issue.
30+
- File only one problem or feature request per issue.
3131

32-
1. Combining multiple problems or feature requests into a single issue makes it harder for us to diagnose, and harder for other users to vote for your issue.
33-
2. Don't add your issue as a comment to an existing issue unless it's for the identical input. Many issues look similar but have different causes, which makes it harder for us to diagnose your issue.
32+
- Combining multiple problems or feature requests into a single issue makes it harder for us to diagnose, and harder for other users to vote for your issue.
33+
- Don't add your issue as a comment to an existing issue unless it's for the identical input. Many issues look similar but have different causes, which makes it harder for us to diagnose your issue.
3434

35-
2. The more information you can provide, the easier it will be for us to reproduce and fix your issue.
36-
3. Include the following steps with each issue.
35+
- The more information you can provide, the easier it will be for us to reproduce and fix your issue.
36+
- Include the following steps with each issue.
3737

38-
1. Reproducible steps (1... 2... 3...) and what you expected versus what you experienced.
39-
2. Images, animations, or a link to a video. Images and animations illustrate repro-steps but _don't_ replace them.
40-
3. As appropriate, a code snippet that demonstrates the issue or a link to a code repository we can easily pull down onto our machine to recreate the issue.
38+
- Reproducible steps (1... 2... 3...) and what you expected versus what you experienced.
39+
- Images, animations, or a link to a video. Images and animations illustrate repro-steps but _don't_ replace them.
40+
- As appropriate, a code snippet that demonstrates the issue or a link to a code repository we can easily pull down onto our machine to recreate the issue.
4141

42-
4. Remember to do the following steps:
42+
- Remember to do the following steps:
4343

44-
1. Search to see if there exists a duplicate. If so, vote up the existing issue, providing additional comments or clarifications as needed.
45-
2. Recreate the issue after disabling all extensions. If you find the issue is caused by an extension you've installed, file an issue on the extension respectively.
46-
3. Simplify your code around the issue so we can better isolate the problem.
44+
- Search to see if there exists a duplicate. If so, vote up the existing issue, providing additional comments or clarifications as needed.
45+
- Recreate the issue after disabling all extensions. If you find the issue is caused by an extension you've installed, file an issue on the extension respectively.
46+
- Simplify your code around the issue so we can better isolate the problem.
4747

4848
Even with issues that include rich details, we may be unable to reproduce the issue and may ask for more information!
4949

@@ -57,7 +57,7 @@ When an issue is missing important information, we assign the _Needs More Info_
5757

5858
### Won't fix bugs
5959

60-
We close some bugs if there's a negative cost-benefit balance. For example, if the fix is so complex it risks regressions for many users, fixing may not be a reasonable choice. When we close a bug like this, we'll explain why we do so.
60+
We close some bugs when there's a negative cost-benefit balance. For example, if the fix is so complex it risks regressions for many users, fixing may not be reasonable. When we close a bug like this, we'll explain why we do so.
6161

6262
#### Additional information
6363

@@ -77,7 +77,7 @@ In our decision-making process, we look at the following characteristics about t
7777
- Does it have community support, as indicated by votes and comments?
7878
- Do we love it, even with low community support?
7979

80-
When we can't answer "yes" to any of these questions, we'll close the suggestion. But often the suggestion will stay open as _Under Review_ to gather more community feedback.
80+
When we can't answer "yes" to any of these questions, we'll close it. But often the suggestion will stay open as _Under Review_ to gather more community feedback.
8181

8282
Track the progress of your feature suggestion by referencing the [Suggestion states and FAQ](https://docs.microsoft.com/visualstudio/ide/report-a-problem).
8383

0 commit comments

Comments
 (0)