Skip to content

Commit

Permalink
Add bug template to CONTRIBUTING.md
Browse files Browse the repository at this point in the history
We've been getting bug reports which don't include good repro steps.  Unfortunately GitHub doesn't seem to give the ability to give a predefined template for issue reports, which is a real shame, since having a predefined template really helps improve the quality of reports.

As a partial step in that direction we can at least add something to CONTRIBUTING.md to explain what we expect minimally.

closes fsharp#75
  • Loading branch information
dsyme authored and latkin committed Jan 21, 2015
1 parent 492c1af commit a932a13
Showing 1 changed file with 30 additions and 1 deletion.
31 changes: 30 additions & 1 deletion CONTRIBUTING.md
Expand Up @@ -27,6 +27,36 @@ We initially solicit contributions for

New features are welcome, but be aware that Visual F# is a high-quality programming language with high-quality tools, and we wish to keep it that way. Before embarking on an extensive feature implementation, make a proposal in a GitHub issue or on the [F# Language UserVoice](https://fslang.uservoice.com/) so the community can review and comment on it.

### Issues

When submitting issues, please use the following guidelines

- Suggestions for the F# Language and Core library should be added and reviewed at the [F# Language User Voice](https://fslang.uservoice.com/).

- Suggestions for the Visual F# Tools should be added and reviewed at the [Visual Studio F# Tools User Voice](https://visualstudio.uservoice.com/forums/121579-visual-studio/category/30935-languages-f-tools).

- New Bug Reports should always give accurate, clear steps for reproducing the bug, and all relevant details about versions, platform, etc. We suggest the following template:

Title: <a short, clear title>

Description: <a description of the problem>

Repro Steps: <step by step description>

Expected: <what is expected>

Actual: <what you really get>

Severity: a description on how bad it is and why - is it blocking?

Version: Language, compiler, library, platform version

Link: Give a link to a ZIP, log files or other files if needed

Likely Cause: Link to the place in the code where things are likely going wrong, if possible

Workaround: List any known workarounds

###CLA

Contributors are required to sign a [Contribution License Agreement](https://cla.msopentech.com/) (CLA) before any pull requests will be considered. After submitting a request via the provided form, electronically sign the CLA when you receive the email containing the link to the document. This only needs to be done once for each Microsoft OSS project you contribute to.
Expand Down Expand Up @@ -66,7 +96,6 @@ Bug fix PRs have the following minimum requirements
- The code changes must be reasonably minimal and as low-churn, non-intrusive as possible. Cleanup should be done in separate PRs where possible (see above), and fixes should be as small as possible.
- Thorough test cases must be included in the PR (unless tests already exist for a failing case). PRs without matching tests will be closed with a polite request to please add the tests. However, if you need help adding tests, please note this in the description of the change and people will guide you through where to add the tests.


###Language Evolution

We are committed to carefully managing the evolution of the F# language.
Expand Down

0 comments on commit a932a13

Please sign in to comment.