(don't merge) test versioning

fern/docs.yml

@@ -15,57 +15,17 @@ layout:
   page-width: full
   tabs-placement: header
 
-tabs:
-  home:
-    display-name: Docs
-    icon: home
-  API Reference:
-    display-name: API Reference
-    icon: puzzle
-
-navigation:
-  - tab: home
-    layout:
-      - section: Get started
-        contents:
-          - page: Welcome
-            path: docs/pages/welcome.mdx
-            icon: fa-duotone fa-house
-          - page: Edit your docs
-            path: docs/pages/editing-your-docs.mdx
-            icon: fa-duotone fa-pen-to-square
-          - page: Write content
-            path: docs/pages/writing-content.mdx
-            icon: fa-duotone fa-file-lines
-          - page: Set up navigation
-            path: docs/pages/navigation.mdx
-            icon: fa-duotone fa-sitemap
-          - page: Customize your docs
-            path: docs/pages/customization.mdx
-            icon: fa-duotone fa-palette
-          - page: Support
-            path: docs/pages/support.mdx
-            icon: fa-duotone fa-headset
-      - section: Changelog
-        contents:
-          - changelog: docs/changelog
-  - tab: API Reference
-    layout:
-      - section: Overview
-        contents:
-          - page: API reference
-            path: docs/pages/api-reference-overview.mdx
-            icon: fa-duotone fa-book
-      - api: Plant Store API
-        layout:
-          - section: Plants
-            referenced-packages:
-              - plant
-            contents: []
-          - section: Users
-            referenced-packages:
-              - user
-            contents: []
+versions:
+  - display-name: v3
+    path: ./versions/v3.yml
+    availability: stable
+  - display-name: v2
+    path: ./versions/v2.yml
+    availability: stable
+  - display-name: v1 (Legacy)
+    path: ./versions/v1.yml
+    availability: deprecated
+    slug: v1
 
 navbar-links:
   - type: minimal

fern/versions/v1.yml

@@ -0,0 +1,19 @@
+tabs:
+  home:
+    display-name: Docs
+    icon: home
+
+navigation:
+  - tab: home
+    layout:
+      - section: Get started
+        contents:
+          - page: Welcome
+            path: ../docs/pages/welcome.mdx
+            icon: fa-duotone fa-house
+          - page: Edit your docs
+            path: ../docs/pages/editing-your-docs.mdx
+            icon: fa-duotone fa-pen-to-square
+          - page: Write content
+            path: ../docs/pages/writing-content.mdx
+            icon: fa-duotone fa-file-lines

fern/versions/v2.yml

@@ -0,0 +1,44 @@
+tabs:
+  home:
+    display-name: Docs
+    icon: home
+  API Reference:
+    display-name: API Reference
+    icon: puzzle
+
+navigation:
+  - tab: home
+    layout:
+      - section: Get started
+        contents:
+          - page: Welcome
+            path: ../docs/pages/welcome.mdx
+            icon: fa-duotone fa-house
+          - page: Edit your docs
+            path: ../docs/pages/editing-your-docs.mdx
+            icon: fa-duotone fa-pen-to-square
+          - page: Write content
+            path: ../docs/pages/writing-content.mdx
+            icon: fa-duotone fa-file-lines
+          - page: Set up navigation
+            path: ../docs/pages/navigation.mdx
+            icon: fa-duotone fa-sitemap
+          - page: Customize your docs
+            path: ../docs/pages/customization.mdx
+            icon: fa-duotone fa-palette
+      - section: Changelog
+        contents:
+          - changelog: ../docs/changelog
+  - tab: API Reference
+    layout:
+      - section: Overview
+        contents:
+          - page: API reference
+            path: ../docs/pages/api-reference-overview.mdx
+            icon: fa-duotone fa-book
+      - api: Plant Store API
+        layout:
+          - section: Plants
+            referenced-packages:
+              - plant
+            contents: []

fern/versions/v3.yml

@@ -0,0 +1,51 @@
+tabs:
+  home:
+    display-name: Docs
+    icon: home
+  API Reference:
+    display-name: API Reference
+    icon: puzzle
+
+navigation:
+  - tab: home
+    layout:
+      - section: Get started
+        contents:
+          - page: Welcome
+            path: ../docs/pages/welcome.mdx
+            icon: fa-duotone fa-house
+          - page: Edit your docs
+            path: ../docs/pages/editing-your-docs.mdx
+            icon: fa-duotone fa-pen-to-square
+          - page: Write content
+            path: ../docs/pages/writing-content.mdx
+            icon: fa-duotone fa-file-lines
+          - page: Set up navigation
+            path: ../docs/pages/navigation.mdx
+            icon: fa-duotone fa-sitemap
+          - page: Customize your docs
+            path: ../docs/pages/customization.mdx
+            icon: fa-duotone fa-palette
+          - page: Support
+            path: ../docs/pages/support.mdx
+            icon: fa-duotone fa-headset
+      - section: Changelog
+        contents:
+          - changelog: ../docs/changelog
+  - tab: API Reference
+    layout:
+      - section: Overview
+        contents:
+          - page: API reference
+            path: ../docs/pages/api-reference-overview.mdx
+            icon: fa-duotone fa-book
+      - api: Plant Store API
+        layout:
+          - section: Plants
+            referenced-packages:
+              - plant
+            contents: []
+          - section: Users
+            referenced-packages:
+              - user
+            contents: []