Add a programming language
Propose a new PL for the catalog.
Required: language name + evidence URL. A program example is encouraged
but optional — skeleton proposals are accepted (a maintainer will add the
program later). Submit opens a pre-filled GitHub issue tagged
pl-add; an auto-PR workflow turns the issue into a pull
request that materializes languages/<Name>/meta.json,
the program files, and the pl_list.txt insertion.
Existing rules in CLAUDE.md and the auto-PR workflow in docs/add_pl.md.
What happens after I submit?
- A GitHub issue opens in this repo, tagged
pl-add, carrying your form fields in a structured YAML block. - A scheduled workflow (
.github/workflows/pl-add-pr.yml) picks up the issue and runstools/process_pl_addition.pyagainst it: validates the name isn't already inpl_list.txt, materializeslanguages/<Name>/meta.jsonand (if provided) the program files (code.<ext>+manifest.json), and appends the name topl_list.txt. - The workflow opens a draft pull request from a feature branch
pl-add/<sanitized-name>, withResolves #<issue>in the body. - A maintainer reviews the PR (sanity-checks the evidence URL, the program source, the license). On merge, the new PL appears in the next site build.
- For skeleton proposals (no program), the PR creates the meta.json but flags the missing program in the PR description; a separate follow-up commit (manual or via the agentic
/loop) adds the example.