docs suggestions

Author: alexisintech

docs/_partials/create-invitation.mdx

@@ -70,20 +70,21 @@
     ```tsx {{ filename: 'app/routes/example.tsx' }}
     import { clerkClient } from '@clerk/react-router/server'
     import type { Route } from './+types/example'
+    import { json } from 'react-router-dom'
+
+    export async function action({ request }: Route.ActionArgs) {
+      const formData = await request.formData()
+      const emailAddress = formData.get('emailAddress')
+      const redirectUrl = formData.get('redirectUrl')
+      const publicMetadata = formData.get('publicMetadata')
 
-    export async function loader(args: Route.LoaderArgs) {
       await clerkClient.invitations.createInvitation({
-        emailAddress: 'invite@example.com',
-        redirectUrl: 'https://www.example.com/my-sign-up',
-        publicMetadata: {
-          example: 'metadata',
-          example_nested: {
-            nested: 'metadata',
-          },
-        },
+        emailAddress: emailAddress,
+        redirectUrl: redirectUrl,
+        publicMetadata: publicMetadata,
       })
 
-      return { success: true }
+      return json({ success: true })
     }
     ```
   </Tab>

docs/_partials/create-user.mdx

@@ -4,18 +4,14 @@
     import { auth, clerkClient } from '@clerk/nextjs/server'
     import { NextResponse } from 'next/server'
 
-    export async function GET() {
-      try {
-        const client = await clerkClient()
-        const user = await client.users.createUser({
-          emailAddress: ['test@example.com'],
-          password: 'password',
-        })
-        return NextResponse.json({ message: 'User created', user })
-      } catch (error) {
-        console.log(error)
-        return NextResponse.json({ error: 'Error creating user' })
-      }
+    export async function POST() {
+      const client = await clerkClient()
+      const user = await client.users.createUser({
+        emailAddress: ['test@example.com'],
+        password: 'password',
+      })
+
+      return NextResponse.json({ message: 'User created', user })
     }
     ```
   </Tab>
@@ -25,7 +21,7 @@
     import type { APIRoute } from 'astro'
     import { clerkClient } from '@clerk/astro/server'
 
-    export const GET: APIRoute = async (context) => {
+    export const POST: APIRoute = async (context) => {
       await clerkClient(context).users.createUser({
         emailAddress: ['test@example.com'],
         password: 'password',
@@ -53,16 +49,21 @@
 
   <Tab>
     ```tsx {{ filename: 'app/routes/example.tsx' }}
-    import { clerkClient, getAuth } from '@clerk/react-router/server'
+    import { clerkClient } from '@clerk/react-router/server'
     import type { Route } from './+types/example'
+    import { json } from 'react-router-dom'
+
+    export async function action({ request }: Route.ActionArgs) {
+      const formData = await request.formData()
+      const emailAddress = formData.get('emailAddress')
+      const password = formData.get('password')
 
-    export async function loader(args: Route.LoaderArgs) {
       await clerkClient.users.createUser({
-        emailAddress: ['test@example.com'],
-        password: 'password',
+        emailAddress: [emailAddress],
+        password: password,
       })
 
-      return { success: true }
+      return json({ success: true })
     }
     ```
   </Tab>
@@ -76,7 +77,7 @@
     export const ServerRoute = createFileRoute('/api/example')({
       server: {
         handlers: {
-          GET: async () => {
+          POST: async () => {
             await clerkClient().users.createUser({
               emailAddress: ['test@example.com'],
               password: 'my-secure-password',

docs/_partials/delete-user.mdx

@@ -41,11 +41,15 @@
     ```tsx {{ filename: 'app/routes/example.tsx' }}
     import { clerkClient } from '@clerk/react-router/server'
     import type { Route } from './+types/example'
+    import { json, redirect } from 'react-router-dom'
 
-    export async function loader(args: Route.LoaderArgs) {
-      await clerkClient.users.deleteUser('user_123')
+    export async function action({ request }: Route.ActionArgs) {
+      const formData = await request.formData()
+      const userId = formData.get('userId')
+
+      await clerkClient.users.deleteUser(userId)
 
-      return { success: true }
+      return json({ success: true })
     }
     ```
   </Tab>

docs/_partials/revoke-invitation.mdx

@@ -5,16 +5,12 @@
     import { NextResponse } from 'next/server'
 
     export async function POST() {
-      try {
-        const client = await clerkClient()
-        const invitation = await client.invitations.revokeInvitation({
-          invitationId: 'invitation_123',
-        })
-        return NextResponse.json({ message: 'Invitation revoked' })
-      } catch (error) {
-        console.log(error)
-        return NextResponse.json({ error: 'Error revoking invitation' })
-      }
+      const client = await clerkClient()
+      const invitation = await client.invitations.revokeInvitation({
+        invitationId: 'invitation_123',
+      })
+
+      return NextResponse.json({ message: 'Invitation revoked' })
     }
     ```
   </Tab>
@@ -52,13 +48,17 @@
     ```tsx {{ filename: 'app/routes/example.tsx' }}
     import { clerkClient } from '@clerk/react-router/server'
     import type { Route } from './+types/example'
+    import { json, redirect } from 'react-router-dom'
+
+    export async function action({ request }: Route.ActionArgs) {
+      const formData = await request.formData()
+      const invitationId = formData.get('invitationId')
 
-    export async function loader(args: Route.LoaderArgs) {
       await clerkClient.invitations.revokeInvitation({
-        invitationId: 'invitation_123',
+        invitationId: invitationId,
       })
 
-      return { success: true }
+      return json({ success: true })
     }
     ```
   </Tab>

docs/guides/configure/auth-strategies/social-connections/overview.mdx

@@ -292,7 +292,6 @@ The following example demonstrates how to retrieve the OAuth access token for a
 
   <Tab>
     ```tsx {{ filename: 'app/routes/notion.tsx' }}
-    import { redirect } from 'react-router'
     import { getAuth } from '@clerk/react-router/ssr.server'
     import { createClerkClient } from '@clerk/react-router/api.server'
     import type { Route } from './+types/notion'
@@ -305,7 +304,9 @@ The following example demonstrates how to retrieve the OAuth access token for a
 
       // Protect the route from unauthenticated users
       if (!isAuthenticated) {
-        return redirect('/sign-in?redirect_url=' + args.request.url)
+        return new Response('User not authenticated', {
+          status: 404,
+        })
       }
 
       const provider = 'notion'
@@ -319,7 +320,9 @@ The following example demonstrates how to retrieve the OAuth access token for a
       }).users.getUserOauthAccessToken(userId, provider)
       const accessToken = clerkResponse.data[0].token || ''
       if (!accessToken) {
-        return redirect('/sign-in?redirect_url=' + args.request.url)
+        return new Response('Access token not found', {
+          status: 401,
+        })
       }
 
       // Fetch the user data from the Notion API
@@ -338,9 +341,7 @@ The following example demonstrates how to retrieve the OAuth access token for a
       const notionData = await notionResponse.json()
 
       // Return the Notion data
-      return {
-        notionData: JSON.stringify(notionData),
-      }
+      return JSON.stringify({ notionData })
     }
     ```
   </Tab>

docs/guides/configure/session-tasks.mdx

@@ -94,6 +94,8 @@ The `<RedirectToTasks />` control component redirects users to the appropriate t
 
 ```tsx
 <>
+  {/* Until the user completes their session tasks,
+  Clerk considers them as signed out, by default */}
   <SignedOut>
     <RedirectToTasks />
   </SignedOut>