docs: add blog section with navbar dropdown and landing page (#6409)

Signed-off-by: Dan Gil <dagil@nvidia.com>
Co-authored-by: Cursor <cursoragent@cursor.com>

.github/workflows/fern-docs.yml

@@ -213,6 +213,13 @@ jobs:
             cp -r source-checkout/docs/components docs-checkout/fern/components
           fi
 
+          # Sync blogs/ directory
+          if [ -d source-checkout/docs/blogs ]; then
+            echo "Syncing blogs/ to docs-website branch..."
+            rm -rf docs-checkout/fern/blogs
+            cp -r source-checkout/docs/blogs docs-checkout/fern/blogs
+          fi
+
           # Sync main.css
           if [ -f source-checkout/docs/main.css ]; then
             echo "Syncing main.css to docs-website branch..."

docs/blogs/README.md

+# Adding a Blog Post
+
+Follow these steps to publish a new blog post on the Dynamo docs site.
+
+## Step 1: Write the Blog Post
+
+Create a new Markdown file in this folder (`docs/blogs/`):
+
+```text
+docs/blogs/my-post-slug.md
+```
+
+Use kebab-case for the filename. The filename becomes the URL slug
+(e.g., `my-post-slug.md` serves at `/dynamo/blog/my-post-slug`).
+
+Add frontmatter at the top of the file:
+
+```yaml
+---
+title: Your Blog Post Title
+description: A one-sentence summary shown in search results and social previews.
+---
+```
+
+## Step 2: Add the Post to Navigation
+
+Open `docs/versions/dev.yml` and add a page entry under the **Blog** section:
+
+```yaml
+  - section: Blog
+    contents:
+      - page: All Posts
+        path: ../blogs/index.mdx
+      - page: Your Blog Post Title
+        path: ../blogs/my-post-slug.md
+```
+
+Each new post gets a `- page:` entry after the landing page. The `page`
+value is the display name in the sidebar; the `path` points to your file.
+
+## Step 3: Add a Card to the Landing Page
+
+Open `docs/blogs/index.mdx` and add a `<Card>` inside the existing `<CardGroup>`:
+
+```mdx
+<Card
+  title="Your Blog Post Title"
+  icon="regular newspaper"
+  href="/dynamo/blog/my-post-slug"
+>
+  A brief summary of what this post covers (1-2 sentences).
+</Card>
+```
+
+### Card Fields
+
+| Field  | Required | Description                                              |
+|--------|----------|----------------------------------------------------------|
+| title  | Yes      | Post title displayed on the card                         |
+| icon   | No       | Font Awesome icon class (e.g., `regular bolt`)           |
+| href   | Yes      | URL path starting with `/dynamo/blog/`                   |
+| (body) | Yes      | Short summary text inside the Card tags                  |
+
+The `<CardGroup cols={2}>` wrapper is already in `index.mdx`. Just add your
+`<Card>` inside it.
+
+Browse icons at https://fontawesome.com/icons (Free tier).
+
+## Step 4 (Optional): Add the Post to the Navbar Dropdown
+
+Open `docs/docs.yml` and add a link under the Blog dropdown in `navbar-links`:
+
+```yaml
+navbar-links:
+  - type: dropdown
+    text: Blog
+    links:
+      - text: All Posts
+        href: /dynamo/blog
+      - text: Your Blog Post Title
+        href: /dynamo/blog/my-post-slug
+```
+
+Only add featured/recent posts here. The dropdown should stay short (5 items max).
+Posts that are no longer featured can be removed from the dropdown while remaining
+accessible from the landing page and sidebar.
+
+## Quick Checklist
+
+- [ ] Blog post `.md` file created in `docs/blogs/`
+- [ ] Page entry added to `docs/versions/dev.yml` under the Blog section
+- [ ] Card added to `docs/blogs/index.mdx`
+- [ ] (Optional) Link added to the Blog dropdown in `docs/docs.yml`

docs/blogs/index.mdx

+---
+title: Dynamo Blog
+description: Technical deep dives, announcements, and updates from the Dynamo team.
+---
+
+Technical deep dives, announcements, and updates from the Dynamo team.
+
+<CardGroup cols={2}>
+  {/* Add blog post cards here. See README.md in this folder for instructions. */}
+</CardGroup>

docs/docs.yml

@@ -37,6 +37,11 @@ redirects:
 
 # GitHub repository link in navbar
 navbar-links:
+  - type: dropdown
+    text: Blog
+    links:
+      - text: All Posts
+        href: /dynamo/blog
   - type: github
     value: https://github.com/ai-dynamo/dynamo
 

docs/versions/dev.yml

@@ -209,6 +209,13 @@ navigation:
       - page: Planner Design
         path: ../pages/design-docs/planner-design.md
 
+  # ==================== Blog ====================
+  - section: Blog
+    contents:
+      - page: All Posts
+        path: ../blogs/index.mdx
+        slug: blog
+
   # ==================== Hidden Pages ====================
   # Pages accessible via direct URL but not shown in main navigation.
   # Matches Sphinx hidden_toctree.rst -- pages linked from within content