Contributing to the aio-libs projects
This is a aio-libs project. By contributing you agree to abide by the Contributor Code of Conduct and follow the organization-global and project-local guidelines.
Individual projects have their own contribution guidelines. Please, read them before interacting in any community-related spaces.
Contributions following these guidelines are always welcomed, encouraged and appreciated.
Contributors are free to use whatever tools they like, but we have some additional guidance for LLM-assisted contributions.
When interacting in aio-libs spaces (issues, pull requests, matrix, etc.), do not use LLMs to speak for you, except for translation or grammar edits. This includes the creation of change logs and pull request descriptions. Human-to-human communication is foundational to open source communities.
Caution
In extreme cases, low quality PRs may be closed as spam.
Remember that you, not the LLM, are responsible for your contributions. Be ready to discuss your changes. Do not submit code you have not reviewed.
Do your best to follow the conventions and standards of the project. Make sure your code really works. Be thoughtful about testing and documentation.
Try to make your code brief, and recognize when less is more.
The use of agents which write code and submit pull requests without human review is not permitted.
We can already run these tools ourselves, if we want to. Contributions should provide value beyond running a tool.
Please do not replace the pull request template, which is part of the maintainers' process.
The good first issue label is used to designate items which are
being left for new contributors.
They're a great way to get onboarded into the project and learn.
Having an LLM resolve one of these issues does not help anyone learn. Therefore, please be considerate of those who may benefit from these opportunities, and refrain from asking an LLM to produce a complete solution.