Skip to content

reorg nav, link refs to usage #1449

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
trujillo-adam wants to merge 9 commits into
base: main
Choose a base branch
from
Open

reorg nav, link refs to usage #1449

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
4538e52
reorg nav, link refs to usage
trujillo-adam Dec 4, 2025
3824b96
split post-apply ops topic
trujillo-adam Dec 4, 2025
d4041e0
import -> search and import
trujillo-adam Dec 8, 2025
e5f4b4d
Merge branch 'main' into atru/tf-lang-reorder-nav
trujillo-adam Dec 8, 2025
5271d66
Merge branch 'main' into atru/tf-lang-reorder-nav
trujillo-adam Dec 9, 2025
b662623
moved link to mod block ref, added link to tuts
trujillo-adam Dec 9, 2025
f9964a0
install providers -> configure providers
trujillo-adam Dec 9, 2025
33021fd
rename upgrade topic label
trujillo-adam Dec 9, 2025
97e9766
Merge branch 'main' into atru/tf-lang-reorder-nav
trujillo-adam Dec 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
303 changes: 185 additions & 118 deletions content/terraform/v1.14.x/data/language-nav-data.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,40 +1,4 @@
[
{ "heading": "Terraform Language" },
{ "title": "Overview", "path": "" },
{
"title": "Attributes as Blocks - Configuration Language",
"path": "attr-as-blocks",
"hidden": true
},
{
"title": "Style guide",
"path": "style"
},
{
"title": "Syntax",
"routes": [
{ "title": "Overview", "path": "syntax" },
{
"title": "Configuration syntax",
"path": "syntax/configuration"
},
{
"title": "JSON configuration syntax",
"path": "syntax/json"
}
]
},
{
"title": "Files and configuration structure",
"routes": [
{ "title": "Overview", "path": "files" },
{ "title": "Override files", "path": "files/override" },
{ "title": "Dependency lock file", "path": "files/dependency-lock" },
{ "title": "Test files", "path": "files/tests" },
{ "title": "Query files", "path": "files/tfquery" },
{ "title": "Stack files", "path": "files/stack" }
]
},
{
"title": "Install providers",
Copy link
Contributor

@BrianMMcClain BrianMMcClain Dec 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What do you think about "Use providers", "Configure providers", etc rather than install? To me, "install" feels like the CLI side of things.

Copy link
Contributor Author

@trujillo-adam trujillo-adam Dec 9, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To me, installing most closely matches the action, but we can try "Configure providers". I was trying to avoid potential confusion in terms of developing providers. IMO, "Use" is almost always way to generic, but it fits in this case better than most.

"routes": [
Expand All @@ -46,63 +10,87 @@
{
"title": "Dependency lock file",
"href": "/language/files/dependency-lock"
},
{
"title": "provider block reference",
"path": "block/provider"
},
{
"title": "terraform block reference",
"path": "block/terraform"
}
]
},
{
"title": "Create and manage resources",
"title": "Resources",
"routes": [
{ "title": "Overview", "path": "resources" },
{ "title": "Configure a resource", "path": "resources/configure" },
{ "title": "Destroy a resource", "path": "resources/destroy" }
{ "title": "Destroy a resource", "path": "resources/destroy" },
{ "title": "resource block reference", "path": "block/resource" }
]
},
{
"title": "Manage values in modules",
"alias": "variables, outputs, locals",
"title": "Data sources",
"routes": [
{
"title": "Query infrastructure data",
"path": "data-sources"
},
{
"title": "data block reference",
"path": "block/data"
}
]
},
{
"title": "Variables",
"routes": [
{
"title": "Overview",
"path": "values"
},
{
"title": "Use variables",
"path": "values/variables"
},
{
"title": "Use locals",
"path": "values/locals"
},
{
"title": "Use outputs",
"path": "values/outputs"
"title": "variable block reference",
"path": "block/variable"
}
]
},
{
"title": "Manage sensitive data",
},
{
"title": "Locals",
"routes": [
{
"title": "Overview",
"path": "manage-sensitive-data"
"title": "Use locals",
"path": "values/locals"
},
{
"title": "Ephemeral values in resources",
"path": "manage-sensitive-data/ephemeral"
"title":"locals block reference",
"path": "block/locals"
}
]
},
{
"title": "Outputs",
"routes": [
{
"title": "Use outputs",
"path": "values/outputs"
},
{
"title": "Use temporary write-only arguments",
"path": "manage-sensitive-data/write-only",
"alias": "write only"
"title": "output block reference",
"path": "block/output"
}
]
},
{ "title": "Query infrastructure data", "path": "data-sources", "alias": "data sources" },
{
"title": "Build and use modules",
{
"title": "Modules",
"routes": [
{ "title": "Overview", "path": "modules" },
{ "title":"Use modules", "path": "modules/configuration" },
{
"title": "module block reference",
"path": "block/module"
},
{
"title": "Develop modules",
"routes": [
Expand Down Expand Up @@ -131,30 +119,38 @@
}
]
},
{
"title": "Manage state",
{
"title": "Meta-arguments",
"alias": "depends_on, count, for_each, lifecycle, providers, provider meta-argument",
"path": "meta-arguments"
},
{
"title": "Sensitive data",
"routes": [
{ "title": "Overview", "path": "state" },
{ "title": "Purpose", "path": "state/purpose" },
{
"title": "Manage state in remote backends",
"path": "state/backends"
"title": "Manage sensitive data",
"path": "manage-sensitive-data"
},
{
"title": "Refactor state",
"path": "state/refactor"
"title": "Use temporary write-only arguments",
"path": "manage-sensitive-data/write-only",
"alias": "write only"
},
{ "title": "Remove a resource from state", "path": "state/remove" },
{ "title": "Locking", "path": "state/locking" },
{ "title": "Workspaces", "path": "state/workspaces" },
{ "title": "Remote state", "path": "state/remote" }
{
"title": "Ephemeral values in resources",
"path": "manage-sensitive-data/ephemeral"
},
{
"title": "ephemeral block reference",
"path": "block/ephemeral"
}
]
},
{
"title": "Store state remotely",
"title": "Backends",
"routes": [
{
"title": "Overview",
"title": "Configure a backend",
"path": "backend"
},
{
Expand Down Expand Up @@ -208,42 +204,47 @@
]
},
{
"title": "Import existing resources",
"routes": [
{ "title": "Overview", "path": "import"},
{
"title": "Import resources in bulk",
"path": "import/bulk",
"alias": "search, terraform search, query, list"
},
{ "title": "Import a single resource", "path": "import/single-resource" },
{
"title": "Generate configuration for single imports",
"path": "import/generating-configuration"
}
"title": "Import",
"routes": [
{ "title": "Overview", "path": "import"},
{
"title": "Import resources in bulk",
"alias": "search, terraform search, query, list",
"path": "import/bulk"
},
{ "title": "Import a single resource", "path": "import/single-resource" },
{
"title": "Generate configuration for single imports",
"path": "import/generating-configuration"
},
{
"title": "import block reference",
"path": "block/import"
},
{
"title": "list block reference",
"alias": "search, terraform search, query, list",
"path": "block/tfquery/list"
}
]
},
{
"title": "Test and validate configuration",
"title": "State",
"routes": [
{ "title": "Validate your configuration", "path": "validate" },
{
"title": "Test your configuration",
"routes": [
{
"title": "Overview",
"path": "tests"
},
{
"title": "Mocks",
"path": "tests/mocking"
}
]
}
{ "title": "Overview", "path": "state" },
{ "title": "Purpose", "path": "state/purpose" },
{ "title": "Manage state in remote backends", "path": "state/backends" },
{ "title": "Refactor state", "path": "state/refactor" },
{ "title": "Remove a resource from state", "path": "state/remove" },
{ "title": "Locking", "path": "state/locking" },
{ "title": "Workspaces", "path": "state/workspaces" },
{ "title": "Remote state", "path": "state/remote" },
{ "title": "removed block reference", "path": "block/removed" },
{ "title": "moved block reference", "path": "block/moved" }
]
},
{
"title": "Manage infrastructure at scale with Stacks",
"title": "Stacks",
"routes": [
{ "title": "Overview", "path": "stacks", "alias": "stacks"},
{ "title": "Update from beta to general availability", "path": "stacks/update-GA" },
Expand All @@ -269,24 +270,90 @@
]
},
{
"title": "Invoke actions",
"path": "invoke-actions"
},
{
"title": "Use provisioners for post-apply operations",
"path": "provisioners",
"alias": "provisioners"
"title": "Test and validate",
"routes": [
{ "title": "Validate your configuration", "path": "validate" },
{
"title": "Test your configuration",
"routes": [
{
"title": "Overview",
"path": "tests"
},
{
"title": "Mocks",
"path": "tests/mocking"
}
]
}
]
},
{
"title": "Upgrade to Terraform v1.12",
"path": "upgrade-guides"
"title": "Extend CRUD operations",
"alias": "actions, terraform actions",
"routes": [
{
"title": "Invoke actions",
"path": "invoke-actions"
},
{
"title": "Post-apply operations",
"path": "post-apply-operations"
},
{
"title": "Provisioners",
"path": "provisioners"
},
{
"title": "action block reference",
"path": "block/action"
}
]
},
{ "divider": true },
{ "heading": "UPGRADE"},
{ "title": "Upgrade", "path": "upgrade-guides" },
{
"title": "v1.x Compatibility promises",
"title": "v1.x compatibility promises",
"path": "v1-compatibility-promises"
},
{ "divider": true },
{
"divider": true },
{ "heading": "REFERENCE" },
{
"title": "Style guide",
"path": "style"
},
{
"title": "Syntax",
"routes": [
{ "title": "Overview", "path": "syntax" },
{
"title": "Configuration syntax",
"path": "syntax/configuration"
},
{
"title": "JSON configuration syntax",
"path": "syntax/json"
},
{
"title": "Attributes as blocks",
"path": "attr-as-blocks",
"hidden": false
}
]
},
{
"title": "Files and configuration structure",
"routes": [
{ "title": "Overview", "path": "files" },
{ "title": "Override files", "path": "files/override" },
{ "title": "Dependency lock file", "path": "files/dependency-lock" },
{ "title": "Test files", "path": "files/tests" },
{ "title": "Query files", "path": "files/tfquery" },
{ "title": "Stack files", "path": "files/stack" }
]
},
{
"title": "Configuration blocks",
"routes": [
Expand Down Expand Up @@ -1163,5 +1230,5 @@
{ "title": "zipmap", "path": "functions/zipmap", "hidden": true }
]
},
{ "title": "Terraform internals", "href": "/internals" }
{ "title": "Internals", "href": "/internals" }
]
Loading
Loading