Add the rest of the redirects for Sentinel, TFC, TF and the plugin framework #1331

rkoron007 · 2025-11-18T19:34:14Z

Adding the redirects for the first 163 rows (everything above the orange line) in the 404 sheet!

github-actions · 2025-11-18T19:37:03Z

Vercel Previews Deployed

Name	Status	Preview	Updated (UTC)
Dev Portal	✅ Ready (Inspect)	Visit Preview	Tue Dec 2 21:18:54 UTC 2025
Unified Docs API	✅ Ready (Inspect)	Visit Preview	Tue Dec 2 21:13:19 UTC 2025

github-actions · 2025-11-18T20:03:22Z

Broken Link Checker

No broken links found! 🎉

rkoron007 · 2025-11-18T23:32:58Z

content/terraform-docs-common/redirects.jsonc

  },
+  // HCP Terraform rebranding
  {
-    "source": "/terraform/language/settings/terraform-cloud",


I moved all the terraform/language/settings/terraform-cloud redirects down together below!

rkoron007 · 2025-11-18T23:33:13Z

content/terraform-docs-common/redirects.jsonc

    "permanent": true
  },
 // Reorg terraform block reference
-  {


Same here, I moved all these + versioning below

rkoron007 · 2025-11-18T23:33:39Z

content/terraform-docs-common/redirects.jsonc

    "permanent": true
  },
-  {
-     "source": "/terraform/language/v:version(1\\.(?:[1-9]|1[01])\\.x)/validate",


Checks is a better redirect here, so doing that instead!

rkoron007 · 2025-11-18T23:34:02Z

content/terraform-docs-common/redirects.jsonc

-  },
-  // /terraform → block/terraform
-  {
-    "source": "/terraform/language/terraform",


Moving this with all the terraform settings redirects below

rkoron007 · 2025-11-18T23:38:23Z

content/terraform-docs-common/redirects.jsonc

+    "permanent": true
+  },
+  {
+    "source": "/terraform/cli/v:version(1\\.(?:1[1-9]|[2-9]\\d)\\.x|[2-9]\\d*\\.\\d+\\.x)/commands/env",


For these 1.10.x links, instead of letting all future versions 404 I boot them to the last time this page existed because it has an explicit deprecation notice.

rkoron007 · 2025-11-18T23:39:18Z

content/terraform-docs-common/redirects.jsonc

+    "permanent": true
+  },
+  {
+    "source": "/terraform/cloud-docs/api-docs/admin/:slug",


There is no admin API for TFC, so I just boot them to the main page. I figure that's better than a 404, and they can see in the sidebar that Admin doesn't exist.

I think you need a redirect for the /admin and one for /admin/:slug. Otherwise, the path the just /admin won't work.

rkoron007 · 2025-11-18T23:40:16Z

content/terraform-docs-common/redirects.jsonc

+    "permanent": true
+  },
+  {
+    "source": "/terraform/cloud-docs/workspaces/run",


No overview page, so booting to the first page available.

If we don't already have one, we should create task to write a proper overview or concept page about runs and remove this redirect after publishing it.

rkoron007 · 2025-11-18T23:41:24Z

content/terraform-docs-common/redirects.jsonc

+  },
+  {
+    "source": "/terraform/intro/v:version(1\\.(?:1|2|3|4|5|6|7|8)\\.x)/phases/:slug*",
+    "destination": "/terraform/intro/phases/:slug*",


I don't use versions for any of the intro links, because folks should always see the most up to date version!

rkoron007 · 2025-11-18T23:42:40Z

content/terraform-docs-common/redirects.jsonc

+  },
+  {
+    "source": "/terraform/language/v:version(1\\.(?:[3-9]|[1-9]\\d)\\.x|[2-9]\\d*\\.\\d+\\.x)/functions/defaults",
+    "destination": "/terraform/language/v:version/functions",


The main page felt like the best place to redirect to.

rkoron007 · 2025-11-18T23:43:20Z

content/terraform-docs-common/redirects.jsonc

+  },
+  {
+    "source": "/terraform/language/configuration-0-11/:slug*",
+    "destination": "/terraform/language/v1.1.x/configuration-0-11/:slug*",


These are only on 1.1, so I redirect there.

rkoron007 · 2025-11-18T23:44:32Z

content/terraform-docs-common/redirects.jsonc

+    "permanent": true
+  },
+  {
+    "source": "/terraform/cli/v:version(1\\.(?:1[1-9]|[2-9]\\d)\\.x|[2-9]\\d*\\.\\d+\\.x)/import/importability",


This page went away, so I just redirect to the related page in sdkv2

trujillo-adam

Looks great! Almost everything seems to work. I found a few places where the "v" was left out of the expression, but I'm not positive that my suggestions added it to the correct place.

There is also some inconsistency where the site redirects on the path segment before the slug but not others. I wonder if it has to do with the implied index.mdx, versus the folder name?

Approving so you can merge after having a look.

Thanks for cleaning up all of our messes.

trujillo-adam · 2025-12-02T18:17:40Z

content/terraform-docs-common/redirects.jsonc

+    "source": "/terraform/language/v:version(1\\.(?:1|2|3|4|5|6|7|8|9|10|11)\\.x)/state/remove",
+    "destination": "/terraform/cli/:version/commands/state/rm",
+    "permanent": true


Suggested change

"source": "/terraform/language/v:version(1\\.(?:1|2|3|4|5|6|7|8|9|10|11)\\.x)/state/remove",

"destination": "/terraform/cli/:version/commands/state/rm",

"permanent": true

"source": "/terraform/language/v:version(v1\\.(?:1|2|3|4|5|6|7|8|9|10|11)\\.x)/state/remove",

"destination": "/terraform/cli/:version/commands/state/rm",

"permanent": true

Right? When the site switches to the destination, it is leaving out the "v" part of the version string.

content/terraform-docs-common/redirects.jsonc

trujillo-adam · 2025-12-02T18:53:40Z

content/terraform-docs-common/redirects.jsonc

+    "source": "/terraform/cli/v:version(1\\.(?:1|2|3|4|5)\\.x)/test",
+    "destination": "/terraform/cli/:version/commands/test",
+    "permanent": true


Suggested change

"source": "/terraform/cli/v:version(1\\.(?:1|2|3|4|5)\\.x)/test",

"destination": "/terraform/cli/:version/commands/test",

"permanent": true

"source": "/terraform/cli/:version(v1\\.(?:1|2|3|4|5)\\.x)/test",

"destination": "/terraform/cli/:version/commands/test",

"permanent": true

Double check this regex. The same thing is happening for this one as line 777

trujillo-adam · 2025-12-02T19:16:10Z

content/terraform-docs-common/redirects.jsonc

+    "permanent": true
+  },
+  {
+    "source": "/terraform/cloud-docs/api-docs/admin/:slug",


I think you need a redirect for the /admin and one for /admin/:slug. Otherwise, the path the just /admin won't work.

trujillo-adam · 2025-12-02T19:55:37Z

content/terraform-docs-common/redirects.jsonc

+    "permanent": true
+  },
+  {
+    "source": "/terraform/cloud-docs/workspaces/run",


If we don't already have one, we should create task to write a proper overview or concept page about runs and remove this redirect after publishing it.

trujillo-adam · 2025-12-02T20:01:27Z

content/terraform-docs-common/redirects.jsonc

+  {
+    "source": "/terraform/language/v:version(1\\.(?:1|2|3|4|5|6|7|8)\\.x)/backend/:slug*",
+    "destination": "/terraform/language/v:version/settings/backends/:slug*",
+    "permanent": true
+  },


Suggested change

{

"source": "/terraform/language/v:version(1\\.(?:1|2|3|4|5|6|7|8)\\.x)/backend/:slug*",

"destination": "/terraform/language/v:version/settings/backends/:slug*",

"permanent": true

},

{

"source": "/terraform/language/v:version(1\\.(?:1|2|3|4|5|6|7|8)\\.x)/backend/:slug*",

"destination": "/terraform/language/v:version/settings/backends/:slug*",

"permanent": true

},

I think you also need this one without the slug because, for example, /terraform/language/v1.8.x/settings/backend, isn't redirecting

Actually, I don't know why this one isn't working. The preview is redirecting some paths on the segment before the slug but not others.

trujillo-adam · 2025-12-02T20:43:38Z

content/sentinel/v0.40.x/redirects.jsonc

+    "source": "/sentinel/docs/:version(0\\.(?:27|28|29|30)\\.x)/docs/features/terraform/tfconfig-v2",
+    "destination": "/sentinel/docs/:version/features/terraform/tfconfig-v2",
+    "permanent": true


Suggested change

"source": "/sentinel/docs/:version(0\\.(?:27|28|29|30)\\.x)/docs/features/terraform/tfconfig-v2",

"destination": "/sentinel/docs/:version/features/terraform/tfconfig-v2",

"permanent": true

"source": "/sentinel/docs/:version(v0\\.(?:27|28|29|30)\\.x)/docs/features/terraform/tfconfig-v2",

"destination": "/sentinel/docs/:version/features/terraform/tfconfig-v2",

"permanent": true

Missing the "v" somewhere. I think this is where it's supposed to go.

trujillo-adam · 2025-12-02T20:44:52Z

content/sentinel/v0.40.x/redirects.jsonc

+    "source": "/sentinel/docs/:version(0\\.(?:27|28|29|30)\\.x)/docs/features/terraform/tfplan-v2",
+    "destination": "/sentinel/docs/:version/features/terraform/tfplan-v2",
+    "permanent": true


Suggested change

"source": "/sentinel/docs/:version(0\\.(?:27|28|29|30)\\.x)/docs/features/terraform/tfplan-v2",

"destination": "/sentinel/docs/:version/features/terraform/tfplan-v2",

"permanent": true

"source": "/sentinel/docs/:version(v0\\.(?:27|28|29|30)\\.x)/docs/features/terraform/tfplan-v2",

"destination": "/sentinel/docs/:version/features/terraform/tfplan-v2",

"permanent": true

same here

trujillo-adam · 2025-12-02T20:45:22Z

content/sentinel/v0.40.x/redirects.jsonc

+    "source": "/sentinel/docs/:version(0\\.(?:27|28|29|30)\\.x)/docs/features/terraform/tfstate-v2",
+    "destination": "/sentinel/docs/:version/features/terraform/tfstate-v2",
+    "permanent": true


Suggested change

"source": "/sentinel/docs/:version(0\\.(?:27|28|29|30)\\.x)/docs/features/terraform/tfstate-v2",

"destination": "/sentinel/docs/:version/features/terraform/tfstate-v2",

"permanent": true

"source": "/sentinel/docs/:version(v0\\.(?:27|28|29|30)\\.x)/docs/features/terraform/tfstate-v2",

"destination": "/sentinel/docs/:version/features/terraform/tfstate-v2",

"permanent": true

And here.

Co-authored-by: trujillo-adam <[email protected]>

rkoron007 added 2 commits November 18, 2025 08:12

Adding the rest of the redirects

bf55fbb

Finish first try

526987a

rkoron007 requested review from a team as code owners November 18, 2025 19:34

rkoron007 self-assigned this Nov 18, 2025

github-actions bot added HCP Terraform Sentinel Sentinel documentation labels Nov 18, 2025

Merge branch 'main' into RK/tf-tfc-sentinel-fixes

f8d97ba

rkoron007 and others added 5 commits November 18, 2025 13:42

Add all the redirects from the big TFE PR

e013d63

A couple more duplicates snuck in

4431a5b

Separate duplicate

0107715

Merge branch 'main' into RK/tf-tfc-sentinel-fixes

d5e31a9

remove circular redirects

79735bb

rkoron007 commented Nov 18, 2025

View reviewed changes

explicit version

8d99ab6

trujillo-adam approved these changes Dec 2, 2025

View reviewed changes

Update content/terraform-docs-common/redirects.jsonc

e8a6f8b

Co-authored-by: trujillo-adam <[email protected]>

Add the rest of the redirects for Sentinel, TFC, TF and the plugin framework #1331

Are you sure you want to change the base?

Add the rest of the redirects for Sentinel, TFC, TF and the plugin framework #1331

Conversation

rkoron007 commented Nov 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Nov 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Vercel Previews Deployed

Uh oh!

github-actions bot commented Nov 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Broken Link Checker

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

rkoron007 Nov 18, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

trujillo-adam left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

rkoron007 commented Nov 18, 2025 •

edited

Loading

github-actions bot commented Nov 18, 2025 •

edited

Loading

github-actions bot commented Nov 18, 2025 •

edited

Loading

rkoron007 Nov 18, 2025 •

edited

Loading