Template updates for WSL2 release (#5312)
Ken C committed
Jun 2, 2020 at 10:20 UTC
17788cb4e046be5027ab6ac7694273b8e31daf90
1 file changed
+7
-10
.github/ISSUE_TEMPLATE/bug_report.md
+7
-10
@@ -7,21 +7,18 @@ assignees: ''
7
8
---
9
10
-Please use the following bug reporting template to help produce issues which are actionable and reproducible, including **all** command-line steps necessary to induce the failure condition. Please fill out **all** the fields! Issues with missing or incomplete issue templates will be closed.
10
+Please use the following bug reporting template to help produce issues which are actionable and reproducible, including **all** command-line steps necessary to induce the failure condition. See [our contributing instructions](https://github.com/Microsoft/WSL/blob/master/CONTRIBUTING.md) for more information. If this is a console issue (a problem with layout, rendering, colors, etc.), please post to the [terminal tracker](https://github.com/microsoft/terminal/issues). For documentation improvements, please post to the [documentation tracker](https://github.com/MicrosoftDocs/WSL/issues).
11
12
-If this is a console issue (a problem with layout, rendering, colors, etc.), please post to the [console issue tracker](https://github.com/microsoft/console/issues).
12
+**Important: Do not open GitHub issues for Windows crashes (BSODs) or security issues.** Please direct all Windows crashes and security issues to secure@microsoft.com. Ideally, please [configure your machine to capture minidumps](https://support.microsoft.com/en-us/help/315263/how-to-read-the-small-memory-dump-file-that-is-created-by-windows-if-a), repro the issue, and send the minidump from "C:\Windows\minidump\".
13
+<br/><br/>
14
14
-**Important: Do not open GitHub issues for Windows crashes (BSODs) or security issues.** Please direct all Windows crashes and security issues to secure@microsoft.com. Ideally, please [configure your machine to capture minidumps](https://support.microsoft.com/en-us/help/315263/how-to-read-the-small-memory-dump-file-that-is-created-by-windows-if-a), repro the issue, and send the minidump from "C:\Windows\minidump\".\\
15
+Please fill out **all** the fields! Issues with missing or incomplete issue templates will be closed.
16
16
-See [our contributing instructions](https://github.com/Microsoft/WSL/blob/master/CONTRIBUTING.md) for assistance.
17
+* Your Windows build number (run `ver` at a Windows Command Prompt), your distribution (f.e. on Debian/Ubuntu run `lsb_release -r`), and whether the issue manifests on WSL 2 and/or WSL 1 (`cat /proc/version`):
18
18
-**Please fill out the below information:**
19
-* Your Windows build number: (Type `ver` at a Windows Command Prompt)
20
-
21
-* What you're doing and what's happening: (Copy&paste the full set of _specific_ command-line steps necessary to reproduce the behavior, and their output. Include screen shots if that helps demonstrate the problem.)
19
+* What you're doing and what's happening. Copy&paste the _full_ set of _specific_ command-line steps necessary to reproduce the behavior, and their output. Include screenshots if that helps demonstrate the problem:
20
21
* What's wrong / what should be happening instead:
22
25
-* Strace of the failing command, if applicable: (If `some_command` is failing, then run `strace -o some_command.strace -f some_command some_args`, and link the contents of `some_command.strace` in a [gist](https://gist.github.com/) here).
23
+* An [`strace(1)`](https://www.man7.org/linux/man-pages/man1/strace.1.html) log of the failing command (if `some_command` is failing, then run `strace -o some_command.strace -f some_command some_args`, and link the contents of `some_command.strace` in a [gist](https://gist.github.com/)). For WSL launch issues, please [collect detailed logs](https://github.com/Microsoft/WSL/blob/master/CONTRIBUTING.md#8-detailed-logs):
24
27
-* For WSL launch issues, please [collect detailed logs](https://github.com/Microsoft/WSL/blob/master/CONTRIBUTING.md#8-detailed-logs).