Contribute

The data lives in plain files in a git repository. Anyone can send a correction.

Report a wrong mapping

If a chapter, volume or date does not match a reliable source, fill in thewrong-mapping form on GitHub. Say which series and work is wrong, what it should be, and link the source.

Good sources are publisher and official anime pages, Anime News Network, Wikipedia lists that cite their sources, and series wikis. Do not link fan translations, scan sites or download sites.

Fix the data yourself

Each series is a folder of YAML files under data/franchises/. The full guide isCONTRIBUTING.md. In short:

Install Bun, clone the repository, and run bun install.
Edit the files, or start a new series with bun run new-franchise <id>.
Give every mapping and date a source and a confidence. Leave a TODO(verify) comment for anything you cannot source. Missing data is fine; wrong data is not.
Run bun run validate and bun run check, then open a pull request.

What we ask

Take facts from wikis and cite them, but never copy their prose. Write arc summaries in your own words.
Mark arcs whose names give away the plot with spoiler: true.
Purchase links go to publisher or retailer pages for the exact volume and language. No affiliate links.
Contributions are licensed like the project: data under CC BY 4.0, code under theMIT License. You are credited as one of theArc Almanac contributors.