Skip to content

Commit 332dcb7

Browse files
committed
Remove .io docs links
1 parent 69561ef commit 332dcb7

File tree

25 files changed

+33
-34
lines changed

25 files changed

+33
-34
lines changed

.github/CONTRIBUTING.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
This repository contains Terraform core, which includes the command line interface and the main graph engine.
66

7-
Providers are implemented as plugins that each have their own repository linked from the [Terraform Registry index](https://registry.terraform.io/browse/providers). Instructions for developing each provider are usually in the associated README file. For more information, see [the provider development overview](https://www.terraform.io/docs/plugins/provider.html).
7+
Providers are implemented as plugins that each have their own repository linked from the [Terraform Registry index](https://registry.terraform.io/browse/providers). Instructions for developing each provider are usually in the associated README file. For more information, see [the provider development overview](https://developer.hashicorp.com/terraform/plugin).
88

99
This document provides guidance on Terraform contribution recommended practices. It covers what we're looking for in order to help set expectations and help you get the most out of participation in this project.
1010

@@ -100,7 +100,7 @@ Provisioners are an area of concern in Terraform for a number of reasons. Chiefl
100100

101101
There are two main types of provisioners in Terraform, the generic provisioners (`file`,`local-exec`, and `remote-exec`) and the tool-specific provisioners (`chef`, `habbitat`, `puppet` & `salt-masterless`). **The tool-specific provisioners [are deprecated](https://discuss.hashicorp.com/t/notice-terraform-to-begin-deprecation-of-vendor-tool-specific-provisioners-starting-in-terraform-0-13-4/13997).** In practice this means we will not be accepting PRs for these areas of the codebase.
102102

103-
From our [documentation](https://www.terraform.io/docs/provisioners/index.html):
103+
From our [documentation](https://developer.hashicorp.com/terraform/language/resources/provisioners/syntax):
104104

105105
> ... they [...] add a considerable amount of complexity and uncertainty to Terraform usage.[...] we still recommend attempting to solve it [your problem] using other techniques first, and use provisioners only if there is no other option.
106106

.github/ISSUE_TEMPLATE/bug_report.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ body:
3030
* Set defaults on (or omit) any variables. The person reproducing it should not need to invent variable settings
3131
* If multiple steps are required, such as running terraform twice, consider scripting it in a simple shell script. Providing a script can be easier than explaining what changes to make to the config between runs.
3232
* Omit any unneeded complexity: remove variables, conditional statements, functions, modules, providers, and resources that are not needed to trigger the bug
33-
* When possible, use the [null resource](https://www.terraform.io/docs/providers/null/resource.html) provider rather than a real provider in order to minimize external dependencies. We know this isn't always feasible. The Terraform Core team doesn't have deep domain knowledge in every provider, or access to every cloud platform for reproduction cases.
33+
* When possible, use the [terraform_data resource](https://developer.hashicorp.com/terraform/language/resources/terraform-data) provider rather than a real provider in order to minimize external dependencies. We know this isn't always feasible. The Terraform Core team doesn't have deep domain knowledge in every provider, or access to every cloud platform for reproduction cases.
3434
3535
- type: textarea
3636
id: tf-version

.github/ISSUE_TEMPLATE/documentation_issue.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ body:
1010
value: |
1111
# Thank you for opening a documentation change request.
1212
13-
Please only use the [hashicorp/terraform](https://github.com/hashicorp/terraform) `Documentation` issue type to report problems with the documentation on [https://www.terraform.io/docs](). Only technical writers (not engineers) monitor this issue type. Report Terraform bugs or feature requests with the `Bug report` or `Feature Request` issue types instead to get engineering attention.
13+
Please only use the [hashicorp/terraform](https://github.com/hashicorp/terraform) `Documentation` issue type to report problems with the documentation on [https://developer.hashicorp.com/terraform/docs](). Only technical writers (not engineers) monitor this issue type. Report Terraform bugs or feature requests with the `Bug report` or `Feature Request` issue types instead to get engineering attention.
1414
1515
For general usage questions, please see: https://www.terraform.io/community.html.
1616

README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
- Website: https://www.terraform.io
44
- Forums: [HashiCorp Discuss](https://discuss.hashicorp.com/c/terraform-core)
5-
- Documentation: [https://www.terraform.io/docs/](https://www.terraform.io/docs/)
5+
- Documentation: [https://developer.hashicorp.com/terraform/docs](https://developer.hashicorp.com/terraform/docs)
66
- Tutorials: [HashiCorp's Learn Platform](https://learn.hashicorp.com/terraform)
77
- Certification Exam: [HashiCorp Certified: Terraform Associate](https://www.hashicorp.com/certification/#hashicorp-certified-terraform-associate)
88

build.Dockerfile

+1-1
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ LABEL org.opencontainers.image.title=${BIN_NAME} \
3737
org.opencontainers.image.description="Terraform enables you to safely and predictably create, change, and improve infrastructure" \
3838
org.opencontainers.image.authors="HashiCorp Terraform Team <[email protected]>" \
3939
org.opencontainers.image.url="https://www.terraform.io/" \
40-
org.opencontainers.image.documentation="https://www.terraform.io/docs" \
40+
org.opencontainers.image.documentation="https://developer.hashicorp.com/terraform/docs" \
4141
org.opencontainers.image.source="https://github.com/hashicorp/terraform" \
4242
org.opencontainers.image.version=${PRODUCT_VERSION} \
4343
org.opencontainers.image.revision=${PRODUCT_REVISION} \

docs/README.md

+2-3
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ This directory contains some documentation about the Terraform Core codebase,
44
aimed at readers who are interested in making code contributions.
55

66
If you're looking for information on _using_ Terraform, please instead refer
7-
to [the main Terraform CLI documentation](https://www.terraform.io/docs/cli/index.html).
7+
to [the main Terraform CLI documentation](https://developer.hashicorp.com/terraform/docs).
88

99
## Terraform Core Architecture Documents
1010

@@ -25,8 +25,7 @@ to [the main Terraform CLI documentation](https://www.terraform.io/docs/cli/inde
2525
changes to those behaviors or if you are implementing a new Terraform plugin
2626
SDK and so wish to conform to them.
2727

28-
(If you are planning to write a new provider using the _official_ SDK then
29-
please refer to [the Extend documentation](https://www.terraform.io/docs/extend/index.html)
28+
(If you are planning to write a new provider, please refer to [the documentation](https://developer.hashicorp.com/terraform/plugin)
3029
instead; it presents similar information from the perspective of the SDK
3130
API, rather than the plugin wire protocol.)
3231

docs/architecture.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ object that describes an action to be taken.
4343
An _operation_ consists of:
4444

4545
* The action to be taken (e.g. "plan", "apply").
46-
* The name of the [workspace](https://www.terraform.io/docs/state/workspaces.html)
46+
* The name of the [workspace](https://developer.hashicorp.com/terraform/language/state/workspaces)
4747
where the action will be taken.
4848
* Root module input variables to use for the action.
4949
* For the "plan" operation, a path to the directory containing the configuration's root module.

docs/planning-behaviors.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ their behaviors in a way comparable to the resource instance behaviors.
2020

2121
This is developer-oriented documentation rather than user-oriented
2222
documentation. See
23-
[the main Terraform documentation](https://www.terraform.io/docs) for
23+
[the main Terraform documentation](https://developer.hashicorp.com/terraform/docs) for
2424
information on existing planning behaviors and other behaviors as viewed from
2525
an end-user perspective.
2626

docs/plugin-protocol/README.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ the SDK's API.
1010
----
1111

1212
**If you want to write a plugin for Terraform, please refer to
13-
[Extending Terraform](https://www.terraform.io/docs/extend/index.html) instead.**
13+
[Extending Terraform](https://developer.hashicorp.com/terraform/plugin) instead.**
1414

1515
This documentation is for those who are developing _Terraform SDKs_, rather
1616
than those implementing plugins.
@@ -244,4 +244,4 @@ Now, you can begin to introduce your changes to the `.proto` files. See the next
244244
* This will use the symlinks in the `internal/tfplugin*` directories to access the latest minor versions' `.proto` files.
245245
* You should see diffs in `internal/tfplugin5/tfplugin5.pb.go` and `internal/tfplugin6/tfplugin6.pb.go`.
246246
5) Run `make generate`.
247-
* You should see diffs in `internal/plugin/mock_proto/mock.go` and `internal/plugin6/mock_proto/mock.go`.
247+
* You should see diffs in `internal/plugin/mock_proto/mock.go` and `internal/plugin6/mock_proto/mock.go`.

docs/plugin-protocol/object-wire-format.md

+2-2
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ The key-value pairs representing nested block types have values based on
6363
The MessagePack serialization of an attribute value depends on the value of the
6464
`type` field of the corresponding `Schema.Attribute` message. The `type` field is
6565
a compact JSON serialization of a
66-
[Terraform type constraint](https://www.terraform.io/docs/configuration/types.html),
66+
[Terraform type constraint](https://developer.hashicorp.com/terraform/language/expressions/type-constraints),
6767
which consists either of a single
6868
string value (for primitive types) or a two-element array giving a type kind
6969
and a type argument.
@@ -212,7 +212,7 @@ The properties representing nested block types have property values based on
212212
The JSON serialization of an attribute value depends on the value of the `type`
213213
field of the corresponding `Schema.Attribute` message. The `type` field is
214214
a compact JSON serialization of a
215-
[Terraform type constraint](https://www.terraform.io/docs/configuration/types.html),
215+
[Terraform type constraint](https://developer.hashicorp.com/terraform/language/expressions/type-constraints),
216216
which consists either of a single
217217
string value (for primitive types) or a two-element array giving a type kind
218218
and a type argument.

internal/backend/remote-state/s3/backend.go

+1-1
Original file line numberDiff line numberDiff line change
@@ -903,7 +903,7 @@ func (b *Backend) Configure(obj cty.Value) tfdiags.Diagnostics {
903903
cfg := &awsbase.Config{
904904
AccessKey: stringAttr(obj, "access_key"),
905905
APNInfo: stdUserAgentProducts(),
906-
CallerDocumentationURL: "https://www.terraform.io/docs/language/settings/backends/s3.html",
906+
CallerDocumentationURL: "https://developer.hashicorp.com/terraform/language/backend/s3",
907907
CallerName: "S3 Backend",
908908
Logger: baselog,
909909
MaxRetries: intAttrDefault(obj, "max_retries", 5),
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
{"plan_format_version":"1.1","resource_drift":[],"resource_changes":[{"address":"null_resource.foo","mode":"managed","type":"null_resource","name":"foo","provider_name":"registry.terraform.io/hashicorp/null","change":{"actions":["create"],"before":null,"after":{"triggers":null},"after_unknown":{"id":true},"before_sensitive":false,"after_sensitive":{}}}],"relevant_attributes":[],"output_changes":{"complex":{"actions":["create"],"before":null,"after":{"keyA":{"someList":[1,2,3]},"keyB":{"someBool":true,"someStr":"hello"}},"after_unknown":false,"before_sensitive":false,"after_sensitive":false},"secret":{"actions":["create"],"before":null,"after":"8517896e47af3c9ca19a694ea0d6cc30b0dccf08598f33d93e583721fd5f3032","after_unknown":false,"before_sensitive":true,"after_sensitive":true},"simple":{"actions":["create"],"before":null,"after":["some","list"],"after_unknown":false,"before_sensitive":false,"after_sensitive":false}},"provider_schemas":{"registry.terraform.io/hashicorp/null":{"provider":{"version":0,"block":{"description_kind":"plain"}},"resource_schemas":{"null_resource":{"version":0,"block":{"attributes":{"id":{"type":"string","description":"This is set to a random value at create time.","description_kind":"plain","computed":true},"triggers":{"type":["map","string"],"description":"A map of arbitrary strings that, when changed, will force the null resource to be replaced, re-running any associated provisioners.","description_kind":"plain","optional":true}},"description":"The `null_resource` resource implements the standard resource lifecycle but takes no further action.\n\nThe `triggers` argument allows specifying an arbitrary set of values that, when changed, will cause the resource to be replaced.","description_kind":"plain"}}},"data_source_schemas":{"null_data_source":{"version":0,"block":{"attributes":{"has_computed_default":{"type":"string","description":"If set, its literal value will be stored and returned. If not, its value defaults to `\"default\"`. This argument exists primarily for testing and has little practical use.","description_kind":"plain","optional":true,"computed":true},"id":{"type":"string","description":"This attribute is only present for some legacy compatibility issues and should not be used. It will be removed in a future version.","description_kind":"plain","deprecated":true,"computed":true},"inputs":{"type":["map","string"],"description":"A map of arbitrary strings that is copied into the `outputs` attribute, and accessible directly for interpolation.","description_kind":"plain","optional":true},"outputs":{"type":["map","string"],"description":"After the data source is \"read\", a copy of the `inputs` map.","description_kind":"plain","computed":true},"random":{"type":"string","description":"A random value. This is primarily for testing and has little practical use; prefer the [hashicorp/random provider](https://registry.terraform.io/providers/hashicorp/random) for more practical random number use-cases.","description_kind":"plain","computed":true}},"description":"The `null_data_source` data source implements the standard data source lifecycle but does not\ninteract with any external APIs.\n\nHistorically, the `null_data_source` was typically used to construct intermediate values to re-use elsewhere in configuration. The\nsame can now be achieved using [locals](https://www.terraform.io/docs/language/values/locals.html).\n","description_kind":"plain","deprecated":true}}}}},"provider_format_version":"1.0"}
1+
{"plan_format_version":"1.1","resource_drift":[],"resource_changes":[{"address":"null_resource.foo","mode":"managed","type":"null_resource","name":"foo","provider_name":"registry.terraform.io/hashicorp/null","change":{"actions":["create"],"before":null,"after":{"triggers":null},"after_unknown":{"id":true},"before_sensitive":false,"after_sensitive":{}}}],"relevant_attributes":[],"output_changes":{"complex":{"actions":["create"],"before":null,"after":{"keyA":{"someList":[1,2,3]},"keyB":{"someBool":true,"someStr":"hello"}},"after_unknown":false,"before_sensitive":false,"after_sensitive":false},"secret":{"actions":["create"],"before":null,"after":"8517896e47af3c9ca19a694ea0d6cc30b0dccf08598f33d93e583721fd5f3032","after_unknown":false,"before_sensitive":true,"after_sensitive":true},"simple":{"actions":["create"],"before":null,"after":["some","list"],"after_unknown":false,"before_sensitive":false,"after_sensitive":false}},"provider_schemas":{"registry.terraform.io/hashicorp/null":{"provider":{"version":0,"block":{"description_kind":"plain"}},"resource_schemas":{"null_resource":{"version":0,"block":{"attributes":{"id":{"type":"string","description":"This is set to a random value at create time.","description_kind":"plain","computed":true},"triggers":{"type":["map","string"],"description":"A map of arbitrary strings that, when changed, will force the null resource to be replaced, re-running any associated provisioners.","description_kind":"plain","optional":true}},"description":"The `null_resource` resource implements the standard resource lifecycle but takes no further action.\n\nThe `triggers` argument allows specifying an arbitrary set of values that, when changed, will cause the resource to be replaced.","description_kind":"plain"}}},"data_source_schemas":{"null_data_source":{"version":0,"block":{"attributes":{"has_computed_default":{"type":"string","description":"If set, its literal value will be stored and returned. If not, its value defaults to `\"default\"`. This argument exists primarily for testing and has little practical use.","description_kind":"plain","optional":true,"computed":true},"id":{"type":"string","description":"This attribute is only present for some legacy compatibility issues and should not be used. It will be removed in a future version.","description_kind":"plain","deprecated":true,"computed":true},"inputs":{"type":["map","string"],"description":"A map of arbitrary strings that is copied into the `outputs` attribute, and accessible directly for interpolation.","description_kind":"plain","optional":true},"outputs":{"type":["map","string"],"description":"After the data source is \"read\", a copy of the `inputs` map.","description_kind":"plain","computed":true},"random":{"type":"string","description":"A random value. This is primarily for testing and has little practical use; prefer the [hashicorp/random provider](https://registry.terraform.io/providers/hashicorp/random) for more practical random number use-cases.","description_kind":"plain","computed":true}},"description":"The `null_data_source` data source implements the standard data source lifecycle but does not\ninteract with any external APIs.\n\nHistorically, the `null_data_source` was typically used to construct intermediate values to re-use elsewhere in configuration. The\nsame can now be achieved using [locals](https://developer.hashicorp.com/terraform/language/values/locals).\n","description_kind":"plain","deprecated":true}}}}},"provider_format_version":"1.0"}

internal/cloud/testdata/apply-json-with-provisioner-error/plan-redacted.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@
104104
"computed": true
105105
}
106106
},
107-
"description": "The `null_data_source` data source implements the standard data source lifecycle but does not\ninteract with any external APIs.\n\nHistorically, the `null_data_source` was typically used to construct intermediate values to re-use elsewhere in configuration. The\nsame can now be achieved using [locals](https://www.terraform.io/docs/language/values/locals.html).\n",
107+
"description": "The `null_data_source` data source implements the standard data source lifecycle but does not\ninteract with any external APIs.\n\nHistorically, the `null_data_source` was typically used to construct intermediate values to re-use elsewhere in configuration. The\nsame can now be achieved using [locals](https://developer.hashicorp.com/terraform/language/values/locals).\n",
108108
"description_kind": "plain",
109109
"deprecated": true
110110
}

internal/cloud/testdata/apply-json-with-provisioner/plan-redacted.json

+1-1
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@
104104
"computed": true
105105
}
106106
},
107-
"description": "The `null_data_source` data source implements the standard data source lifecycle but does not\ninteract with any external APIs.\n\nHistorically, the `null_data_source` was typically used to construct intermediate values to re-use elsewhere in configuration. The\nsame can now be achieved using [locals](https://www.terraform.io/docs/language/values/locals.html).\n",
107+
"description": "The `null_data_source` data source implements the standard data source lifecycle but does not\ninteract with any external APIs.\n\nHistorically, the `null_data_source` was typically used to construct intermediate values to re-use elsewhere in configuration. The\nsame can now be achieved using [locals](https://developer.hashicorp.com/terraform/language/values/locals).\n",
108108
"description_kind": "plain",
109109
"deprecated": true
110110
}

0 commit comments

Comments
 (0)