Shuffle a part of issue reporting in CONTRIBUTING

This commit is contained in:
Dale Wijnand 2018-04-25 14:30:33 +01:00
parent 701eda668b
commit d7f66b0c00
No known key found for this signature in database
GPG Key ID: 4F256E3D151DF5EF
1 changed files with 3 additions and 1 deletions

View File

@ -66,9 +66,11 @@ Documentation fixes and contributions are as much welcome as to patching the cor
The developers need three things from you: **steps**, **problems**, and **expectations**. The developers need three things from you: **steps**, **problems**, and **expectations**.
The most important thing to remember about bug reporting is to clearly distinguish facts and opinions.
#### Steps #### Steps
The most important thing to remember about bug reporting is to clearly distinguish facts and opinions. What we need first is **the exact steps to reproduce your problems on our computers**. This is called *reproduction steps*, which is often shortened to "repro steps" or "steps." Describe your method of running sbt. Provide `build.sbt` that caused the problem and the version of sbt or Scala that was used. Provide sample Scala code if it's to do with incremental compilation. If possible, minimize the problem to reduce non-essential factors. What we need first is **the exact steps to reproduce your problems on our computers**. This is called *reproduction steps*, which is often shortened to "repro steps" or "steps." Describe your method of running sbt. Provide `build.sbt` that caused the problem and the version of sbt or Scala that was used. Provide sample Scala code if it's to do with incremental compilation. If possible, minimize the problem to reduce non-essential factors.
Repro steps are the most important part of a bug report. If we cannot reproduce the problem in one way or the other, the problem can't be fixed. Telling us the error messages is not enough. Repro steps are the most important part of a bug report. If we cannot reproduce the problem in one way or the other, the problem can't be fixed. Telling us the error messages is not enough.