Skip to content

Docs: add PR template and AI contribution guidelines#16582

Merged
clonker merged 3 commits intodevelopfrom
docs-add-pr-template-and-ai-contrib-guidelines
Apr 28, 2026
Merged

Docs: add PR template and AI contribution guidelines#16582
clonker merged 3 commits intodevelopfrom
docs-add-pr-template-and-ai-contrib-guidelines

Conversation

@clonker
Copy link
Copy Markdown
Member

@clonker clonker commented Apr 8, 2026

No description provided.

@clonker clonker marked this pull request as ready for review April 8, 2026 09:20
nikola-matic
nikola-matic previously approved these changes Apr 9, 2026
Copy link
Copy Markdown
Contributor

@nikola-matic nikola-matic left a comment

Choose a reason for hiding this comment

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

I like this in principle and wouldn't be against merging it as is - the only 'negative' point about it is that I think we should have some automation for this (a separate job, or at least an automatic comment on external PRs), otherwise this will just get lost amongst the rest of our contribution guidelines, which most people don't seem to read anyway :)

@r0qs
Copy link
Copy Markdown
Member

r0qs commented Apr 9, 2026

I like this in principle and wouldn't be against merging it as is - the only 'negative' point about it is that I think we should have some automation for this (a separate job, or at least an automatic comment on external PRs), otherwise this will just get lost amongst the rest of our contribution guidelines, which most people don't seem to read anyway :)

Maybe we can also add a similar message to the external PR action: https://github.com/argotorg/solidity/blob/develop/.github/workflows/welcome-external-pr.yml. It already mentions the contributing section of the docs, but it might be worth repeating that information in the bot comment as well.

r0qs
r0qs previously approved these changes Apr 9, 2026
@cameel cameel changed the title Docs add pr template and ai contribution guidelines Docs add PR template and AI contribution guidelines Apr 9, 2026
@cameel cameel changed the title Docs add PR template and AI contribution guidelines Docs: add PR template and AI contribution guidelines Apr 9, 2026
Comment thread docs/contributing.rst Outdated
Copy link
Copy Markdown
Collaborator

@cameel cameel Apr 9, 2026

Choose a reason for hiding this comment

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

The new text partially overlaps with our current greeter. We should merge it into this template. Especially the self-review checklist would probably work better as a checkbox here.

Comment thread .github/PULL_REQUEST_TEMPLATE.md
@clonker clonker requested a review from czepluch April 13, 2026 09:43
czepluch
czepluch previously approved these changes Apr 13, 2026
Copy link
Copy Markdown
Contributor

@czepluch czepluch left a comment

Choose a reason for hiding this comment

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

Looks good to me.

Comment thread docs/contributing.rst Outdated
@clonker clonker dismissed stale reviews from czepluch, r0qs, and nikola-matic via ed300d8 April 13, 2026 12:54
@clonker clonker force-pushed the docs-add-pr-template-and-ai-contrib-guidelines branch 2 times, most recently from ed300d8 to 42cc45a Compare April 13, 2026 12:56
@clonker clonker requested a review from cameel April 13, 2026 14:11
@clonker clonker force-pushed the docs-add-pr-template-and-ai-contrib-guidelines branch from 42cc45a to 4a1f87e Compare April 27, 2026 18:02
cameel
cameel previously approved these changes Apr 27, 2026
Copy link
Copy Markdown
Collaborator

@cameel cameel left a comment

Choose a reason for hiding this comment

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

I'd remove a bit of redundancy from the template. IMO it the shorter it is, the bigger chance that someone will actually read it :) There are also some leftover references to the comment you removed.

These are minor enough that I'm approving anyway - I'd like to see it merged soon - but would be nice if these could be addressed first.

Comment thread .github/PULL_REQUEST_TEMPLATE.md Outdated
Comment thread .github/PULL_REQUEST_TEMPLATE.md Outdated
Comment thread .github/workflows/welcome-external-pr.yml Outdated
@clonker clonker force-pushed the docs-add-pr-template-and-ai-contrib-guidelines branch from 4a1f87e to 28afc58 Compare April 28, 2026 15:03
@clonker clonker requested a review from cameel April 28, 2026 15:04
@clonker clonker merged commit 4b52c0e into develop Apr 28, 2026
83 checks passed
@clonker clonker deleted the docs-add-pr-template-and-ai-contrib-guidelines branch April 28, 2026 15:30
Comment on lines +13 to +14
- [ ] I have read the [contributing guidelines](https://docs.soliditylang.org/en/latest/contributing.html) and
the [review checklist](https://github.com/argotorg/solidity/blob/develop/ReviewChecklist.md)
Copy link
Copy Markdown
Collaborator

@cameel cameel Apr 28, 2026

Choose a reason for hiding this comment

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

Looks like github does not follow the usual Markdown rules here. The line break gets rendered, which looks weird (see for example #16647).

Would be nice to fix this. A small annoyance, but now I'll be seeing that in every PR :)

Copy link
Copy Markdown
Member Author

@clonker clonker Apr 28, 2026

Choose a reason for hiding this comment

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

You're not the only one who'll be slightly triggered by seeing that in every PR :)

#16648

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.

5 participants