Skip to content

Commit bfdcc73

Browse files
authored
meta: add a section on AI-assisted PRs in CONTRIBUTING guide (#11388)
1 parent ece9432 commit bfdcc73

File tree

1 file changed

+15
-1
lines changed

1 file changed

+15
-1
lines changed

CONTRIBUTING.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ Apart from the `good first issue`, the following labels are also worth looking a
8282
- [`help wanted`](https://github.com/facebook/docusaurus/labels/help%20wanted): if you have specific knowledge in one domain, working on these issues can make your expertise shine.
8383
- [`status: accepting pr`](https://github.com/facebook/docusaurus/labels/status%3A%20accepting%20pr): community contributors can feel free to claim any of these.
8484

85-
If you want to work on any of these issues, just drop a message saying "I'd like to work on this", and we will assign the issue to you and update the issue's status as "claimed". **You are expected to send a pull request within seven days** after that, so we can still delegate the issue to someone else if you are unavailable.
85+
If you want to work on any of these issues, just drop a message saying "I am working on this". **You do not need to ask for assignment to work on any issue explicitly marked as welcoming external contributions.** However, don't "cookie lick", or squat on an issue without actually sending a PR. You are automatically considered as giving up if you don't **send a PR within seven days after your comment**, and the issue automatically becomes up for grabs again.
8686

8787
Alternatively, when opening an issue, you can also click the "self service" checkbox to indicate that you'd like to work on the issue yourself, which will also make us see the issue as "claimed".
8888

@@ -214,6 +214,16 @@ After you have signed the CLA, the CLA bot would automatically update the PR sta
214214

215215
If it happens that you were unavailable and your PR gets closed, feel free to reopen once it's ready! We are still happy to review it, help you complete it, and eventually merge it.
216216

217+
### AI-assisted PRs
218+
219+
We welcome the use of AI tools for authoring PRs, and we love to see people pushing the boundaries of AI capabilities. The core team actively uses different AI tools in our development process. However, we are aware that **many people are sending entirely AI-generated PRs as a low-effort way to farm OSS contributions**, so please be mindful of the following etiquette to show your respect for our time and our codebase:
220+
221+
- **Be transparent**: If a significant portion of your code is AI generated, please indicate that in your PR description.
222+
- **Be accountable**: You are responsible for the code you submit, regardless of whether it was generated by AI or written by you. You should be able to explain every line of the code, ensure all tests pass, and address our reviews.
223+
- **Be reasonable**: Sometimes we receive 1k LOC PRs that are obviously AI-generated and implement unsolicited features. Please note that significant changes require prior communication and approval from the team in the form of an issue.
224+
225+
We retain the right to close any PR that we deem as unproductive or low-effort, even when we agree with the spirit of the change.
226+
217227
### Breaking Changes
218228

219229
When adding a new breaking change, follow this template in your pull request:
@@ -227,6 +237,10 @@ When adding a new breaking change, follow this template in your pull request:
227237
- **Severity (number of people affected x effort)**:
228238
```
229239

240+
> [!NOTE]
241+
>
242+
> Breaking changes should be discussed in the issue tracker before being implemented.
243+
230244
### What Happens Next?
231245

232246
The core Docusaurus team will be monitoring pull requests. Do help us by keeping pull requests consistent by following the guidelines above.

0 commit comments

Comments
 (0)