[FSSDK-10777] doc improvement

Author: junaed-optimizely

README.md

@@ -433,6 +433,32 @@ function MyComponent() {
 </OptimizelyProvider>;
 ```
 
+### Configuring the instance for server use
+
+Server-side instances are short-lived (created per request) and may not be garbage collected immediately. To avoid unnecessary background work and ensure events are dispatched before the instance is discarded, configure `createInstance` with server-appropriate options:
+
+```jsx
+import { createInstance, OptimizelyDecideOption } from '@optimizely/react-sdk';
+
+const isServer = typeof window === 'undefined';
+
+const optimizelyClient = createInstance({
+  datafile,
+  datafileOptions: { autoUpdate: !isServer },
+  eventBatchSize: isServer ? 1 : 10,
+  eventMaxQueueSize: isServer ? 1 : 100,
+  // Optional: disable decision events on server if they will be sent from the client
+  defaultDecideOptions: isServer ? [OptimizelyDecideOption.DISABLE_DECISION_EVENT] : [],
+});
+```
+
+| Option | Server value | Why |
+|---|---|---|
+| `datafileOptions.autoUpdate` | `false` | No need to poll for datafile updates on a per-request instance |
+| `eventBatchSize` | `1` | Flush events immediately — the instance won't live long enough for a batch to fill |
+| `eventMaxQueueSize` | `1` | Prevent event accumulation in a short-lived instance |
+| `defaultDecideOptions` | `[DISABLE_DECISION_EVENT]` | Optional — avoids duplicate decision events if the client will also fire them after hydration |
+
 ### React Server Components
 
 The SDK can also be used directly in React Server Components without `OptimizelyProvider`. Create an instance, set the user, wait for readiness, and make decisions — all within an `async` server component:

docs/nextjs-ssr.md

@@ -47,11 +47,21 @@ Since `OptimizelyProvider` uses React Context (a client-side feature), it must b
 // src/providers/OptimizelyProvider.tsx
 'use client';
 
-import { OptimizelyProvider, createInstance } from '@optimizely/react-sdk';
+import { OptimizelyProvider, createInstance, OptimizelyDecideOption } from '@optimizely/react-sdk';
 import { ReactNode, useState } from 'react';
 
 export function OptimizelyClientProvider({ children, datafile }: { children: ReactNode; datafile: object }) {
-  const [optimizely] = useState(() => createInstance({ datafile }));
+  const [optimizely] = useState(() => {
+    const isServer = typeof window === 'undefined';
+    return createInstance({
+      datafile,
+      datafileOptions: { autoUpdate: !isServer },
+      eventBatchSize: isServer ? 1 : 10,
+      eventMaxQueueSize: isServer ? 1 : 100,
+      // Optional: disable decision events on server if they will be sent from the client
+      defaultDecideOptions: isServer ? [OptimizelyDecideOption.DISABLE_DECISION_EVENT] : [],
+    });
+  });
   const isServerSide = typeof window === 'undefined';
 
   return (
@@ -62,6 +72,8 @@ export function OptimizelyClientProvider({ children, datafile }: { children: Rea
 }
 ```
 
+> See [Configuring the instance for server use](../README.md#configuring-the-instance-for-server-use) in the README for an explanation of each option.
+
 ### 3. Wire it up in your root layout
 
 ```tsx