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

GH-385: Simplify the PR template #406

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

sampoturve
Copy link
Contributor

Ticket

#385

Description

This PR is using the new simpler template 🌿

  • Removed 'Best practices' section for being redundant
  • Add square brackets for all the texts that should be replaced, to make it clearer on what to update
  • This template will still have the MD041/first-line-heading/first-line-h1: First line in a file should be a top-level heading linting error, but IMO it doesn't make any sense to add level 1 heading here just for the sake of it.

One thing I'd still consider removing is the Setting up local environment section, as I think those steps should be added under Testing instructions section, even though the instructions can be used for both local and feature environment testing.

Testing

Feature environment

No feature environment.

Setting up local environment

No local environment setting up required.

Testing instructions

See that the PR template makes sense.

- Removed 'Best practices' section for being redundant
- Add square brackets for all the texts that should be replaced
@tormi
Copy link
Member

tormi commented Apr 23, 2024

What about even simpler approach?

Ticket GH-406

Changes

  • Simplify Drupal project template pull request template

Testing

Environment: https://environment.tld

Checks

  • check if template follows the KISS principle
  • check if headings are sized hierarchically
  • ...

Markdown:

## Ticket GH-406

### Changes

- Simplify Drupal project template pull request template

### Testing

Environment: https://environment.tld

#### Checks

- [ ] check if headings are sized hierarchically
- [ ] check if template follows the [KISS principle](https://en.wikipedia.org/wiki/KISS_principle)
- [ ] ...

@tormi
Copy link
Member

tormi commented Apr 23, 2024

Another template with really important topics:

  • type of change select checks
  • documentation update check
  • testing coverage checks

There's also an interesting feature assignees implemented.

assignees: 'BrianGilbert'
<!--- Provide a general summary of your changes in the title above -->

## Types of changes
<!--- What types of changes does your code introduce? Put an `x` in all the boxes that apply: -->
- [ ] Bug fix (a non-breaking change which fixes an issue)
- [ ] New feature (a non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing functionality to change)


## Description
<!--- Describe your changes in detail -->
<!--- Why is this change required? What problem does it solve? -->
<!--- If it resolves an open issue, please link to the issue here. For example "Resolves: #1337" -->


## Checklist:
<!--- Put an `x` in all the boxes that apply. -->
<!--- If your change requires a documentation PR, please link it appropriately -->
<!--- If you're unsure about any of these, don't hesitate to ask. We're here to help! -->
- [ ] I have updated the documentation accordingly.
- [ ] I have added tests to cover my changes (if not applicable, please state why)
- [ ] All new and existing tests are passing.


## Screenshots/Media:
<!--- Add any screenshots or other type of media to demonstrate your change -->

Source: https://github.com/Realityloop/foundry/blob/develop/.github/PULL_REQUEST_TEMPLATE.md

@sampoturve
Copy link
Contributor Author

sampoturve commented May 2, 2024

Adding the ticket link into the title could be an option, but IMO it's way easier to simply copy-paste the URL under a certain heading instead of needing to do some formatting in the way of ## Ticket [GH-385](https://github.com/wunderio/drupal-project/pull/385). I guess many projects have the auto-linking by ID though, so I could be in the minority.

I maybe wouldn't go with the checklists, as checking and reordering those seem to be global and in cases where there are multiple reviewers, those might bring more confusion than benefit.

The latter example looks quite good though. The HTML comments are a nice touch, but I think those would be mostly useful for someone that isn't that accustomed to creating PRs. Would the comments then be in the way of someone that's more experieced, I don't know. Balancing act, this ⚖️

@Rade333 Rade333 self-requested a review May 24, 2024 07:18
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.

2 participants