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

Updated PR template #3619

Merged
merged 3 commits into from
Jan 25, 2022
Merged

Updated PR template #3619

merged 3 commits into from
Jan 25, 2022

Conversation

szalpal
Copy link
Member

@szalpal szalpal commented Jan 13, 2022

Signed-off-by: szalpal mszolucha@nvidia.com

Category:

Other (e.g. Documentation, Tests, Configuration)

Description:

This PR updates the PR template. The main point is that the "What happened in this PR" section will be on top, so we instantly see the details about the PR. On the other hand, "Description" section belongs more to a "Checklist" (since we check things there), thus it's moved there.

Additional information:

Affected modules and functionalities:

.github

Key points relevant for the review:

To see, how the new PR template looks, please go to the rendered file.

Checklist

Tests

  • Existing tests apply
  • New tests added
    • Python tests
    • GTests
    • Benchmark
    • Other
  • N/A

Documentation

  • Existing documentation applies
  • Documentation updated
    • Docstring
    • Doxygen
    • RST
    • Jupyter
    • Other
  • N/A

DALI team only

Requirements

  • Implements new requirements
  • Affects existing requirements
  • N/A

REQ IDs: N/A

JIRA TASK: N/A

Signed-off-by: szalpal <mszolucha@nvidia.com>
Comment on lines +24 to 25
### Affected modules and functionalities:
<!--- Describe here what was changed, added, removed. --->
Copy link
Contributor

@mzient mzient Jan 13, 2022

Choose a reason for hiding this comment

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

I think these two points should remain below the first section with the checkboxes.

What happened in this PR

< description goes here >

Category

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to not work as expected)
  • Refactoring (Redesign of existing code that doesn't affect functionality)
  • Other (e.g. Documentation, Tests, Configuration)

Additional information

Affected modules and functionalities:

Key points relevant for the review:

Checklist

...

Copy link
Collaborator

Choose a reason for hiding this comment

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

I agree

Signed-off-by: szalpal <mszolucha@nvidia.com>

### What happened in this PR
## This PR is a:
Copy link
Contributor

Choose a reason for hiding this comment

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

Might be personal preference, but I like Category better. "This PR is a " is a bit misleading to me.

Copy link
Member Author

Choose a reason for hiding this comment

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

I wanted to fit in the general feeling in this template - This PR is a: fits more with What happened in this PR. If we'd use Category, we'd be better with Description instead of What happened in this PR

Copy link
Contributor

Choose a reason for hiding this comment

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

I would prefer a checklist as well.

Copy link
Contributor

Choose a reason for hiding this comment

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

image
It reads a bit weird in my opinion. That's why I think "Category" works better

Copy link
Contributor

Choose a reason for hiding this comment

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

BTW, I think that "Description" would be great for the second part.

Copy link
Member Author

Choose a reason for hiding this comment

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

Went for Category and Description.

Comment on lines 13 to 14
<!--- Please pick one from below. Just uncomment what fits most. --->
<!--- **Bug fix** (*non-breaking change which fixes an issue*) --->
Copy link
Contributor

Choose a reason for hiding this comment

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

Please no.
First, it does not say how to uncomment.
Second, to uncomment I need to remove manually both ends of the comment marker. It seems like it will be cumbersome on the day to day basis.

Copy link
Contributor

Choose a reason for hiding this comment

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

+1 on uncommenting being cumbersome - copy-paste would be easier.

Copy link
Member Author

Choose a reason for hiding this comment

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

I would assume, that if you are contributing to DALI, you do know how to uncomment this piece of code ;)

And for the latter - I believe that comparing to the effort we should put in the PR descriptions (looking into one of @hugo213 's PRs: #3604... these are really impressing), removing 6 characters is really nothing.

Copy link
Contributor

@jantonguirao jantonguirao Jan 18, 2022

Choose a reason for hiding this comment

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

Maybe instead of saying "uncomment" just leave the "Please pick one from below" and then one can copy-paste or uncomment depending on what's easier

Copy link
Member Author

Choose a reason for hiding this comment

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

Done

Signed-off-by: szalpal <mszolucha@nvidia.com>
@szalpal szalpal merged commit b95478f into NVIDIA:main Jan 25, 2022
cyyever pushed a commit to cyyever/DALI that referenced this pull request Feb 21, 2022
* Moving categories around

Signed-off-by: szalpal <mszolucha@nvidia.com>
cyyever pushed a commit to cyyever/DALI that referenced this pull request May 13, 2022
* Moving categories around

Signed-off-by: szalpal <mszolucha@nvidia.com>
cyyever pushed a commit to cyyever/DALI that referenced this pull request Jun 7, 2022
* Moving categories around

Signed-off-by: szalpal <mszolucha@nvidia.com>
@szalpal szalpal deleted the pr_template branch February 9, 2024 00:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

6 participants