How to use these docs
The site is organized as documentation sets, one per product. The Platform set is public. Each product set shows its overview to everyone and the rest to organizations that hold the product. Sign in, fill in your organization profile once, and every sample value on every page becomes your own.
The sets
| Set | Path | Access |
|---|---|---|
| Platform | /platform/ | Public and indexed by search engines |
| AWS Baseline | /aws/baseline/ | Overview public; the rest needs sign-in and the aws-baseline product |
| Web App Blueprint | /aws/blueprints/webapp/ | Overview public; the rest needs the aws-blueprint-webapp product |
| Data and ETL Blueprint | /aws/blueprints/etl/ | Overview public; the rest needs the aws-blueprint-etl product |
| Secrets Blueprint | /aws/blueprints/secrets/ | Overview public; the rest needs the aws-blueprint-secrets product |
| Azure Baseline, GCP Baseline | /azure/baseline/, /gcp/baseline/ | Sample placeholders, public, never indexed |
Gated pages are served with no-store and noindex headers, so they are never cached by a shared cache or listed by a search engine. Opening the root of a gated set without the product redirects you to its public overview.
Signing in
Sign in from the navigation bar. Your account belongs to an organization, and the organization carries the products it holds. BuiltForProd staff set those products when a purchase completes; you cannot grant them to yourself. If your organization holds several products, one sign-in opens all of them. An organization admin can invite colleagues from the same email domain from the Team page.
Placeholders that become your values
Pages are written with sample values. A build-time step turns each occurrence into a component that renders your organization's value when you are signed in, or the sample when you are not or when no value has been saved.
| Sample | Meaning |
|---|---|
acme | Organization abbreviation, the namespace that prefixes every resource name |
ACME | Upper-case form, the prefix of the SSO groups |
your-github-org | GitHub organization |
company.com | Primary domain |
internal.company.com | Internal DNS zone |
us-west-2, usw2 | Home region and its slug |
111111111111 | Management account id; each of the fourteen accounts has its own repeating sample id |
Substitution works inside identifiers too: the development cluster acme-usw2-dev-eks and the state bucket acme-use1-root-tfstate render with your namespace and region slug. Organization admins enter the values on the Organization profile page; each value is validated before it is saved (an account id must be twelve digits, a region must be a real AWS region name). The privacy page says where those values are stored and who can read them.
acme-usw2-prd-vpc the sample, shown to anyone
contoso-euw1-prd-vpc the same line for an organization whose namespace is contoso in eu-west-1
Search
Search is split by set. On a Baseline page, the Baseline is searched first; on a Platform page, the Platform set. The index holds the sample values, so search for acme-usw2-dev-eks rather than your own cluster name.
The page footer
Every page ends with two blocks generated from its front matter: What's next, the one to three pages to read after this one, and Related topics, the two to six pages that cover the same ground from another angle. Following What's next from a set's first page reads the set in order. The key concepts page is the usual first stop.
Conventions on every page
- The first paragraph answers the page's question.
- Diagrams are Mermaid, drawn from the code, and use the site theme's colors.
- Configuration is shown as it is in the repositories, with a caption naming the file.
- Acronyms are expanded on first use; the glossary holds the definitions and links to the explainer for each AWS service and tool.
- Customer pages describe the platform and how to operate it. Deployment procedures, bootstrap steps and credentials are not published here.
The account pages
| Page | What it does | Who |
|---|---|---|
| Sign in | Opens the sign-in form | Everyone |
| Team | Lists members and pending invitations; invite by email, change a role, remove a member | Organization admins |
| Organization profile | The placeholder values for your organization | Organization admins edit; members read |
The reading paths by role page tells each kind of reader which pages to open, in which order.