core-plans icon indicating copy to clipboard operation
core-plans copied to clipboard

[proposal] Standard PR request format

Open gavindidrichsen opened this issue 4 years ago • 4 comments

@predominant usually submits his PRs in the format below and I'd like to propose that all core-plans PRs be submitted in this fashion. The test method and results are clearly defined and I know right away as a reviewer that (1) tests exists for this plan and (2) the tests have actually been run.

https://github.com/habitat-sh/core-plans/pull/3240#issuecomment-593172970 image

https://github.com/habitat-sh/core-plans/pull/3239#issuecomment-593171950 image

gavindidrichsen avatar Mar 02 '20 10:03 gavindidrichsen

We can add a pull request template to try to encourage this:

https://help.github.com/en/github/building-a-strong-community/creating-a-pull-request-template-for-your-repository

I'm cool with this as long as we are pragmatic about it. I think our goal should be to encourage high-quality commit message rather than adherence to any particular format. So, as long as the commit message or PR description tells us what we need to know, I wouldn't ask contributors to change them.

The test method and results are clearly defined and I know right away as a reviewer that (1) tests exists for this plan and (2) the tests have actually been run.

I think for (1) I'd prefer if some automation commented on the issue and for (2) I think we have our CI system. But, I agree that until we have those things, it is nice to put them in the PR description.

stevendanna avatar Mar 02 '20 10:03 stevendanna

Thanks @stevendanna. I'll put this on my backlog and review with you after the refresh.

gavindidrichsen avatar Mar 02 '20 10:03 gavindidrichsen

@gavindidrichsen are you still keen to look into this?

MindNumbing avatar Aug 03 '20 09:08 MindNumbing

I approve of this message.

predominant avatar Aug 04 '20 00:08 predominant