Skip to content

docs(#1290): add export blocks for shell variables in install guide#1295

Merged
rh-hemartin merged 1 commit into
mainfrom
agent/1290-consistent-install-vars
May 26, 2026
Merged

docs(#1290): add export blocks for shell variables in install guide#1295
rh-hemartin merged 1 commit into
mainfrom
agent/1290-consistent-install-vars

Conversation

@fullsend-ai-coder
Copy link
Copy Markdown

Each section of the installation guide now begins with an explicit export block listing all required shell variables for that section. Previously, variables like $ORG_NAME and $GCP_PROJECT were referenced in code blocks without being defined, forcing administrators to scan each section to discover what needed to be set before running commands. The Advanced: pre-configure WIF section already followed this pattern — this change brings all other sections in line.

Sections updated:

  • Section 1 (Run the installer): ORG_NAME, GCP_PROJECT
  • Multi-org first org: FIRST_ORG, GCP_PROJECT
  • Multi-org additional orgs: ADDITIONAL_ORG
  • Enable/disable repos: ORG_NAME
  • Analyze: ORG_NAME
  • Uninstall: ORG_NAME
  • Per-repo first-time: ORG_NAME, REPO_NAME, GCP_PROJECT
  • Per-repo reusing infrastructure: MINT_URL
  • Custom app sets: ORG_NAME, GCP_PROJECT, NEW_ORG

Where variables carry over from a prior step in the same workflow, a note says so instead of repeating the export.

Note: make lint could not run due to a sandbox infrastructure issue (Go toolchain permission denied). This is a docs-only change with no Go code modifications.


Closes #1290

Post-script verification

  • Branch is not main/master (agent/1290-consistent-install-vars)
  • Secret scan passed (gitleaks — f432d152647ddc9195667abbfd27f78059b199c8..HEAD)
  • Pre-commit hooks passed (authoritative run on runner)
  • Tests ran inside sandbox

Each section of the installation guide now begins with an explicit
export block listing all required shell variables for that section.
Previously, variables like $ORG_NAME and $GCP_PROJECT were referenced
in code blocks without being defined, forcing administrators to scan
each section to discover what needed to be set before running
commands. The Advanced: pre-configure WIF section already followed
this pattern — this change brings all other sections in line.

Sections updated:
- Section 1 (Run the installer): ORG_NAME, GCP_PROJECT
- Multi-org first org: FIRST_ORG, GCP_PROJECT
- Multi-org additional orgs: ADDITIONAL_ORG
- Enable/disable repos: ORG_NAME
- Analyze: ORG_NAME
- Uninstall: ORG_NAME
- Per-repo first-time: ORG_NAME, REPO_NAME, GCP_PROJECT
- Per-repo reusing infrastructure: MINT_URL
- Custom app sets: ORG_NAME, GCP_PROJECT, NEW_ORG

Where variables carry over from a prior step in the same workflow,
a note says so instead of repeating the export.

Note: make lint could not run due to a sandbox infrastructure
issue (Go toolchain permission denied). This is a docs-only
change with no Go code modifications.

Closes #1290
@github-actions
Copy link
Copy Markdown

Site preview

Preview: https://d26b447d-site.fullsend-ai.workers.dev

Commit: 8a963734bf5efc1fd43f830717faf24e0e2e28c0

@fullsend-ai-review
Copy link
Copy Markdown

Review

Findings

No findings.

@fullsend-ai-review fullsend-ai-review Bot added the ready-for-merge All reviewers approved — ready to merge label May 21, 2026
@rh-hemartin rh-hemartin added this pull request to the merge queue May 26, 2026
Merged via the queue into main with commit d05d8ea May 26, 2026
8 of 9 checks passed
@rh-hemartin rh-hemartin deleted the agent/1290-consistent-install-vars branch May 26, 2026 07:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-merge All reviewers approved — ready to merge

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Document install properties consistently

1 participant