Skip to content

Point AGENTS.md at the one list of environment variable names - #109

Draft
jwrosewell wants to merge 2 commits into
rcfrom
feature/environment-variable-list
Draft

jwrosewell wants to merge 2 commits into
rcfrom
feature/environment-variable-list

Conversation

@jwrosewell

@jwrosewell jwrosewell commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

The problem

James Rosewell decided at about 17:20 UTC on 12 November, "We should add to common-ci the env vars that are being used across the languages and reference this from other places. This ensure consistency."

common-ci#319 adds that list. environment-variables.json holds every environment variable name that the packages, tests, examples and CI scripts of every language read, with what each holds, the languages that read it and the deprecated names each replaced, and environment-variables.md is the page made from it. This draft points this repository at the list and says the list decides.

What changed

Documentation only, at head 9b7f1d3e, from rc 5b9fd55.

  1. AGENTS.md gains a section, "Environment variable names", before "Products keep their own CI scripts". It links the page and the JSON file in common-ci at commit d8a9c596, the reviewed head of common-ci#320, which adds the names review found missing from the list common-ci#319 made, says the list decides, and asks for the list in common-ci to change in the same piece of work as any new name or any old name read again. It also says that this repository's own name check, ci/check-environment-variable-names.ps1, still keeps a list of its own, and that where the two differ the list in common-ci is the one to follow.

The link is to a fixed commit so that it says the same thing whatever happens to the branch later.

Checks

Pull request checks on the head, all finished.

James Rosewell decided at about 11:35 UTC on 12 November, for a draft that changes only CI scripts and their notes, "rebuild and include, but the change doesn't impact the code so no need to run the full builds." This draft changes no package code, test, example or CI script, only documentation, so no full build was started.

What remains

  1. The next step is to make ci/check-environment-variable-names.ps1 read the list in common-ci instead of keeping its own. It is left as it is in this round, so nothing changes for the check during a week of releases.

AGENTS.md gains a section linking common-ci's list of environment variable
names (environment-variables.md, made from environment-variables.json) at
commit 18f9a570, and saying the list decides.

Documentation only.
The list at that commit holds the names review found missing.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant