Skip to content

Add Durable AI landing page (/ai) and move AI Cookbook under it - #5130

Merged
Duncanma merged 19 commits into
mainfrom
ai-landing-page
Aug 20, 2026
Merged

Add Durable AI landing page (/ai) and move AI Cookbook under it#5130
Duncanma merged 19 commits into
mainfrom
ai-landing-page

Conversation

@Duncanma

@Duncanma Duncanma commented Aug 17, 2026

Copy link
Copy Markdown
Contributor

What does this PR do?

Replaces the top-nav "AI Cookbook" link with a Durable AI landing page at /ai that gives AI development a proper home in the docs, and moves the AI Cookbook under it at /ai/cookbook (previously /ai-cookbook).

The new /ai page pulls together:

  • An intro covering Durable Execution for AI systems and the four recurring shapes it shows up in (Agents, Processing pipelines, Internal agent platforms, Model training), each linking to relevant design patterns
  • A preview of the AI Cookbook (top recipes + a "browse all" card)
  • Agent framework integrations (pre-filtered IntegrationsGrid)
  • A new "Featured from the Code Exchange" section spotlighting hand-picked community/sample projects, with SDK-language icons and topic tags
  • Design patterns relevant to AI agents

Supporting changes:

  • Shared GridCard/GridCardList components so Cookbook, Integrations, Guides, and Code Exchange cards all share one visual language (SDK icon, tags, external-link indicator, hover state) instead of drifting independently. The external-link icon is now suppressed for links that stay on temporal.io (e.g. Code Exchange), since those aren't really "leaving" Temporal — they still open in a new tab.
  • SDK icon coverage extended to all 8 official Temporal SDKs (added .NET, PHP, Rust) so Code Exchange samples in those languages get a proper icon.
  • Query-string filter persistence for IntegrationsGrid/GuidesGrid — filtered views are now shareable/deep-linkable, with human-readable comma-separated values, and only the visible filter groups sync to the URL.
  • hideEmptyOptions option on IntegrationsGrid/GuidesGrid to hide filter pills that would match nothing given the current selection.
  • Redirects added/fixed in vercel.json for the /ai-cookbook/ai/cookbook move, including ordering so specific slug redirects aren't shadowed by the general wildcard.
  • Sidebar and readme/INFORMATION-ARCHITECTURE.md updated with the new "Durable AI" section.
  • LLM Markdown pipeline: new handlers for CookbookPreview and GridCardList, IntegrationsGrid's handler extended for defaultTags, and the shared cards.mjs handler extended to render SDK/tag metadata (and fixed to stop truncating descriptions at an apostrophe).
  • Minor Vale rule tweaks: "AI Cookbook" and "Code Exchange" added as recognized proper nouns, and an unhelpful "agent → personal digital assistant" suggestion removed.
  • Test coverage added/updated across the above (component-handler unit tests, Playwright cookbook-home spec).

Notes to reviewers

  • The Code Exchange section is a small, hand-curated list of external projects (no live sync) — expected to be updated manually as good examples come up.
  • If you touch vercel.json further, keep the specific slug-alias redirects ahead of the general /ai-cookbook/:path* wildcard, or they'll get shadowed.
  • A follow-up idea (a "Samples Matrix" surfacing per-plugin/language/feature-category sample coverage from the samples-* repos) was discussed but is intentionally out of scope here.

┆Attachments: EDU-6976 Ai landing page

…bookPreview and useCookbookItems hooks

- Updated .gitignore to properly ignore the ai-cookbook directory.
- Introduced CookbookPreview component to display a preview of AI Cookbook recipes.
- Created useCookbookItems hook for consistent recipe data retrieval across components.
- Refactored CookbookHome to utilize the new hook and GridCard for rendering.
- Enhanced IntegrationsGrid to support defaultTags filtering.
- Added new high-priority and no-priority recipe fixtures for testing.
- Updated styles for Cookbook components to ensure consistent layout and design.
- Refactored CookbookPreview to calculate and display the number of remaining recipes.
- Added a new GridCard to link to the full AI Cookbook when there are additional recipes available.
- Removed unused Link import for cleaner code.
Copilot AI balanced review requested due to automatic review settings August 17, 2026 22:43
@vercel

vercel Bot commented Aug 17, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview Aug 20, 2026 9:27pm

Request Review

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Comment thread docs/ai/index.mdx
@github-actions

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

… projects section

- Added GridCardList component to showcase community projects in the AI section.
- Updated AI index page to include a featured projects section with links and descriptions.
- Modified PatternCards component to accept an optional className prop for styling.
- Updated component registry and documentation to reflect new additions and changes.
- Improved parsing logic for card items to include tags and SDK information.
- Enhanced styling for featured cards to visually distinguish them on the page.
Comment thread docs/ai/index.mdx
- Updated the description in the AI index page
- Removed Vale suggestion to replace "agent" with "personal digital assistant"
- Added "Cookbook" and "Code Exchange" as proper nouns in Temporal headings to reduce false positives
@Duncanma
Duncanma marked this pull request as ready for review August 20, 2026 20:16
@Duncanma
Duncanma requested a review from a team as a code owner August 20, 2026 20:16
@Duncanma Duncanma changed the title Ai landing page Add Durable AI landing page (/ai) and move AI Cookbook under it Aug 20, 2026
@Duncanma
Duncanma enabled auto-merge (squash) August 20, 2026 20:31
@Duncanma
Duncanma enabled auto-merge (squash) August 20, 2026 21:25
@Duncanma
Duncanma merged commit 704adfd into main Aug 20, 2026
15 checks passed
@Duncanma
Duncanma deleted the ai-landing-page branch August 20, 2026 21:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants