feat: working on docs home

Author: Kapil Gowru

card-group-example.mdx

@@ -0,0 +1,17 @@
+<CardGroup cols={2}>
+  <Card title="Quickstart">
+    Start building beautiful documentation in under 5 minutes.
+  </Card>
+  
+  <Card title="Configure with ease">
+    One simple file that can be used to generate documentation that fits your brand.
+  </Card>
+  
+  <Card title="Flexible component library">
+    Use pre-built or custom React components for a polished look.
+  </Card>
+  
+  <Card title="Visual Editor">
+    Modify your documentation without touching code and publish to your GitHub.
+  </Card>
+</CardGroup> 

fern/products/docs/docs.yml

@@ -5,19 +5,79 @@ navigation:
         path: ./pages/guides/getting-started/overview.mdx
       - page: Quickstart
         path: ./pages/guides/getting-started/quickstart.mdx
-      - page: Migrate from an existing site
+      - page: Migrating from an existing site
         path: ./pages/guides/getting-started/migrate-from-existing-site.mdx
+      - page: Previewing your docs 
+        path: ./pages/guides/getting-started/setting-up-your-domain.mdx
       - page: Setting up your domain
         path: ./pages/guides/getting-started/setting-up-your-domain.mdx
       - page: Customer Showcase
         path: ./pages/guides/getting-started/customer-showcase.mdx
-  - section: Reference
+  - section: Component Library
+    contents:
+      - page: Overview
+        path: ./pages/component-library/overview.mdx
+      - section: Writing Content
+        contents:
+          - page: Markdown
+            path: ./pages/component-library/writing-content/markdown.mdx
+          - page: Frontmatter
+            path: ./pages/component-library/writing-content/frontmatter.mdx
+          - page: Visual Editor
+            path: ./pages/component-library/writing-content/visual-editor.mdx
+      - section: Default Components
+        contents:
+          - page: Overview
+            path: ./pages/component-library/default-components/overview.mdx
+          - page: Accordions
+            path: ./pages/component-library/default-components/accordions.mdx
+          - page: Accordion Groups
+            path: ./pages/component-library/default-components/accordion-groups.mdx
+          - page: Aside
+            path: ./pages/component-library/default-components/aside.mdx
+          - page: Callouts
+            path: ./pages/component-library/default-components/callouts.mdx
+          - page: Cards
+            path: ./pages/component-library/default-components/cards.mdx
+          - page: Card Groups
+            path: ./pages/component-library/default-components/card-groups.mdx
+          - page: Code Blocks
+            path: ./pages/component-library/default-components/code-blocks.mdx
+          - page: Embed
+            path: ./pages/component-library/default-components/embed.mdx
+          - page: Endpoint Request Snippet
+            path: ./pages/component-library/default-components/endpoint-request-snippet.mdx
+          - page: Endpoint Response Snippet
+            path: ./pages/component-library/default-components/endpoint-response-snippet.mdx
+          - page: Endpoint Schema Snippet
+            path: ./pages/component-library/default-components/endpoint-schema-snippet.mdx
+          - page: Frames
+            path: ./pages/component-library/default-components/frames.mdx
+          - page: Icons
+            path: ./pages/component-library/default-components/icons.mdx
+          - page: Parameter Fields
+            path: ./pages/component-library/default-components/parameter-fields.mdx
+          - page: Steps
+            path: ./pages/component-library/default-components/steps.mdx
+          - page: Tabs
+            path: ./pages/component-library/default-components/tabs.mdx
+          - page: Tooltips
+            path: ./pages/component-library/default-components/tooltips.mdx
+      - section: Custom Components
+        contents:
+          - page: Reusable Snippets
+            path: ./pages/component-library/custom-components/reusable-snippets.mdx
+          - page: Custom React Components
+            path: ./pages/component-library/custom-components/custom-react-components.mdx
+  - section: Configuration
     collapsed: true
     contents:
       - page: What is docs.yml
-        path: ./pages/guides/reference/what-is-docs-yml.mdx
+        path: ./pages/guides/configuration/what-is-docs-yml.mdx
+      - page: Project Structure
+        path: ./pages/guides/configuration/project-structure.mdx
       - page: Frontmatter
-        path: ./pages/guides/reference/frontmatter.mdx
+        path: ./pages/guides/configuration/frontmatter.mdx
   - section: Navigation
     collapsed: true
     contents:
@@ -45,7 +105,7 @@ navigation:
       - page: SEO Metadata
         path: ./pages/guides/seo/seo-metadata.mdx
       - page: Ilms.txt
-        path: ./pages/guides/seo/ilms-txt.mdx
+        path: ./pages/guides/seo/llms-txt.mdx
   - section: Authentication
     collapsed: true
     contents:
@@ -83,62 +143,6 @@ navigation:
         path: ./pages/guides/integrations/feature-flags.mdx
       - page: Self-hosted
         path: ./pages/guides/integrations/self-hosted.mdx
-  - section: Component Library
-    contents:
-      - page: Overview
-        path: ./pages/component-library/overview.mdx
-      - section: Writing Content
-        contents:
-          - page: Markdown
-            path: ./pages/component-library/writing-content/markdown.mdx
-          - page: Frontmatter
-            path: ./pages/component-library/writing-content/frontmatter.mdx
-          - page: Visual Editor
-            path: ./pages/component-library/writing-content/visual-editor.mdx
-      - section: Default Components
-        contents:
-          - page: Overview
-            path: ./pages/component-library/default-components/overview.mdx
-          - page: Accordions
-            path: ./pages/component-library/default-components/accordions.mdx
-          - page: Accordion Groups
-            path: ./pages/component-library/default-components/accordion-groups.mdx
-          - page: Aside
-            path: ./pages/component-library/default-components/aside.mdx
-          - page: Callouts
-            path: ./pages/component-library/default-components/callouts.mdx
-          - page: Cards
-            path: ./pages/component-library/default-components/cards.mdx
-          - page: Card Groups
-            path: ./pages/component-library/default-components/card-groups.mdx
-          - page: Code Blocks
-            path: ./pages/component-library/default-components/code-blocks.mdx
-          - page: Embed
-            path: ./pages/component-library/default-components/embed.mdx
-          - page: Endpoint Request Snippet
-            path: ./pages/component-library/default-components/endpoint-request-snippet.mdx
-          - page: Endpoint Response Snippet
-            path: ./pages/component-library/default-components/endpoint-response-snippet.mdx
-          - page: Endpoint Schema Snippet
-            path: ./pages/component-library/default-components/endpoint-schema-snippet.mdx
-          - page: Frames
-            path: ./pages/component-library/default-components/frames.mdx
-          - page: Icons
-            path: ./pages/component-library/default-components/icons.mdx
-          - page: Parameter Fields
-            path: ./pages/component-library/default-components/parameter-fields.mdx
-          - page: Steps
-            path: ./pages/component-library/default-components/steps.mdx
-          - page: Tabs
-            path: ./pages/component-library/default-components/tabs.mdx
-          - page: Tooltips
-            path: ./pages/component-library/default-components/tooltips.mdx
-      - section: Custom Components
-        contents:
-          - page: Reusable Snippets
-            path: ./pages/component-library/custom-components/reusable-snippets.mdx
-          - page: Custom React Components
-            path: ./pages/component-library/custom-components/custom-react-components.mdx
   - page: Changelog
     path: ./pages/changelog/overview.mdx
 

fern/products/docs/pages/guides/reference/frontmatter.mdx renamed to fern/products/docs/pages/guides/configuration/frontmatter.mdx

@@ -0,0 +1,7 @@
+---
+title: Project Structure
+---
+
+Learn about the recommended project structure and organization for your Fern documentation.
+
+<Warning>This page is a WIP, please refer to our previous [documentation](https://buildwithfern.com/learn/docs/getting-started/overview).</Warning>

fern/products/docs/pages/guides/configuration/project-structure.mdx

@@ -1,7 +1,26 @@
 ---
-title: Overview
+title: Documentation
+description: Meet documentation that is stunning by default, AI-ready, and designed to convert.
 ---
 
-Welcome to the Getting Started guide! This page provides an introduction to setting up and using your documentation site.
-
-<Warning>This page is a WIP, please refer to our previous [documentation](https://buildwithfern.com/learn/docs/getting-started/overview).</Warning> 
+<CardGroup cols={2}>
+  <Card title="Quickstart">
+    <Image src="/images/quickstart.png" alt="Quickstart" />
+    Start building beautiful documentation in under 5 minutes.
+  </Card>
+  
+  <Card title="Configure with ease">
+    <Image src="/images/configure.png" alt="Configure with ease" />
+    One simple file that can be used to generate documentation that fits your brand.
+  </Card>
+  
+  <Card title="Flexible component library">
+    <Image src="/images/component-library.png" alt="Flexible component library" />
+    Use pre-built or custom React components for a polished look.
+  </Card>
+  
+  <Card title="Visual Editor">
+    <Image src="/images/visual-editor.png" alt="Visual Editor" />
+    Modify your documentation without touching code and publish to your GitHub.
+  </Card>
+</CardGroup>