docs review

Author: alexisintech

docs/guides/development/custom-flows/authentication/legacy/email-password.mdx

@@ -94,16 +94,9 @@ This guide will walk you through how to build a custom email/password sign-up an
                 session: signUpAttempt.createdSessionId,
                 navigate: async ({ session, decorateUrl }) => {
                   if (session?.currentTask) {
-                    // Check for session tasks and navigate to custom UI to help users resolve them
-                    // See https://clerk.com/docs/guides/development/custom-flows/authentication#session-tasks
+                    // Handle session tasks
+                    // See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
                     console.log(session?.currentTask)
-                    const tasksUrl = decorateUrl('/sign-up/tasks')
-                    if (tasksUrl.startsWith('http')) {
-                      window.location.href = tasksUrl
-                    } else {
-                      router.push(tasksUrl)
-                    }
-                    return
                   }
 
                   const url = decorateUrl('/')

docs/guides/development/custom-flows/authentication/legacy/legal-acceptance.mdx

@@ -84,16 +84,9 @@ export default function Page() {
           session: signUpAttempt.createdSessionId,
           navigate: async ({ session, decorateUrl }) => {
             if (session?.currentTask) {
-              // Check for session tasks and navigate to custom UI to help users resolve them
-              // See https://clerk.com/docs/guides/development/custom-flows/authentication#session-tasks
+              // Handle session tasks
+              // See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
               console.log(session?.currentTask)
-              const url = decorateUrl('/sign-up/tasks')
-              if (url.startsWith('http')) {
-                window.location.href = url
-              } else {
-                router.push(url)
-              }
-              return
             }
 
             const url = decorateUrl('/')

docs/guides/development/custom-flows/authentication/oauth-connections.mdx

@@ -268,18 +268,11 @@ You must configure your application instance through the Clerk Dashboard for the
           if (createdSessionId) {
             setActive!({
               session: createdSessionId,
-              // Check for session tasks and navigate to custom UI to help users resolve them
-              // See https://clerk.com/docs/guides/development/custom-flows/authentication#session-tasks
+              // Handle session tasks
+              // See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
               navigate: async ({ session, decorateUrl }) => {
                 if (session?.currentTask) {
                   console.log(session?.currentTask)
-                  const url = decorateUrl('/sign-in/tasks')
-                  if (url.startsWith('http')) {
-                    window.location.href = url
-                  } else {
-                    router.push(url)
-                  }
-                  return
                 }
 
                 const url = decorateUrl('/')
@@ -523,16 +516,9 @@ With OAuth flows, it's common for users to try to _sign in_ with an OAuth provid
           await signUp.finalize({
             navigate: async ({ session, decorateUrl }) => {
               if (session?.currentTask) {
-                // Check for tasks and navigate to custom UI to help users resolve them
-                // See https://clerk.com/docs/guides/development/custom-flows/authentication#session-tasks
+                // Handle session tasks
+                // See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
                 console.log(session?.currentTask)
-                const url = decorateUrl('/sign-in/tasks')
-                if (url.startsWith('http')) {
-                  window.location.href = url
-                } else {
-                  router.push(url)
-                }
-                return
               }
 
               const url = decorateUrl('/')

docs/guides/development/custom-flows/authentication/session-tasks.mdx

@@ -50,17 +50,10 @@ In the authentication custom flows, such as the [email/password custom flow](/do
 await setActive({
   session: signInAttempt.createdSessionId,
   navigate: async ({ session, decorateUrl }) => {
-    // Check for tasks and navigate to custom UI to help users resolve them
+    // Handle session tasks
     // See https://clerk.com/docs/guides/development/custom-flows/authentication/session-tasks
     if (session?.currentTask) {
       console.log(session?.currentTask)
-      const url = decorateUrl(`/session-tasks/${session?.currentTask.key}`)
-      if (url.startsWith('http')) {
-        window.location.href = url
-      } else {
-        router.push(url)
-      }
-      return
     }
 
     const url = decorateUrl('/')

docs/guides/development/upgrading/upgrade-guides/core-3.mdx

@@ -275,14 +275,19 @@ The following deprecated APIs have been removed from all Clerk SDKs.
     - beforeEmit: () => {
     -   // Called before session is set
     - }
-    + navigate: ({ session }) => {
+    + navigate: async ({ session, decorateUrl }) => {
     +   // Called with the session object
-    +   return '/dashboard';
+    +   const url = decorateUrl('/dashboard')
+    +   if (url.startsWith('http')) {
+    +     window.location.href = url
+    +   } else {
+    +     router.push(url)
+    +   }
     + }
     });
     ```
 
-    The `navigate` callback receives an object with the `session` property and should return the URL to navigate to.
+    The `navigate` callback receives an object with the `session` property and the `decorateUrl` function. [Learn more about the `navigate` callback](/docs/references/javascript/types/set-active-params#navigate).
   </AccordionPanel>
 
   <AccordionPanel>