You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The naming_conventions group under implementation_guide/phase_2/plan_organizational_structure covers naming for flows/trails, attestation types, and environments, but there is no guidance on tagging as a classification strategy across resource types. Tags now exist on resources (including via the Terraform provider), and tag-based filtering is on the roadmap, but there is no recommended taxonomy for what to tag or how. Without it, different teams invent divergent schemes, which undermines filtering, policy scoping, and reporting once the resource count grows.
Expected Behavior
A strategy-level page (e.g. naming_conventions/tagging_strategy.md, or a section in overview.md) that defines a recommended, cross-resource tag vocabulary, complementing the per-resource naming pages. Naming identifies a resource; tags classify it for filtering, policy, and reporting.
Current Behavior
No tagging guidance exists in the implementation guide. The current naming_conventions/ group contains only overview.md, flows_and_trails.md, and attestation_types.md.
Use Case
Organizations operating across multiple geographies, business units, and teams need a consistent way to classify environments and attestation types (and later repos) so they can filter, scope policy, and report consistently as the number of resources scales.
Suggested Approach
Recommended tag keys with example values: geo/region, business-unit, team, tier (criticality/lifecycle), cost-center, cloud.
key:value conventions: lowercase keys, consistent value formats, avoid redundancy with the resource name. Model the guidance on Kubernetes labels/annotations conventions.
When to tag vs encode in the name: stable identity goes in the name; filterable, mutable metadata goes in a tag.
Note on managing tags as code via the Terraform provider.
Problem
The
naming_conventionsgroup underimplementation_guide/phase_2/plan_organizational_structurecovers naming for flows/trails, attestation types, and environments, but there is no guidance on tagging as a classification strategy across resource types. Tags now exist on resources (including via the Terraform provider), and tag-based filtering is on the roadmap, but there is no recommended taxonomy for what to tag or how. Without it, different teams invent divergent schemes, which undermines filtering, policy scoping, and reporting once the resource count grows.Expected Behavior
A strategy-level page (e.g.
naming_conventions/tagging_strategy.md, or a section inoverview.md) that defines a recommended, cross-resource tag vocabulary, complementing the per-resource naming pages. Naming identifies a resource; tags classify it for filtering, policy, and reporting.Current Behavior
No tagging guidance exists in the implementation guide. The current
naming_conventions/group contains onlyoverview.md,flows_and_trails.md, andattestation_types.md.Use Case
Organizations operating across multiple geographies, business units, and teams need a consistent way to classify environments and attestation types (and later repos) so they can filter, scope policy, and report consistently as the number of resources scales.
Suggested Approach
geo/region,business-unit,team,tier(criticality/lifecycle),cost-center,cloud.docs.jsonnavigation under the naming conventions group.Related