docs: Document usage of Plural Terraform provider from Pulumi

[maciaszczykm]

Plural Flow: docs
Plural Preview: docs

[linear]

PROD-5102

[plural-copilot]

✅ Deploy preview for docs-pr-613 is ready!

Name	Details
⚡ Service	docs-pr-613 (5 / 5 ready)
☁️ Cluster	plural (eks)
Commit sha	f7d6652
Plural URL	https://console.mgmt.plural.sh/cd/clusters/446acdef-8524-425a-a49f-5336a...
🔍 Logs URL	https://console.mgmt.plural.sh/cd/clusters/446acdef-8524-425a-a49f-5336a...
🌊 Flow URL	https://console.mgmt.plural.sh/flows/08a17af1-8578-449e-9ae1-28ccd97eafc...
Preview Link	Preview

---

You can learn more about preview environments and Plural Flows here

[greptile-apps]

Greptile Summary

This PR adds documentation for consuming the Plural Terraform provider from Pulumi and integrates the new guide into API-reference and Stacks navigation.

• Moves the Terraform provider reference to an index page so it can contain child documentation.
• Adds Pulumi bridge setup, authentication guidance, a Python example, and Terraform-to-Pulumi API mappings.
• Adds cross-links, navigation metadata, legacy doclink mapping, and generated routes.

Confidence Score: 4/5

The broken copyable setup command should be corrected before merging because it prevents readers from reaching Pulumi package generation as documented.

The new guide places <version> directly in a Bash command, where the shell treats it as input redirection and fails before invoking Pulumi.

Files Needing Attention: pages/api-reference/terraform/pulumi.md

Important Files Changed

Filename	Overview
pages/api-reference/terraform/pulumi.md	Adds the Pulumi bridge guide and Python example, but its setup block contains a shell placeholder that makes the displayed command fail when copied unchanged.
pages/api-reference/terraform/index.md	Moves and expands the Terraform provider overview while preserving its public route.
src/routing/docs-structure.ts	Registers the new Pulumi guide as a nested Terraform reference section using the repository's existing routing pattern.
generated/routes.json	Updates the Terraform parent path and adds the Pulumi child route consistently with the moved and new Markdown files.
src/markdoc/tags/doclink.tsx	Adds a legacy document-ID mapping for the existing Pulumi Stacks page.

_{Reviews (1): Last reviewed commit: "document usage of Plural Terraform provi..." | Re-trigger Greptile}

[greptile-apps]

Version placeholder breaks shell command

When a reader copies this setup command as shown, Bash interprets <version> as input redirection from a file named version, causing the command to fail before Pulumi can generate the SDK.

Suggested change

	pulumi package add terraform-provider pluralsh/plural <version>
	pulumi package add terraform-provider pluralsh/plural 0.2.38