Contributing

Thank you for helping. Anyone can contribute: corrections, updates, new pages and translations. The wiki was started by the team behind Cloudish, at Hal9, who review pull requests; it gets better the more people write in it. Because it is only useful if it is correct, corrections always come first.

Report a mistake

Open an issue. Please include:

If you are not sure something is wrong, open the issue anyway and say so.

Propose a change

Pull requests are welcome: fixes, updated facts, new pages and translations. For a new page, check the index first so each question has one page; for a large rewrite, open an issue first so we can agree on scope.

Work locally

  1. Fork the repository on GitHub, clone your fork, and make a branch: git switch -c fix-data-protection-table.
  2. Edit or add pages. Any Markdown editor works; links between pages are relative (AI-agent.md), so they also work in your editor's preview.
  3. Check your links: python3 scripts/build_wiki.py (Python 3, nothing to install). The script also regenerates the navigation — do not commit those changes; the bot regenerates the navigation after your pull request merges.
  4. Optional: see the wiki as a site, with the sidebar: scripts/preview.sh, then open _preview/index.html in a browser (needs pandoc).
  5. Commit, push to your fork, and open a pull request. Say in it what you checked and where (links to the sources).

On every pull request, a check runs scripts/build_wiki.py and fails if a link is broken, or if the pull request hand-edits the generated navigation (_Sidebar.md, Category-*.md, Tags.md, Tag-*.md). After the pull request merges, a workflow regenerates the navigation and commits it to main. A maintainer then reviews the facts against the sources.

Rules for pages

Page template

Pages are Markdown files at the top level, named in wiki style: words separated by hyphens, first letter capital (AI-agent.md, Data-protection-by-vendor.md). Keep pages short and focused; when a topic grows, split it into linked pages.

Every page follows the same template:

---
title: "What an AI agent is"
description: "One line for the index."
category: Agents
tags: [agents, basics]
order: 1
checked: 2026-10-28
---

<!-- NAV:START -->
<!-- NAV:END -->

# What an AI agent is

**One sentence that answers the question.** Context and caveats after.

(body)

## Related pages
## See also
<!-- SEEALSO:START -->
<!-- SEEALSO:END -->
## Sources
---
(footer: how the page was written and when it was last checked against the sources, how to fix it, licence)

Categories and tags are descriptive and will change. Reuse an existing one when it fits; add a new one when it does not. order sets the position within the category.

Link the first use of a glossary term to its entry in Glossary.md. The navigation (Home index, _Sidebar.md, category and tag pages, breadcrumbs, See also) is generated by the bot after your pull request merges — do not commit it. To check your links locally:

python3 scripts/build_wiki.py

python3 scripts/build_wiki.py --link-terms also links the first plain use of each glossary term; review its diff and commit only the term links, not the regenerated navigation.

Licence

By contributing, you agree that your text is released under CC BY 4.0. The build script is under the MIT licence (see its header).