Skip to content

Fix issue template - simplified version #6728

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

Merged
merged 5 commits into from
May 7, 2018

Conversation

0xc0170
Copy link
Contributor

@0xc0170 0xc0170 commented Apr 24, 2018

Description

Cherry-picked from @sg in #6687. Plus updated to match the PR type description.

Pull request type

[X] Fix
[ ] Refactor
[ ] New target
[ ] Feature
[ ] Breaking change

sg- and others added 2 commits April 24, 2018 12:32
Lots of issues filed didnt take the time to remove the boilerplate
text and give the details needed. This format mimics the update to
pull requests but inverts type and description.
Add same notes about the list of available issue types
- What toolchain is being used?
- What is the SHA of Mbed OS (git log -n1 --oneline)?
- Steps to reproduce (Did you publish code or a test case that exhibits the problem)
-->
### Description
Copy link
Contributor

Choose a reason for hiding this comment

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

For consistency with the PR template, Description should come first at the top ?

Copy link
Contributor

Choose a reason for hiding this comment

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

I think I'm actually fine as-is. Issues tend to need a lot more detail than PRs. Knowing the type of issue before the description helps frame the mindset before reading the description.

Who knows, maybe the PR template could be modified to have the type come before the description?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Open for suggestions, could also move PR type first.

Copy link
Contributor

Choose a reason for hiding this comment

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

I'm not really seeing an issue with the original template, or a need to align particularly. PRs and issues are different things. Maybe change some things to checkboxes for a stylistic alignment, but structually this has always seemed fine to me.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Lot of people ignore it (either remove it or provide default values). Similar what we experienced with PR template.

cmonr
cmonr previously approved these changes Apr 24, 2018
Copy link
Contributor

@cmonr cmonr left a comment

Choose a reason for hiding this comment

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

👍

@0xc0170
Copy link
Contributor Author

0xc0170 commented Apr 25, 2018

I would like to have this resolved asap to start using simplified template in the issues.

@AnotherButler Please review

@0xc0170 0xc0170 requested a review from AnotherButler April 25, 2018 08:50
@0xc0170 0xc0170 changed the title Fix issue template Fix issue template - simplified version Apr 25, 2018
adbridge
adbridge previously approved these changes Apr 26, 2018
@0xc0170
Copy link
Contributor Author

0xc0170 commented Apr 27, 2018

/morph build

@mbed-ci
Copy link

mbed-ci commented Apr 27, 2018

Build : SUCCESS

Build number : 1871
Build artifacts/logs : http://mbed-os.s3-website-eu-west-1.amazonaws.com/?prefix=builds/6728/

Triggering tests

/morph test
/morph uvisor-test
/morph export-build
/morph mbed2-build

@mbed-ci
Copy link

mbed-ci commented Apr 27, 2018

@mbed-ci
Copy link

mbed-ci commented Apr 27, 2018

@adbridge
Copy link
Contributor

@AnotherButler Please review

Make minor copy edits for grammar.
@AnotherButler AnotherButler dismissed stale reviews from adbridge and cmonr via e7a082f April 30, 2018 18:47
@0xc0170
Copy link
Contributor Author

0xc0170 commented May 2, 2018

It was updated, time to review again !

- What toolchain are you using?
- What is the SHA of Mbed OS (git log -n1 --oneline)?
- Steps to reproduce. (Did you publish code or a test case that exhibits the problem?)
-->
### Description
Copy link
Contributor

Choose a reason for hiding this comment

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

Nit: I would put description at the top, otherwise most people just delete the whole thing thinking it's just going to get in the way.

A lot of tools, like the auto-pr-thingy, just concatenate the description smack dab on top of the template.

@0xc0170
Copy link
Contributor Author

0xc0170 commented May 3, 2018

@geky @adbridge Updated based on the feedback, now it equal to PR template as well

Copy link
Contributor

@adbridge adbridge left a comment

Choose a reason for hiding this comment

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

Minor tweak suggested

Good example: https://os.mbed.com/docs/latest/reference/workflow.html
Things to consider sharing:
- What target does this relate to?
- What toolchain are you using?
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe tweak to say:

  • What tools and their versions are being used?
  • Which compiler and version?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Updated via a new commit

Copy link
Contributor

@adbridge adbridge left a comment

Choose a reason for hiding this comment

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

LGTM

@0xc0170
Copy link
Contributor Author

0xc0170 commented May 3, 2018

/morph build

@mbed-ci
Copy link

mbed-ci commented May 3, 2018

Build : SUCCESS

Build number : 1900
Build artifacts/logs : http://mbed-os.s3-website-eu-west-1.amazonaws.com/?prefix=builds/6728/

Triggering tests

/morph test
/morph uvisor-test
/morph export-build
/morph mbed2-build

@mbed-ci
Copy link

mbed-ci commented May 3, 2018

@mbed-ci
Copy link

mbed-ci commented May 3, 2018

@cmonr cmonr merged commit 6ab4091 into ARMmbed:master May 7, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants