Skip to content

Contribute

Everything on this site is maintained in a public GitHub repository.

Ways to contribute

Propose a practice. You have observed something that works and holds up. Use the Propose a practice issue template. State the practice as an imperative, the context in which it was learned, and the evidence.

Challenge a practice. You disagree with a practice, or your experience contradicts it. Use the Challenge a practice template. Challenges with concrete cases are the most useful input the record gets.

Submit a document. You know of a document (e.g., scientific manuscript, strategy paper, report, guideline) the record should digest. Use the Submit a document template with a link or DOI. An AI-assisted process distills it into a Library entry, with an editor approving the proposed changes before anything is published.

Discuss. For open-ended topics, use GitHub Discussions. Each practice page also has a discussion thread at the bottom.

No GitHub account? Use the AI for Science Google Group, or write to aiforscience@googlegroups.com. Proposals, challenges, and comments sent there are carried into the record by the editors, with attribution unless you ask otherwise. The Google Group doubles as a mailing list, so sign up if you'd like to stay up to date.

Edit directly. Every page has an edit button that opens a pull request. CONTRIBUTING.md covers working in the repository: the checks to run, the branch convention, and the licence your contribution carries. The conventions for page structure, metadata schema, and writing style are in CLAUDE.md.

Join the editor group. If you want to help maintain the record, see Become an editor.

Editorial standards

  • Short declarative sentences. Every word carries information.
  • Claims cite sources; distillations cite section and page.
  • Neutral coalition voice: the record speaks for its contributors collectively, never for a single institution.

What happens to your contribution

Editors review all input in the open. Accepted practices start as draft, move to reviewed when the editor group accepts them, and to endorsed when a named organisation formally backs them. See Governance for details.

Code of conduct

Everyone taking part is covered by the code of conduct. It applies in the repository, in Discussions, on the Google Group, on the monthly call, and at events held under the AI for Science name.