AI policy
From Zacess main at 9d13dfb. Edit this page on GitHub
This policy covers every contribution to Zacess from people outside the project: code, documentation, commits, issues, pull requests, comments, reviews and discussions. It applies to every repository in this organisation.
Important
Every pull request must say how AI was used, even when the answer is None. A pull request without it waits until it is added.
AI tools are welcome
You can use AI tools to learn, to write code or to find your way around the project. You stay responsible for everything you submit.
Assistive technology such as dictation, screen readers, translation and spelling or grammar tools is not AI use for this policy. You never need to declare it.
What is required
- Declare your AI use. Pull requests ask for None, Assisted or Generated. Issue forms ask whether AI helped you find or check the problem.
- Write your own titles and descriptions. Issue and pull request titles and bodies, comments and reviews are written by you in your own words. Imperfect English is fine.
- Translating and tidying is fine. Write in your own language and translate it with any tool. Fixing the spelling and grammar of text you wrote is fine too. Neither needs declaring. Having AI write the title or description for you is not allowed. Nor is turning a few words into paragraphs.
- Follow the templates. Fill in every required field and keep the template's sections.
- Understand what you submit. You should be able to explain any line if asked.
- Test it. Run the project's checks and say what you ran and what you saw.
- Open it yourself. Issues, pull requests and reviews come from a person. An AI agent must not open them on its own.
- No bulk submissions. Do not open generated issues, pull requests or reviews in bulk.
Reviews and comments
A review comment must come from your own reading of the change. A pasted AI review that you have not checked yourself will be hidden.
If you used no AI
Choose None. Everything else stays the same: the same checks and reviews apply.
Labels
| Label | Meaning |
|---|---|
ai-assisted |
You wrote it and AI helped with parts |
ai-generated |
AI wrote most or all of it and you reviewed and tested it |
needs-ai-disclosure |
The disclosure is missing, so the pull request waits until it is added |
What happens otherwise
- Missing disclosure: the pull request is labelled
needs-ai-disclosureand waits. - Generated work no person has reviewed or tested, including anything an AI agent opened on its own: closed with a short note linking here.
- Repeated cases fall under the code of conduct.
Useful reading
- Contributing guide: how to get a change from idea to merge
- Code of conduct: how everyone is expected to behave
- About pull requests: GitHub's guide
- Creating an issue: GitHub's guide
- Taking part in a discussion: GitHub's guide
- How to write a Git commit message: a short guide by Chris Beams
Questions and contact
- Questions: ask in Discussions. The support page lists every other way to get help.
- Anything private: email contact@zacess.com if something here is unclear or you have a question this policy does not answer.
- Security problems never go in a public issue or discussion. Follow the security policy or email security@zacess.com.