update versioned apis info

Author: devalog

fern/products/api-def/pages/project-structure.mdx

@@ -125,59 +125,59 @@ api:
       openapi: payments-api/openapi.yml
 ```
 </Accordion>
-<Accordion title="Versioned APIs in the same SDK">
+<Accordion title="Versioned APIs">
 
-Use this approach when you need to support multiple API versions simultaneously in your SDK.
+When supporting multiple API versions, you can publish them as separate packages or combine them into a single package with namespaces.
 
-#### Option 1: Branch-based versioning
+#### Option 1: Separate packages for each API version
 
-Each API version is maintained as a separate spec that publishes to a different branch of a single SDK repository. This approach allows you to release updates for older API versions independently and manage each as a different major version of your SDK (v1.x.x, v2.x.x).
+Use this approach when you want each API version to be independently installable (e.g., `@company/sdk-v1`, `@company/sdk-v2`).
 
 ```bash
-fern/
-  ├─ fern.config.json
-  └─ apis/
-      ├─ v1/
-      │   ├─ generators.yml      # Configures v1 SDK
-      │   └─ openapi.yml
+# Each API version in its own directory
+v1-sdk/
+  └─ fern/
+      ├─ fern.config.json
+      ├─ generators.yml     
+      └─ v1/
+          └─ openapi.yml
+v2-sdk/
+  └─ fern/
+      ├─ fern.config.json
+      ├─ generators.yml    
       └─ v2/
-          ├─ generators.yml      # Configures v2 SDK
           └─ openapi.yml
 ```
 
-Each API version must have its own `generators.yml` file that targets a [specific branch](/sdks/reference/generators-yml#github):
+Each API version must have its own `generators.yml` file:
 
 <Tabs>
-<Tab title="apis/v1/generators.yml">
+<Tab title="v1-sdk/fern/generators.yml">
 
-```yaml title="apis/v1/generators.yml" {11}
+```yaml title="v1-sdk/fern/generators.yml"
 api:
   specs:
-    - openapi: openapi.yml
+    - openapi: v1/openapi.yml
 groups:
   ts-sdk:
     generators:
       - name: fernapi/fern-typescript-sdk
         github:
-          repository: company/sdk
-          mode: push
-          branch: v1              # Targets v1 branch
+          repository: company/sdk-v1
 ```
 </Tab>
-<Tab title="apis/v2/generators.yml">
+<Tab title="v2-sdk/fern/generators.yml">
 
-```yaml title="apis/v2/generators.yml" {11}
+```yaml title="v2-sdk/fern/generators.yml"
 api:
   specs:
-    - openapi: openapi.yml
+    - openapi: v2/openapi.yml
 groups:
   ts-sdk:
     generators:
       - name: fernapi/fern-typescript-sdk
         github:
-          repository: company/sdk
-          mode: pull-request
-          branch: v2              # Targets v2 branch
+          repository: company/sdk-v2
 ```
 </Tab>
 </Tabs>