Summary
docs/users-guide.md documents the new subagent manifest section, but does not document the new UBUNTU_CODENAME bootstrap override introduced for rust-entrypoint-system in PR #26.
Rationale
rust-entrypoint-system's configure_ubuntu_sources now accepts an optional codename override via the PHASE_UBUNTU_CODENAME environment variable (sourced from UBUNTU_CODENAME). When unset, it falls back to reading VERSION_CODENAME from /etc/os-release in a nounset-safe way, and fails fast if the codename still cannot be determined. None of this behaviour is currently documented for users.
Required changes
- Add a
UBUNTU_CODENAME entry to the system bootstrap documentation in docs/users-guide.md.
- Explain the
/etc/os-release (VERSION_CODENAME) fallback behaviour.
- State explicitly when operators should use the override (e.g. hosts with missing or non-standard
/etc/os-release codename fields).
Affected areas
docs/users-guide.mdrust-entrypoint-system
Acceptance criteria
Links
Summary
docs/users-guide.mddocuments the new subagent manifest section, but does not document the newUBUNTU_CODENAMEbootstrap override introduced forrust-entrypoint-systemin PR #26.Rationale
rust-entrypoint-system'sconfigure_ubuntu_sourcesnow accepts an optional codename override via thePHASE_UBUNTU_CODENAMEenvironment variable (sourced fromUBUNTU_CODENAME). When unset, it falls back to readingVERSION_CODENAMEfrom/etc/os-releasein a nounset-safe way, and fails fast if the codename still cannot be determined. None of this behaviour is currently documented for users.Required changes
UBUNTU_CODENAMEentry to the system bootstrap documentation indocs/users-guide.md./etc/os-release(VERSION_CODENAME) fallback behaviour./etc/os-releasecodename fields).Affected areas
docs/users-guide.mdrust-entrypoint-systemAcceptance criteria
docs/users-guide.mddocuments theUBUNTU_CODENAMEoverride./etc/os-releasefallback and failure behaviour.Links