Skip to content

Commit b581d84

Browse files
marcosumaandreaangiolilloAgustinBettati
authored
doc: Updates template issue with clearer guidelines. (#1510)
* Updates template issue with clearer guidelines. * Update .github/ISSUE_TEMPLATE/Bug_Report.md Co-authored-by: Andrea Angiolillo <[email protected]> * Update text. * Update .github/ISSUE_TEMPLATE/Bug_Report.md Co-authored-by: Agustin Bettati <[email protected]> * Update .github/ISSUE_TEMPLATE/Bug_Report.md Co-authored-by: Agustin Bettati <[email protected]> * Update text. --------- Co-authored-by: Andrea Angiolillo <[email protected]> Co-authored-by: Agustin Bettati <[email protected]>
1 parent 17a83f2 commit b581d84

File tree

1 file changed

+32
-15
lines changed

1 file changed

+32
-15
lines changed

.github/ISSUE_TEMPLATE/Bug_Report.md

Lines changed: 32 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,28 @@ about: Something unexpected happen? Report an error, crash, or an incorrect beha
66

77
Hello!
88

9-
Thank you for opening an issue. Please note that we try to keep the Terraform MongoDB Atlas Provider issue tracker reserved for bug reports. Please ensure you check open and closed issues first to ensure your issue hasn't already been reported (if it has been reported add a reaction, i.e. +1, to the issue).
9+
Thank you for opening an issue. **These GitHub issues** are only for community reporting and assistance; as such, we don't have a guaranteed SLA.
1010

11-
If your issue relates to Terraform itself, please open it in the Terraform repository https://github.com/hashicorp/terraform/issues.
11+
**If your issue relates to Terraform itself**, please open it in the Terraform repository https://github.com/hashicorp/terraform/issues.
1212

13-
If you have an active MongoDB Atlas Support contract, the best way for us to assist you with the Terraform MongoDB Atlas Provider is through a [support ticket](https://support.mongodb.com/).
13+
**If you have an active MongoDB Atlas Support contract**, the best way for us to assist you with the Terraform MongoDB Atlas Provider is through a [support ticket](https://support.mongodb.com/).
14+
15+
**Please note:** In order for us to provide the best experience in supporting our customers, we kindly ask to make sure that all the following sections are correctly filled with all the required information. Our support will **prioritise** issues that contain **all the required** information that follows the **"one-click reproducible issues" principle** (see below).
16+
17+
**Please also note:** We try to keep the Terraform MongoDB Atlas Provider issue tracker **reserved for bug reports**. Please ensure you **check open and closed issues first** to ensure your issue hasn't already been reported (if it has been reported add a reaction, i.e. +1, to the issue).
18+
19+
### "One-click reproducible issues" principle
20+
21+
* We should be able to make no changes to your provided script and **successfully run a local execution reproducing the issue**.
22+
* This means that you should kindly **provide all the required instructions**. This includes but not limited to:
23+
* Terraform Atlas provider version used to reproduce the issue
24+
* Terraform version used to reproduce the issue
25+
* Configurations that **cannot be properly executed will be de-prioritised** in favour of the ones that succeed.
26+
* Before opening an issue, you have to try to specifically isolate it to **Terraform MongoDB Atlas** provider by **removing as many dependencies** as possible. If the issue only happens with other dependencies, then:
27+
* If other terraform providers are required, please make sure you also include those. _Same "one-click reproducible issue" principle applies_.
28+
* If external components are required to replicate it, please make sure you also provides instructions on those parts.
29+
* Please confirm if the platform being used is Terraform OSS, Terraform Cloud, or Terraform Enterprise deployment
1430

15-
Repository issues are only for community reporting and assistance.
16-
-->
1731

1832
### Terraform CLI and Terraform MongoDB Atlas Provider Version
1933
<!---
@@ -23,26 +37,29 @@ If you are not running the latest version of Terraform and the MongoDB Atlas Pro
2337
-->
2438

2539
```hcl
26-
# Copy-paste your version info here
40+
# Copy-paste your version.tf and provider.tf (or equivalent) here
2741
```
2842

2943
### Terraform Configuration File
3044
<!--
31-
Paste the relevant parts of your Terraform MongoDB Atlas Provider configuration file info between the ``` marks below or consider creating a GitHub Gist with the information and share it here.
45+
Paste here all the required parts of your Terraform MongoDB Atlas Provider configuration file below. You can alternatively consider creating a [**GitHub Gist**](https://gist.github.com/) with the information and share it here.
3246
33-
Please be sure to redact any sensitive information; common examples include API Keys, passwords, other secrets, or any items your project/business may consider sensitive such as hostnames or usernames.
47+
Share your configuration by **using variables**. Create a `variables.tf` file and share its content. Please be sure to redact any sensitive information; common examples include API Keys, passwords, other secrets, or any items your project/business may consider sensitive such as hostnames or usernames.
3448
-->
3549

3650
```hcl
37-
# Copy-paste your configuration info here
51+
# Copy-paste all your configuration (e.g. main.tf and variable.tf) info here
3852
```
3953

4054
### Steps to Reproduce
41-
<!--
42-
Please list the full steps required to reproduce the issue, for example:
43-
1. `terraform init`
44-
2. `terraform apply`
45-
-->
55+
56+
Please be **as detailed as possible.**
57+
* If the issue **involves version changes** (e.g. `run plan with version 1.k.x then re-run with version 1.k.y`), please make sure you report the detailed sequence on commands to execute.
58+
* If the issue requires **changes from the UI**, please document them **preferably with screenshots**.
59+
60+
```hcl
61+
# Write here the detailed list of required steps.
62+
```
4663

4764
### Expected Behavior
4865
<!--
@@ -56,7 +73,7 @@ What actually happened?
5673

5774
### Debug Output
5875
<!--
59-
Note: Debug output can be incredibly helpful in narrowing down an issue but is not required.
76+
Note: Debug output can be incredibly helpful in narrowing down an issue.
6077
6178
Full debug output can be obtained by running Terraform with the environment variable `TF_LOG=trace`. Please create either a GitHub Gist or attach a file containing the debug output. Please do _not_ paste the debug output in the issue, since debug output can be very long.
6279

0 commit comments

Comments
 (0)