Merge pull request #2671 from fitzgen/issue-templates

Clean up our github issue templates

.github/ISSUE_TEMPLATE/clif-bug-report.md

@@ -1,5 +1,5 @@
 ---
-name: Cranelift Bug report
+name: Cranelift Bug Report
 about: Report a bug or a crash in Cranelift.
 title: 'Cranelift: '
 labels: bug, cranelift
@@ -7,13 +7,37 @@ assignees: ''
 
 ---
 
-Thanks for opening a bug report! Please answer the questions below
+Thanks for filing an issue! Please fill out the TODOs below.
-if they're relevant and delete this text before submitting.
 
-- What are the steps to reproduce the issue? Can you include a CLIF test case,
+### `.clif` Test Case
-  ideally reduced with the `bugpoint` clif-util command?
+
-- What do you expect to happen? What does actually happen? Does it panic, and
+```
-  if so, with which assertion?
+TODO: paste .clif test case here. Ideally, a test case that has been reduced via
-- Which Cranelift version / commit hash / branch are you using?
+the `clif-util bugpoint` command.
-- If relevant, can you include some extra information about your environment?
+```
-  (Rust version, operating system, architecture...)
+
+### Steps to Reproduce
+
+* TODO: First, ...
+* TODO: Then, ...
+* Etc...
+
+### Expected Results
+
+TODO: What do you expect to happen?
+
+### Actual Results
+
+TODO: What actually happens? Panic? Segfault? Incorrect result?
+
+### Versions and Environment
+
+Cranelift version or commit: TODO
+
+Operating system: TODO
+
+Architecture: TODO
+
+### Extra Info
+
+Anything else you'd like to add?

.github/ISSUE_TEMPLATE/improvement.md

@@ -7,26 +7,25 @@ assignees: ''
 
 ---
 
-<!-- Please try to describe precisely what you would like to do in
+Thanks for filing a feature request! Please fill out the TODOs below.
-Cranelift/Wasmtime and/or expect from it. You can answer the questions below if
-they're relevant and delete this text before submitting. Thanks for opening an
-issue! -->
 
 #### Feature
 
-<!-- What is the feature or code improvement you would like to do in
+TODO: Brief description of the feature/improvement you'd like to see in
-Cranelift/Wasmtime? -->
+Cranelift/Wasmtime.
 
 #### Benefit
 
-<!-- What is the value of adding this in Cranelift/Wasmtime? -->
+TODO: What is the value of adding this in Cranelift/Wasmtime? What problems does
+it solve?
 
 #### Implementation
 
-<!-- Do you have an implementation plan, and/or ideas for data structures or
+TODO: Do you have an implementation plan, and/or ideas for data structures or
-algorithms to use? -->
+algorithms to use?
 
 #### Alternatives
 
-<!-- Have you considered alternative implementations? If so, how are they
+TODO: What are the alternative implementation approaches or alternative ways to
-better or worse than your proposal? -->
+solve the problem that this feature would solve? How do these alternatives
+compare to this proposal?

.github/ISSUE_TEMPLATE/wasmtime-bug-report.md

@@ -1,5 +1,5 @@
 ---
-name: Wasmtime bug report
+name: Wasmtime Bug Report
 about: Report a bug or a crash in Wasmtime
 title: ''
 labels: bug
@@ -7,12 +7,34 @@ assignees: ''
 
 ---
 
-Thanks for opening a bug report! Please answer the questions below
+Thanks for filing a bug report! Please fill out the TODOs below.
-if they're relevant and delete this text before submitting.
 
-- What are the steps to reproduce the issue?
+### Test Case
-- What do you expect to happen? What does actually happen? Does it panic, and
+
-  if so, with which assertion?
+TODO: upload Wasm file here
-- Which Wasmtime version / commit hash / branch are you using?
+
-- If relevant, can you include some extra information about your environment?
+### Steps to Reproduce
-  (Rust version, operating system, architecture...)
+
+* TODO: first, ...
+* TODO: second, ...
+* Etc...
+
+### Expected Results
+
+TODO: What do you expect to happen?
+
+### Actual Results
+
+TODO: What actually happens? Panic? Segfault? Incorrect result?
+
+### Versions and Environment
+
+Wasmtime version or commit: TODO
+
+Operating system: TODO
+
+Architecture: TODO
+
+### Extra Info
+
+Anything else you'd like to add?