Skip to content

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

Merged
jwrosewell merged 4 commits into
rcfrom
feature/environment-variable-list
Nov 13, 2026
Merged

jwrosewell merged 4 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 55b6ab5e.

  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. The section 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.
  2. AGENTS.md on rc has the "Releases" section twice, word for word, since #29 and #34 each added one. The second copy is removed.

The links are to a fixed commit so that they say the same thing whatever happens to the branch later. common-ci#319 and #320 are on common-ci's rc and not yet on its main, which is why the links name the commit rather than main.

The head is the earlier head 9b7f1d3 with rc at df0949d7 merged in, and then the removal of the second "Releases" section.

Checks

Pull request checks on the head, all finished and passed.

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 AGENTS.md, so no full build was started. No package's folder changes, so the release plan releases nothing for it.

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.
  2. Once common-ci#319 and #320 reach common-ci's main, the links can move to a commit on main.

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.
@jwrosewell
jwrosewell marked this pull request as ready for review November 13, 2026 19:11
@jwrosewell
jwrosewell merged commit 94073ec into rc Nov 13, 2026
3 checks passed
@jwrosewell
jwrosewell deleted the feature/environment-variable-list branch November 13, 2026 19:11
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