refactor(typescript): update /develop/typescript to restructure info by flippedcoder · Pull Request #4179 · temporalio/documentation

flippedcoder · 2026-02-03T17:18:06Z

What does this PR do?

This refactors the /develop/typescript section of the docs to change how we organized content.

adds new activities, client, nexus, workflows, workers, and best practices sub-sections
breaks up the core-applications page into multiple pages that are distributed to the above sub-sections

Notes to reviewers

┆Attachments: EDU-5874 refactor(typescript): update /develop/typescript to restructure info

vercel · 2026-02-03T17:18:12Z

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

Project	Deployment	Actions	Updated (UTC)
temporal-documentation	Ready	Preview, Comment	Mar 19, 2026 4:53pm

github-actions · 2026-02-03T17:18:38Z

📖 Docs PR preview links

Activity Definition
Activity Execution
Child Workflows
Cloud
- Authenticate with mTLS certificates
- Get started
- Manage API keys
- Metrics
  - Prometheus Grafana
Cron Job
Develop
Encyclopedia
- About the SDKs
- Activities
- Event History
  - TypeScript
- Retry Policies
- Workflows
Evaluate
- Development Production Features
Handling Signals, Queries, & Updates
Parent Close Policy
References
- Failures
- SDK metrics
Search Attributes
Self Hosted Guide
- Monitoring
- Namespaces
Sending Signals, Queries, & Updates
Task Queues
Web UI
Workers
Workflow Definition
Workflow Execution overview
- Continue-As-New
- Timers and Start Delays

* fix(task queues): updated pricing info for fairness * chore(task queues): clean up based on feedback

…counted for (#4300)

@flippedcoder

* Clarify message idempotency section * v2 * v3 * Apply suggestion from @flippedcoder * Apply suggestion from @flippedcoder --------- Co-authored-by: Milecia McG <47196133+flippedcoder@users.noreply.github.com>

…nd workflow IDs (#4301) * Strengthen Search Attribute guidance on sensitive data and PII Elevate the existing note about unencrypted Search Attributes to a caution admonition with expanded guidance covering both attribute names and values. Add reasoning about compliance risk (GDPR, HIPAA, SOC 2) and recommend using opaque identifiers instead. Cross-reference the warning from the Default Search Attributes section. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * drop line about hashing * drop heavy handed redirect * Add sensitive data warning to Workflow Id documentation Workflow Ids and other user-defined identifiers (Workflow Type, Task Queue, Activity, Signal/Query/Update names) are stored in plain text and bypass the Payload Codec. Add a caution admonition warning against using PII directly as a Workflow Id, with compliance reasoning (GDPR, HIPAA, SOC 2). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> * docs: add admonition in custom search attribute section in visibility * docs: use more specific anchors --------- Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com> Co-authored-by: Lenny Chen <lenny.chen@temporal.io>

lennessyy

LGTM! This is such an epic refactor. I'm excited for it. Just need to make sure we add all the redirects -- I believe this is a great job for Claude

CLAassistant · 2026-03-25T22:20:42Z

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
3 out of 4 committers have signed the CLA.

✅ dustin-temporal
✅ dandavison
✅ flippedcoder
❌ tlotemporal
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

flippedcoder requested a review from a team as a code owner February 3, 2026 17:18

flippedcoder marked this pull request as draft February 3, 2026 17:18

vercel bot had a problem deploying to Preview February 3, 2026 17:19 Failure

vercel bot had a problem deploying to Preview February 3, 2026 17:29 Failure

flippedcoder force-pushed the mm/ts-core-apps-decouple branch from a406bc5 to 7cfa9a8 Compare February 3, 2026 17:51

vercel bot had a problem deploying to Preview February 3, 2026 17:53 Failure

flippedcoder force-pushed the mm/ts-core-apps-decouple branch from 7cfa9a8 to c22e1c1 Compare February 3, 2026 18:42

vercel bot had a problem deploying to Preview February 3, 2026 18:58 Failure

flippedcoder self-assigned this Feb 3, 2026

flippedcoder force-pushed the mm/ts-core-apps-decouple branch from 81de832 to 1eacc9b Compare February 3, 2026 19:10

vercel bot had a problem deploying to Preview February 3, 2026 19:11 Failure

flippedcoder force-pushed the mm/ts-core-apps-decouple branch from 1eacc9b to 6bbfd3c Compare February 3, 2026 19:18

vercel bot had a problem deploying to Preview February 3, 2026 19:20 Failure

flippedcoder force-pushed the mm/ts-core-apps-decouple branch from 6bbfd3c to a6c0a28 Compare February 3, 2026 19:27

vercel bot had a problem deploying to Preview February 3, 2026 19:29 Failure

flippedcoder force-pushed the mm/ts-core-apps-decouple branch from a6c0a28 to f4c60a8 Compare February 3, 2026 19:46

vercel bot deployed to Preview February 3, 2026 19:47 View deployment

flippedcoder force-pushed the mm/ts-core-apps-decouple branch from f4c60a8 to 49899be Compare February 10, 2026 17:44

vercel bot had a problem deploying to Preview February 10, 2026 17:45 Failure

flippedcoder force-pushed the mm/ts-core-apps-decouple branch from 49899be to 5727a6d Compare February 10, 2026 18:51

vercel bot had a problem deploying to Preview February 10, 2026 18:53 Failure

vercel bot had a problem deploying to Preview February 10, 2026 19:19 Failure

vercel bot had a problem deploying to Preview February 10, 2026 19:24 Failure

flippedcoder force-pushed the mm/ts-core-apps-decouple branch from 2f328e8 to 42583d3 Compare February 10, 2026 19:24

vercel bot had a problem deploying to Preview February 10, 2026 19:26 Failure

flippedcoder force-pushed the mm/ts-core-apps-decouple branch from 42583d3 to b849811 Compare February 10, 2026 19:37

vercel bot deployed to Preview February 10, 2026 19:38 View deployment

vercel bot deployed to Preview February 10, 2026 20:24 View deployment

flippedcoder and others added 22 commits March 17, 2026 12:03

fix(task queues): updated pricing info for fairness (#4298)

96241d1

* fix(task queues): updated pricing info for fairness * chore(task queues): clean up based on feedback

chore(worker performance): added info about how cpu utilization is ac…

c1adb52

…counted for (#4300)

Clarify message idempotency section (#4144)

f66eb69

* Clarify message idempotency section * v2 * v3 * Apply suggestion from @flippedcoder * Apply suggestion from @flippedcoder --------- Co-authored-by: Milecia McG <47196133+flippedcoder@users.noreply.github.com>

Update pricing.mdx (#4304)

64beae8

refactor(typescript): moved typescript pages to workflows directory

0a1a678

refactor(typescript): moved typescript pages to activities directory

ad4b6ff

refactor(typescript): moved typescript pages to best practices directory

9a5fd71

refactor(typescript): moved typescript pages to client directory

7da3d0b

refactor(typescript): moved typescript pages to nexus directory

ebc66e5

refactor(typescript): moved typescript pages to workers directory

41e275d

refactor(typescript): split up core apps page content

c9694ac

refactor(typescript): updated links

5ec8cc2

fix(typescript): updated broken links

d3cb52c

refactor(typescript): updated high level pages for each primitive

ce862ca

fix(typescript): fixed broken links

5adf203

chore(typescript): reordered content under primitives

9b348b9

chore(typescript): cleaned up ordering and phrasing

11b549a

chore(typescript): minor clean up on names and links

953e735

chore(typescript): fixed broken link

2a0790b

chore(typescript): fixed merge conflicts

63e7b88

chore(typescript): cleaned up small nits

b1ad20b

flippedcoder force-pushed the mm/ts-core-apps-decouple branch from df0af86 to b1ad20b Compare March 19, 2026 16:51

flippedcoder requested a review from tlotemporal as a code owner March 19, 2026 16:51

vercel bot deployed to Preview March 19, 2026 16:53 View deployment

flippedcoder removed the request for review from tlotemporal March 20, 2026 15:51

lennessyy approved these changes Mar 24, 2026

View reviewed changes

flippedcoder merged commit ab6996c into mm/restructure-sdk-content Mar 27, 2026
9 of 10 checks passed

flippedcoder deleted the mm/ts-core-apps-decouple branch March 27, 2026 16:52

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

refactor(typescript): update /develop/typescript to restructure info#4179

refactor(typescript): update /develop/typescript to restructure info#4179
flippedcoder merged 22 commits intomm/restructure-sdk-contentfrom
mm/ts-core-apps-decouple

flippedcoder commented Feb 3, 2026 •

edited by sync-by-unito bot

Loading

Uh oh!

vercel bot commented Feb 3, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Feb 3, 2026 •

edited

Loading

Uh oh!

lennessyy left a comment •

edited

Loading

Uh oh!

CLAassistant commented Mar 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

Conversation

flippedcoder commented Feb 3, 2026 • edited by sync-by-unito bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do?

Notes to reviewers

Uh oh!

vercel bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📖 Docs PR preview links

Uh oh!

lennessyy left a comment • 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!

CLAassistant commented Mar 25, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

6 participants

flippedcoder commented Feb 3, 2026 •

edited by sync-by-unito bot

Loading

vercel bot commented Feb 3, 2026 •

edited

Loading

github-actions bot commented Feb 3, 2026 •

edited

Loading

lennessyy left a comment •

edited

Loading