Skip to content

meta: Close comment in PR template #40808

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 2 commits into from
Aug 21, 2025
Merged

meta: Close comment in PR template #40808

merged 2 commits into from
Aug 21, 2025

Conversation

tomayac
Copy link
Contributor

@tomayac tomayac commented Aug 20, 2025

No description provided.

@tomayac tomayac requested a review from a team as a code owner August 20, 2025 09:56
@github-actions github-actions bot added system [PR only] Infrastructure and configuration for the project size/xs [PR only] 0-5 LoC changed labels Aug 20, 2025
@@ -1,4 +1,4 @@
<!-- 🙌 Thanks for contributing to MDN Web Docs. 🙌
<!-- 🙌 Thanks for contributing to MDN Web Docs. 🙌 -->

Add details below to help us review your pull request (PR).
Explain your changes and link to a related issue or pull request.
Copy link
Member

Choose a reason for hiding this comment

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

It's closed on L5 though, you can check here where it's un-modified: https://redirect.github.com/mdn/content/pull/40760

Would it be clearer if each line had open/close comment tags?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Would it be clearer if each line had open/close comment tags?

100%. And as is, it results in an empty overall GitHub comment.

Copy link
Member

@Josh-Cena Josh-Cena Aug 20, 2025

Choose a reason for hiding this comment

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

Sorry I don't understand. What empty comment? If you post this template as-is you still see the headings because they are not inside any MD comment.

Also strong -1 to changing anything; adding comment markers to every line makes the explanation even harder to read.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

This is what my brain did:

"Ah, comment on line 1, and placeholder explanation text on the following lines, let's get rid of it."

Screenshot 2025-08-20 at 13 38 33

After that, you end up with the unclosed comment.

Copy link
Member

Choose a reason for hiding this comment

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

How about we add line breaks around the comment markers so it's more salient that they are multiline?

<!--
Blah blah

Blah blah
-->

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I have updated the PR to do that in 9846c42.

@github-actions github-actions bot added size/s [PR only] 6-50 LoC changed and removed size/xs [PR only] 0-5 LoC changed labels Aug 20, 2025
Copy link
Member

@bsmth bsmth left a comment

Choose a reason for hiding this comment

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

LGTM, thanks! @Josh-Cena any other comments?

@Josh-Cena
Copy link
Member

I'm good with this

@bsmth bsmth merged commit 5362d9e into mdn:main Aug 21, 2025
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
size/s [PR only] 6-50 LoC changed system [PR only] Infrastructure and configuration for the project
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants