Skip to content

Conversation

@dagurtomas
Copy link
Contributor

@dagurtomas dagurtomas commented Nov 5, 2025

No description provided.

Clarify criteria for marking PRs as 'easy' and update related conditions.
@dagurtomas dagurtomas changed the title Update criteria for 'easy' label in contributions chore: clarify criteria for 'easy' label Nov 5, 2025
@mcdoll
Copy link
Member

mcdoll commented Nov 5, 2025

Thanks. I think it is good to clarify this. There might be cases where a theorem gets generalized at almost no cost and I would consider that easy, but it is probably better to slightly more strict on that label.

@chrisflav
Copy link
Contributor

chrisflav commented Nov 5, 2025

Do we even need an easy label? Is it something people specifically filter PRs by?

- The **"blocked-by-other-PR"** label means that some specific other PR(s) should be resolved before addressing this one. To add the "blocked-by-other-PR" label to your PR, include the PR numbers of the dependencies in the PR comment (following the example hidden in the comment there) so that others can see at a glance which PRs should be reviewed first. The label will be added automatically by a bot and will also be removed automatically when the other PRs have been merged. PRs with this label do not appear on the review queue.

- The **easy** label should be used to mark PRs that can be immediately approved. Maintainers and reviewers often look at easy PRs first to keep the queue flowing. Easy PRs typically add a single lemma, correct typos in documentation, or similar. If you have any doubt whether your PR is trivial you should not add this label. In particular, a PR is generally *not* easy if the diff is more than 25 lines, it adds any definitions or new files, or it adds any `simp` lemmas or instances that are not immediately analogous to existing `simp` lemmas or instances.
- The **easy** label should be used to mark PRs that can be immediately approved. Maintainers and reviewers often look at easy PRs first to keep the queue flowing. Easy PRs typically add a single lemma, correct typos in documentation, or similar. If you have any doubt whether your PR is trivial you should not add this label. In particular, a PR is generally *not* easy if the diff is more than 25 lines, it changes any existing definitions or theorem statements, it adds any definitions or new files, or it adds any `simp` lemmas or instances that are not immediately analogous to existing `simp` lemmas or instances. Note that a small diff does not automatically make a PR easy!
Copy link
Member

Choose a reason for hiding this comment

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

Perhaps in the "immediately analogous" case one should require the author to put in the relevant context in the PR description?

@bryangingechen
Copy link
Collaborator

Do we even need an easy label? Is it something people specifically filter PRs by?

I've often used it when looking for low-hanging fruit to approve.

@chrisflav
Copy link
Contributor

I am wondering if it is sensible to only allow usage of the easy label for experienced contributors. It seems to me that in particular new contributors are overusing easy.

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.

5 participants