Skip to content

Commit 371e625

Browse files
Update URLs from www.terraform.io to developer.hashicorp.com` (#36792)
* Update URLs from www.terraform.io to developer.hashicorp.com * More updates to URLs linking to documentation in documentation and user-facing warnings/errors * More updates to URLs linking to documentation, in docs, code, test fixtures * Replace www.terraform.io/community with link to Community Forum * Apply suggestions from code review Co-authored-by: Rose M Koron <[email protected]> --------- Co-authored-by: Rose M Koron <[email protected]>
1 parent d6e1d26 commit 371e625

File tree

29 files changed

+213
-52
lines changed

29 files changed

+213
-52
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

+2-2
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ body:
1212
1313
The [hashicorp/terraform](https://github.com/hashicorp/terraform) issue tracker is reserved for bug reports relating to the core Terraform CLI application and configuration language.
1414
15-
For general usage questions, please see: https://www.terraform.io/community.html.
15+
For general usage questions, please see the [Community Forum](https://discuss.hashicorp.com/c/terraform-core/27).
1616
1717
## If your issue relates to:
1818
* **HCP Terraform or Terraform Enterprise**: please email [email protected] or [open a new request](https://support.hashicorp.com/hc/en-us/requests/new).
@@ -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 [null resource](https://registry.terraform.io/providers/hashicorp/null/latest/docs/resources/resource) 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

+2-2
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ 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
15-
For general usage questions, please see: https://www.terraform.io/community.html.
15+
For general usage questions, please see the [Community Forum](https://discuss.hashicorp.com/c/terraform-core/27).
1616
1717
- type: textarea
1818
id: tf-version

.github/ISSUE_TEMPLATE/feature_request.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ body:
1212
1313
The [hashicorp/terraform](https://github.com/hashicorp/terraform) issue tracker is reserved for feature requests relating to the core Terraform CLI application and configuration language.
1414
15-
For general usage questions, please see: https://www.terraform.io/community.html.
15+
For general usage questions, please see the [Community Forum](https://discuss.hashicorp.com/c/terraform-core/27).
1616
1717
## If your feature request relates to:
1818
* **HCP Terraform or Terraform Enterprise**: please email [email protected] or [open a new request](https://support.hashicorp.com/hc/en-us/requests/new).

README.md

+7-7
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
# Terraform
22

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

99
<img alt="Terraform" src="https://www.datocms-assets.com/2885/1731373310-terraform_white.svg" width="600px">
@@ -24,18 +24,18 @@ For more information, refer to the [What is Terraform?](https://www.terraform.io
2424

2525
## Getting Started & Documentation
2626

27-
Documentation is available on the [Terraform website](https://www.terraform.io):
27+
Documentation is available on the [Terraform website](https://developer.hashicorp.com/terraform):
2828

29-
- [Introduction](https://www.terraform.io/intro)
30-
- [Documentation](https://www.terraform.io/docs)
29+
- [Introduction](https://developer.hashicorp.com/terraform/intro)
30+
- [Documentation](https://developer.hashicorp.com/terraform/docs)
3131

3232
If you're new to Terraform and want to get started creating infrastructure, please check out our [Getting Started guides](https://learn.hashicorp.com/terraform#getting-started) on HashiCorp's learning platform. There are also [additional guides](https://learn.hashicorp.com/terraform#operations-and-development) to continue your learning.
3333

3434
Show off your Terraform knowledge by passing a certification exam. Visit the [certification page](https://www.hashicorp.com/certification/) for information about exams and find [study materials](https://learn.hashicorp.com/terraform/certification/terraform-associate) on HashiCorp's learning platform.
3535

3636
## Developing Terraform
3737

38-
This repository contains only Terraform core, which includes the command line interface and the main graph engine. Providers are implemented as plugins, and Terraform can automatically download providers that are published on [the Terraform Registry](https://registry.terraform.io). HashiCorp develops some providers, and others are developed by other organizations. For more information, see [Extending Terraform](https://www.terraform.io/docs/extend/index.html).
38+
This repository contains only Terraform core, which includes the command line interface and the main graph engine. Providers are implemented as plugins, and Terraform can automatically download providers that are published on [the Terraform Registry](https://registry.terraform.io). HashiCorp develops some providers, and others are developed by other organizations. For more information, refer to [Plugin development](https://developer.hashicorp.com/terraform/plugin).
3939

4040
- To learn more about compiling Terraform and contributing suggested changes, refer to [the contributing guide](.github/CONTRIBUTING.md).
4141

docs/README.md

+2-2
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/cli).
88

99
## Terraform Core Architecture Documents
1010

@@ -26,7 +26,7 @@ to [the main Terraform CLI documentation](https://www.terraform.io/docs/cli/inde
2626
SDK and so wish to conform to them.
2727

2828
(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)
29+
please refer to [the Plugin development documentation](https://developer.hashicorp.com/terraform/plugin)
3030
instead; it presents similar information from the perspective of the SDK
3131
API, rather than the plugin wire protocol.)
3232

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

+1-1
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+
[Plugin development](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.

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),

0 commit comments

Comments
 (0)