docs(plugin-activity-guard): separate setup and usage

Author: ENvironmentSet

extensions/plugin-activity-guard/README.md

@@ -24,74 +24,57 @@ dependencies.
 
 ## Setup
 
-Register the plugin with a Guard for each Activity that has an entry policy.
-The Activity names and parameters are inferred from your
-`@stackflow/config` registration.
-
-```ts
-// stackflow.config.ts
-import { defineConfig } from "@stackflow/config";
-
-declare module "@stackflow/config" {
-  interface Register {
-    Home: {};
-    Checkout: { orderId: string };
-    SignIn: { returnTo: string };
-    Terms: { orderId: string };
-  }
-}
-
-export const config = defineConfig({
-  activities: [
-    { name: "Home" },
-    { name: "Checkout" },
-    { name: "SignIn" },
-    { name: "Terms" },
-  ],
-  initialActivity: () => "Home",
-  transitionDuration: 350,
-});
-```
+Add `activityGuardPlugin()` to your Stackflow configuration and map each
+guarded Activity to its Guard. This example assumes `Checkout`, `SignIn`, and
+`Terms` are already registered in `@stackflow/config`.
 
 ```tsx
-import type { ActivityGuardFor } from "@stackflow/plugin-activity-guard";
-import {
-  activityGuardPlugin,
-  all,
-  redirect,
-} from "@stackflow/plugin-activity-guard";
+import { activityGuardPlugin } from "@stackflow/plugin-activity-guard";
 import { stackflow } from "@stackflow/react";
 import { config } from "./stackflow.config";
-import { Checkout, Home, SignIn, Terms } from "./activities";
-
-const requireSignIn: ActivityGuardFor<"Checkout"> = ({ activityParams }) =>
-  isSignedIn()
-    ? true
-    : redirect("SignIn", { returnTo: activityParams.orderId });
-
-const requireTerms: ActivityGuardFor<"Checkout"> = ({ activityParams }) =>
-  hasAcceptedTerms()
-    ? true
-    : redirect("Terms", { orderId: activityParams.orderId });
+import { Checkout, SignIn, Terms } from "./activities";
+import { checkoutGuard } from "./checkoutGuard";
 
 export const { Stack } = stackflow({
   config,
   components: {
-    Home,
     Checkout,
     SignIn,
     Terms,
   },
   plugins: [
     activityGuardPlugin({
       guards: {
-        Checkout: all(requireSignIn, requireTerms),
+        Checkout: checkoutGuard,
       },
     }),
   ],
 });
 ```
 
+## Usage
+
+The following Guard requires both sign-in and terms acceptance before entering
+`Checkout`. Activity names and parameters are inferred from your
+`@stackflow/config` registration.
+
+```ts
+import type { ActivityGuardFor } from "@stackflow/plugin-activity-guard";
+import { all, redirect } from "@stackflow/plugin-activity-guard";
+
+const requireSignIn: ActivityGuardFor<"Checkout"> = ({ activityParams }) =>
+  isSignedIn()
+    ? true
+    : redirect("SignIn", { returnTo: activityParams.orderId });
+
+const requireTerms: ActivityGuardFor<"Checkout"> = ({ activityParams }) =>
+  hasAcceptedTerms()
+    ? true
+    : redirect("Terms", { orderId: activityParams.orderId });
+
+export const checkoutGuard = all(requireSignIn, requireTerms);
+```
+
 Each Guard receives the requested `activityName` and its typed
 `activityParams`. Return `true` to allow the entry, or return
 `redirect(activityName, activityParams)` to replace its target. In the example,