diff --git a/packages/activity/src/index.ts b/packages/activity/src/index.ts
index d7cebbc38..bcccf35c0 100644
--- a/packages/activity/src/index.ts
+++ b/packages/activity/src/index.ts
@@ -11,7 +11,7 @@
  * ```
  *
  * Any function can be used as an Activity as long as its parameters and return value are serializable using a
- * {@link https://docs.temporal.io/concepts/what-is-a-data-converter/ | DataConverter}.
+ * {@link https://docs.temporal.io/default-custom-data-converters#custom-data-converter | DataConverter}.
  *
  * ### Cancellation
  *
@@ -255,7 +255,7 @@ export interface Info {
  * Activity Context, used to:
  *
  * - Get {@link Info} about the current Activity Execution
- * - Send {@link https://docs.temporal.io/concepts/what-is-an-activity-heartbeat | heartbeats}
+ * - Send {@link https://docs.temporal.io/encyclopedia/detecting-activity-failures#activity-heartbeat | heartbeats}
  * - Get notified of Activity cancellation
  * - Sleep (cancellation-aware)
  *
@@ -354,7 +354,7 @@ export class Context {
   ) {}
 
   /**
-   * Send a {@link https://docs.temporal.io/concepts/what-is-an-activity-heartbeat | heartbeat} from an Activity.
+   * Send a {@link https://docs.temporal.io/encyclopedia/detecting-activity-failures#activity-heartbeat | heartbeat} from an Activity.
    *
    * If an Activity times out, then during the next retry, the last value of `details` is available at
    * {@link Info.heartbeatDetails}. This acts as a periodic checkpoint mechanism for the progress of an Activity.
@@ -470,7 +470,7 @@ export function sleep(ms: Duration): Promise<void> {
 }
 
 /**
- * Send a {@link https://docs.temporal.io/concepts/what-is-an-activity-heartbeat | heartbeat} from an Activity.
+ * Send a {@link https://docs.temporal.io/encyclopedia/detecting-activity-failures#activity-heartbeat | heartbeat} from an Activity.
  *
  * If an Activity times out, then during the next retry, the last value of `details` is available at
  * {@link Info.heartbeatDetails}. This acts as a periodic checkpoint mechanism for the progress of an Activity.
diff --git a/packages/common/src/failure.ts b/packages/common/src/failure.ts
index e65af3d65..0653a80e4 100644
--- a/packages/common/src/failure.ts
+++ b/packages/common/src/failure.ts
@@ -184,7 +184,7 @@ export class ServerFailure extends TemporalFailure {
  * - `details` are set to null
  * - stack trace is copied from the original error
  *
- * When an {@link https://docs.temporal.io/concepts/what-is-an-activity-execution | Activity Execution} fails, the
+ * When an {@link https://docs.temporal.io/activity-execution#activity-execution | Activity Execution} fails, the
  * `ApplicationFailure` from the last Activity Task will be the `cause` of the {@link ActivityFailure} thrown in the
  * Workflow.
  */
diff --git a/packages/common/src/workflow-options.ts b/packages/common/src/workflow-options.ts
index 4e659f82a..57cc622b3 100644
--- a/packages/common/src/workflow-options.ts
+++ b/packages/common/src/workflow-options.ts
@@ -13,7 +13,7 @@ import type { WorkflowFunctionWithOptions } from './workflow-definition-options'
  * See {@link WorkflowOptions.workflowIdConflictPolicy} for what happens when trying to start a
  * Workflow with the same ID as a *Running* Workflow.
  *
- * Concept: {@link https://docs.temporal.io/concepts/what-is-a-workflow-id-reuse-policy/ | Workflow Id Reuse Policy}
+ * Concept: {@link https://docs.temporal.io/workflow-execution/workflowid-runid#workflow-id-reuse-policy | Workflow Id Reuse Policy}
  *
  * *Note: It is not possible to have two actively running Workflows with the same ID.*
  *
@@ -150,7 +150,7 @@ export interface BaseWorkflowOptions {
    * Controls how a Workflow Execution is retried.
    *
    * By default, Workflow Executions are not retried. Do not override this behavior unless you know what you're doing.
-   * {@link https://docs.temporal.io/concepts/what-is-a-retry-policy/ | More information}.
+   * {@link https://docs.temporal.io/encyclopedia/retry-policies | More information}.
    */
   retry?: RetryPolicy;
 
diff --git a/packages/workflow/src/workflow.ts b/packages/workflow/src/workflow.ts
index f762a0f15..72059cdc4 100644
--- a/packages/workflow/src/workflow.ts
+++ b/packages/workflow/src/workflow.ts
@@ -1042,7 +1042,7 @@ export function makeContinueAsNewFunc<F extends Workflow>(
 }
 
 /**
- * {@link https://docs.temporal.io/concepts/what-is-continue-as-new/ | Continues-As-New} the current Workflow Execution
+ * {@link https://docs.temporal.io/workflow-execution/continue-as-new#continue-as-new | Continues-As-New} the current Workflow Execution
  * with default options.
  *
  * Shorthand for `makeContinueAsNewFunc<F>()(...args)`. (See: {@link makeContinueAsNewFunc}.)