Skip to content

Commit 13a34af

Browse files
committed
Added Guidelines for GitHub issues
1 parent 564a5e1 commit 13a34af

File tree

1 file changed

+31
-3
lines changed

1 file changed

+31
-3
lines changed

README.md

+31-3
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Windows Server Documentation
22

3-
Welcome to the open source documentation of Microsoft Windows Server. Contributing to open source is more than just providing updates, it's also letting us know when there is an issue.
3+
Welcome to the open source documentation of Microsoft Windows Server. Contributing to open source is more than just providing updates, it's also letting us know when there's an issue.
44

55
## Public vs. private repo contributions
66

@@ -23,14 +23,42 @@ These repos are actively managed and contain the source for Windows Server techn
2323
- [Windows Server home page](https://learn.microsoft.com/windows-server/)
2424
- [Windows Server Essentials](https://learn.microsoft.com/windows-server-essentials)
2525

26+
## GitHub content feedback guidelines
27+
28+
As the Windows Server repo in GitHub is only monitored for content issues, users can help in contributing by reporting documentation issues. Select the "**This page**" button under the **Feedback** section of the page to generate a GitHub issue where feedback can be provided concerning a documentation issue. Suggestions for improvement are welcomed and specific updates to our content are under consideration.
29+
30+
A best practice in providing valuable feedback is to capture the issue directly by quoting where the issue is found within the document. The following list provides insight to issues that are addressable:
31+
32+
- Incorrect spelling, typos or duplicate text in the documentation.
33+
- Broken, outdated or incorrectly referenced hyperlinks to our content.
34+
- The step-by-step directions provided don't match the product, steps are missing or are outdated.
35+
- Incorrect code, missing parameters, or improper examples of command line usage or PowerShell cmdlets.
36+
37+
There are cases where the given feedback is outside the scope of what can be addressed as the issue pertains to the product or service rather than the documentation itself. For reference:
38+
39+
- Technical support for specific or case-based scenarios where troubleshooting is involved.
40+
- Fixing a software bug, application feature requests, or experiencing product performance issues.
41+
- Dislike of a product GUI change or removal of a product feature.
42+
- Other issues that don't relate to the actual content.
43+
44+
We offer other channels for engaging with us whether you have a support question, want to provide product feedback, or other suggestions. Use one or more of these channels:
45+
46+
- Open a ticket with [Microsoft Support](https://support.microsoft.com/ContactUs).
47+
- You can submit feedback by visiting our [Feedback portal](https://learn.microsoft.com/microsoft-365/admin/misc/feedback-provide-microsoft?view=o365-worldwide).
48+
- To submit a bug or a feature request, use our [Windows Feedback Hub](https://aka.ms/WIPFeedbackHub) or press <kbd>**Windows key + F**</kbd>.
49+
- You can also search and engage within our community forums:
50+
- [Microsoft TechNet](https://social.technet.microsoft.com/Forums/home).
51+
- [Microsoft Developer Network](https://social.msdn.microsoft.com/Forums/home).
52+
- [Microsoft Support Community](https://answers.microsoft.com/).
53+
2654
## Markdown info
2755

2856
For information on using Markdown in Microsoft technical articles, see the [Docs Markdown reference](https://learn.microsoft.com/contribute/markdown-reference).
2957

3058
## License
3159

32-
Please refer to [LICENSE](https://github.com/MicrosoftDocs/windowsserverdocs-pr/blob/master/LICENSE), [LICENSE-CODE](https://github.com/MicrosoftDocs/windowsserverdocs-pr/blob/master/LICENSE-CODE) and [ThirdPartyNotices](https://github.com/MicrosoftDocs/windowsserverdocs-pr/blob/master/ThirdPartyNotices) for all Licensing information.
60+
Refer to [LICENSE](https://github.com/MicrosoftDocs/windowsserverdocs-pr/blob/master/LICENSE), [LICENSE-CODE](https://github.com/MicrosoftDocs/windowsserverdocs-pr/blob/master/LICENSE-CODE) and [ThirdPartyNotices](https://github.com/MicrosoftDocs/windowsserverdocs-pr/blob/master/ThirdPartyNotices) for all Licensing information.
3361

3462
## Code of Conduct
3563

36-
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
64+
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information, see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [[email protected]](mailto:[email protected]) with any additional questions or comments.

0 commit comments

Comments
 (0)