Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: switch bug template to "expected/actual" behavior #9423

Merged
merged 1 commit into from
Aug 4, 2020

Conversation

rix0rrr
Copy link
Contributor

@rix0rrr rix0rrr commented Aug 4, 2020

Bug reports typically result from a distinction between a user's mental model and actual behavior.

To bring this to the front and center, I like the phrasing:

  • Tell me what you expected to happen
  • Tell me what actually happened

More than the current:

  • Paste code
  • See error

The new phrasing subsumes the old one (what actually happened? I got an error) while also allowing to catch more bug-like scenarios.

Hopefully it will prevent incomplete reports like this: #9270 where the user pasted in the code, didn't get an error so didn't fill out the "error" section, and didn't really state what they expected or saw happen.


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license

Bug reports typically result from a distinction between a user's mental model and actual behavior.

To bring this to the front and center, I like the phrasing:

* Tell me what you expected to happen
* Tell me what actually happened

More than the current:

* Paste code
* See error

The new phrasing subsumes the old one (what actually happened? I got an error) while also allowing to catch more bug-like scenarios.

Hopefully it will prevent incomplete reports like this: #9270 where the user pasted in the code, didn't get an error so didn't fill out the "error" section, and didn't really state what they expected or saw happen.
@rix0rrr rix0rrr requested a review from a team August 4, 2020 08:32
@rix0rrr rix0rrr self-assigned this Aug 4, 2020
@mergify mergify bot added the contribution/core This is a PR that came from AWS. label Aug 4, 2020
@aws-cdk-automation
Copy link
Collaborator

AWS CodeBuild CI Report

  • CodeBuild project: AutoBuildProject6AEA49D1-qxepHUsryhcu
  • Commit ID: 4b59e9f
  • Result: SUCCEEDED
  • Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

Copy link
Contributor

@njlynch njlynch left a comment

Choose a reason for hiding this comment

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

I like it.

@mergify
Copy link
Contributor

mergify bot commented Aug 4, 2020

Thank you for contributing! Your pull request will be updated from master and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

@mergify mergify bot merged commit 406e556 into master Aug 4, 2020
@mergify mergify bot deleted the huijbers/bug-template branch August 4, 2020 10:37
Copy link
Contributor

@eladb eladb left a comment

Choose a reason for hiding this comment

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

Should we align all our repos to this template?

eladb pushed a commit that referenced this pull request Aug 10, 2020
Bug reports typically result from a distinction between a user's mental model and actual behavior.

To bring this to the front and center, I like the phrasing:

* Tell me what you expected to happen
* Tell me what actually happened

More than the current:

* Paste code
* See error

The new phrasing subsumes the old one (what actually happened? I got an error) while also allowing to catch more bug-like scenarios.

Hopefully it will prevent incomplete reports like this: #9270 where the user pasted in the code, didn't get an error so didn't fill out the "error" section, and didn't really state what they expected or saw happen.


----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*
curtiseppel pushed a commit to curtiseppel/aws-cdk that referenced this pull request Aug 11, 2020
Bug reports typically result from a distinction between a user's mental model and actual behavior.

To bring this to the front and center, I like the phrasing:

* Tell me what you expected to happen
* Tell me what actually happened

More than the current:

* Paste code
* See error

The new phrasing subsumes the old one (what actually happened? I got an error) while also allowing to catch more bug-like scenarios.

Hopefully it will prevent incomplete reports like this: aws#9270 where the user pasted in the code, didn't get an error so didn't fill out the "error" section, and didn't really state what they expected or saw happen.


----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
contribution/core This is a PR that came from AWS.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants