Add Bun runtime documentation

[jkodroff]

Documents Bun as a first-class runtime (runtime: bun) alongside Node.js, with incompatibility warnings for function serialization, dynamic providers, and magic Lambda functions across relevant pages.

Fixes pulumi/pulumi#22040
Fixes #17923

[jkodroff]

Marked do-not-merge since the release has not yet gone out.

[claude]

Docs Review — PR #17935

Scope: 6 files changed (+40 −4) — Bun runtime documentation across docs pages.

Overall this is a well-structured PR that adds clear, consistent warnings about Bun's limitations across the relevant pages. A few items to address:

Issues

1. Shortcode syntax inconsistency (STYLE-GUIDE.md violation)

The notes shortcode is listed in STYLE-GUIDE.md as a percent-sign shortcode ({{% notes %}}) because it processes Markdown content. Two of the new additions use angle brackets instead:

• content/docs/iac/concepts/functions/function-serialization.md (line 32): Uses {{< notes type="warning" >}} — the existing notes on this page all use {{% notes %}}, so this is inconsistent both with the style guide and the surrounding file.

• content/docs/iac/clouds/aws/guides/lambda.md (line 141): Uses {{< notes type="warning" >}}.

• content/docs/iac/concepts/providers/dynamic-providers.md (line 35): Correctly uses {{% notes type="warning" %}}.

{{% notes type="warning" %}}

These should all use {{% notes %}} / {{% /notes %}} for consistency with the style guide and surrounding content.

2. Consider linking to Bun on first mention

In content/docs/iac/languages-sdks/javascript/_index.md (line 49), "Bun" is introduced without a hyperlink. Consider linking to bun.sh on first mention to help readers unfamiliar with it:

[Bun](https://bun.sh) is also supported as a first-class runtime.

Similarly, the intro paragraph at line 28 mentions "Bun runtimes" — that could be the first-mention link instead.

Looks good

• The runtime list updates in plugins.md and project-file.md are accurate and correctly add the Oxford comma.
• Warnings are placed logically near the relevant feature descriptions (function serialization, dynamic providers, magic Lambda functions).
• The Bun runtime section in _index.md is well-structured under the existing "Installation requirements" hierarchy.
• Internal links to /docs/iac/concepts/functions/function-serialization/ are correct.
• The "Bun runtime options" section in plugins.md is placed in the right order (after Java, before YAML).

---

Mention me (@claude) if you'd like additional reviews or help with fixes.

🤖 Generated with Claude Code

[pulumi-bot]

Your site preview for commit f523855 is ready! 🎉

http://www-testing-pulumi-docs-origin-pr-17935-f5238552.s3-website.us-west-2.amazonaws.com.

[jkodroff]

@claude Fix the issues you found

[claude]

Claude finished @jkodroff's task in 57s —— View job

---

Fixes applied

• Read the affected files
• Fix shortcode syntax in lambda.md ({{< notes >}} → {{% notes %}})
• Fix shortcode syntax in function-serialization.md ({{< notes >}} → {{% notes %}})
• Add Bun link on first mention in _index.md ([Bun](https://bun.sh))
• Commit and push changes

All three issues from the previous review have been fixed in commit 216250b.
|

[jkodroff]

Assigning to @julienp with the intent that he can merge it once this release goes out (assuming the info is correct, and LGTM).