豆豆友情提示：这是一个非官方 GitHub 代理镜像，主要用于网络测试或访问加速。请勿在此进行登录、注册或处理任何敏感信息。进行这些操作请务必访问官方网站 github.com。 Raw 内容也通过此代理提供。
Skip to content

chore: Updates the bug report template#26375

Merged
michael-s-molina merged 3 commits intoapache:masterfrom
michael-s-molina:change-bug-report-template
Jan 18, 2024
Merged

chore: Updates the bug report template#26375
michael-s-molina merged 3 commits intoapache:masterfrom
michael-s-molina:change-bug-report-template

Conversation

@michael-s-molina
Copy link
Copy Markdown
Member

@michael-s-molina michael-s-molina commented Dec 28, 2023 •
edited
Loading

SUMMARY

This PR changes the bug report template to make it clearer which versions are officially supported and remove unnecessary sections to simplify the reporting process. Specifically:

  • It converts the issue template to an issue form
  • It changes the Environment section from free form input to a set of dropdowns with predefined options
  • It adds instructions to upgrade to the officially supported environment versions when necessary
  • It removes the Expected/Actual sections as these are generally present in the bug description or can be easily deduced from it.
  • It adds instructions to update the bug template when releasing new versions.

TESTING INSTRUCTIONS

Check GitHub's syntax for issue forms.

ADDITIONAL INFORMATION

  • Has associated issue:
  • Required feature flags:
  • Changes UI
  • Includes DB Migration (follow approval process in SIP-59)
    • Migration is atomic, supports rollback & is backwards-compatible
    • Confirm DB migration upgrade and downgrade tested
    • Runtime estimates and downtime expectations provided
  • Introduces new feature or API
  • Removes existing feature or API

@michael-s-molina michael-s-molina force-pushed the change-bug-report-template branch from 36c2bf0 to f761e59 Compare December 28, 2023 14:12
@pull-request-size pull-request-size bot added size/L and removed size/M labels Dec 28, 2023
@michael-s-molina michael-s-molina force-pushed the change-bug-report-template branch 3 times, most recently from de35e3b to 960fc75 Compare December 28, 2023 14:26
@michael-s-molina michael-s-molina force-pushed the change-bug-report-template branch from 960fc75 to 502a4e0 Compare December 28, 2023 14:36
sfirke
sfirke reviewed Dec 28, 2023
View reviewed changes
Copy link
Copy Markdown
Member

@sfirke sfirke left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This will be such a nice improvement! I expect it will pay big dividends in saving developer time.

I put in a few suggestions, most of all I would suggest we offer people links to other places to put their post if it is not actually a bug report.

Comment thread .github/ISSUE_TEMPLATE/bug-report.yml Outdated
Comment thread .github/ISSUE_TEMPLATE/bug-report.yml
3. Scroll down to '....'
4. See error
validations:
required: true
Copy link
Copy Markdown
Member

@sfirke sfirke Dec 28, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In case any other reviewers are wondering, the default is false. So in sections w/o this, they're not required.

Comment thread .github/ISSUE_TEMPLATE/bug-report.yml
Comment thread .github/ISSUE_TEMPLATE/bug-report.yml Outdated
Comment thread .github/ISSUE_TEMPLATE/bug-report.yml
Comment thread .github/ISSUE_TEMPLATE/bug-report.yml Outdated
Comment thread .github/ISSUE_TEMPLATE/bug-report.yml Outdated
Comment thread .github/ISSUE_TEMPLATE/bug-report.yml Outdated
@sfirke
Copy link
Copy Markdown
Member

sfirke commented Dec 28, 2023

Re: testing this, I looked at the GitHub syntax form and everything looked good to me but I didn't create a new repo to actually put this into practice, or run it through a linter. If anything is broken it could be quickly hot-fixed.

@michael-s-molina michael-s-molina force-pushed the change-bug-report-template branch from 58237d4 to 89a36a1 Compare December 29, 2023 12:40
@michael-s-molina
Copy link
Copy Markdown
Member Author

michael-s-molina commented Dec 29, 2023 •
edited
Loading

Re: testing this, I looked at the GitHub syntax form and everything looked good to me but I didn't create a new repo to actually put this into practice, or run it through a linter. If anything is broken it could be quickly hot-fixed.

@sfirke When reviewing the file changes, you can click on the 3 dots and select View file. It will render but it's not 100% accurate. For example, the fields will expand to occupy the available width. You can see an example here.

john-bodley
john-bodley reviewed Dec 29, 2023
View reviewed changes
Comment thread RELEASING/README.md Outdated
sfirke
sfirke approved these changes Jan 3, 2024
View reviewed changes
Copy link
Copy Markdown
Member

@sfirke sfirke left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

@sfirke
Copy link
Copy Markdown
Member

sfirke commented Jan 3, 2024

I looked at it in the preview mode you described, it looks ready to merge to me.

@michael-s-molina michael-s-molina marked this pull request as ready for review January 5, 2024 18:55
@michael-s-molina michael-s-molina added the hold! On hold label Jan 5, 2024
rusackas
rusackas approved these changes Jan 10, 2024
View reviewed changes
Copy link
Copy Markdown
Member

@rusackas rusackas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

love it!

@michael-s-molina michael-s-molina merged commit 591f266 into apache:master Jan 18, 2024
Muhammed-baban pushed a commit to intellica-tech/reporting-tool that referenced this pull request Jan 19, 2024
@michael-s-molina @Muhammed-baban
chore: Updates the bug report template (apache#26375)
860389b
@mistercrunch mistercrunch added 🏷️ bot A label used by `supersetbot` to keep track of which PR where auto-tagged with release labels 🚢 4.0.0 First shipped in 4.0.0 labels Apr 17, 2024
vinothkumar66 pushed a commit to vinothkumar66/superset that referenced this pull request Nov 11, 2024
@michael-s-molina
chore: Updates the bug report template (apache#26375)
1288fd2
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@rusackas rusackas rusackas approved these changes

@sfirke sfirke sfirke approved these changes

@john-bodley john-bodley Awaiting requested review from john-bodley

@villebro villebro Awaiting requested review from villebro villebro is a code owner

@geido geido Awaiting requested review from geido geido is a code owner

@eschutho eschutho Awaiting requested review from eschutho eschutho is a code owner

@betodealmeida betodealmeida Awaiting requested review from betodealmeida betodealmeida is a code owner

@nytai nytai Awaiting requested review from nytai nytai is a code owner

@mistercrunch mistercrunch Awaiting requested review from mistercrunch mistercrunch is a code owner

@craig-rueda craig-rueda Awaiting requested review from craig-rueda craig-rueda is a code owner

@kgabryje kgabryje Awaiting requested review from kgabryje kgabryje is a code owner

Assignees

No one assigned

Labels

🏷️ bot A label used by `supersetbot` to keep track of which PR where auto-tagged with release labels hold! On hold size/L 🚢 4.0.0 First shipped in 4.0.0

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@michael-s-molina @sfirke @rusackas @john-bodley @mistercrunch