Skip to content

Legacy deep links to documentation on terraform.io no longer redirect to a useful place #36906

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.

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

Closed
apparentlymart opened this issue Apr 18, 2025 · 3 comments
Labels
documentation new new issue not yet triaged

Comments

@apparentlymart
Copy link
Contributor

Terraform Version

irrelevant

Affected Pages

I'm not sure of the full scope of this, but so far it seems to at least be true for the old URLs for the documentation pages of Terraform's built in functions, such as:

https://www.terraform.io/language/functions/templatefile
https://www.terraform.io/language/functions/tolist
https://www.terraform.io/language/functions/merge

What is the docs issue?

Over the last decade or so I've left various answers to questions about Terraform in various locations on the internet, such as Stack Overflow, Reddit, and HashiCorp's own community forums. In those I typically included deep links to documentation pages describing any language features relevant to what I was describing.

The Terraform documentation now lives as part of developer.hashicorp.com. When that change was initially made there were fine-grain redirects in place from the old terraform.io pages to their equivalent new developer.hashicorp.com/terraform pages, but at some point recently those seem to have all just started redirecting to the main Terraform landing page at https://developer.hashicorp.com/terraform.

Those various historical answers are therefore now considerably less useful. I'm sure I'm not the only one that has shared deep links to various parts of the Terraform documentation.

Proposal

It would be nice to restore the fine-grain redirects to individual pages that were originally put in place when moving this documentation to the new domain name.

I understand that there's probably no longer a one-to-one correspondence for every single page that was previously present on terraform.io, but overall the documentation structure for the "Configuration Language" section still seems to be mostly the same as I remember it being when I created many of these links.

References

No response

@apparentlymart apparentlymart added documentation new new issue not yet triaged labels Apr 18, 2025
@crw
Copy link
Contributor

crw commented Apr 18, 2025

I'll inform the docs team. This change rolled out last week. Thanks for the report.

@crw
Copy link
Contributor

crw commented Apr 18, 2025

Thanks again for reporting this @apparentlymart. I did not want to speak without having the full information, but this was considered a regression and not the expected behavior. The web team has pushed a change that should properly handle these redirects. Please let me know if you are seeing continued issues with any particular type of link.

@crw crw closed this as completed Apr 18, 2025
@apparentlymart
Copy link
Contributor Author

All of the examples I have handy for testing seem to be working again now. Thanks!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation new new issue not yet triaged
Projects
None yet
Development

No branches or pull requests

2 participants