Community & contributing#
tabnas is developed in the open, under the MIT licence. Bug reports, questions, and new grammars all arrive the same way — through GitHub.
Discuss
Ask questions and share what you’re building in GitHub Discussions.
Report
File issues and feature requests on the relevant repository.
Contribute
Read the contributing guide, then pick a “good first issue”.
How the project works#
- Extension over addition. A new language is usually rules added to a grammar that already parses something similar. That’s the cheapest kind of contribution, and the one the engine is designed for.
- Small, focused packages. The engine stays lean; languages live in their own repos.
- TypeScript is canonical; Go tracks it. Changes land in TS first, then Go to match. Both implementations parse the same test grammars and must agree.
This project is AI-friendly#
Contributions written with an AI agent are welcome here. No disclosure ritual, no separate review queue, no apology required — a good patch is a good patch, and the same standard applies either way: it has to pass the fixtures, and you have to understand what you’re submitting.
Every package repository ships an AGENTS.md describing its layout,
conventions, and how to run the tests, so an agent can get oriented without
guessing. The parser itself is built to be
written by agents, so it would be strange to draw the line at the
contributions.
The fixtures are what make this safe. Both runtimes parse the same test grammars and must agree, so a plausible-looking change that doesn’t actually work fails loudly rather than landing quietly.
First contributions get a prompt reply, and the project holds to a Code of Conduct. Development of tabnas is sponsored by Voxgig. — see sponsors.