WIP

autogen/_website/generate_api_references.py

@@ -174,7 +174,7 @@ def get_mdx_files(directory: Path) -> list[str]:
 def add_prefix(path: str, parent_groups: Optional[list[str]] = None) -> str:
     """Create full path with prefix and parent groups."""
     groups = parent_groups or []
-    return f"reference/{'/'.join(groups + [path])}"
+    return f"docs/api-reference/{'/'.join(groups + [path])}"
 
 
 def create_nav_structure(paths: list[str], parent_groups: Optional[list[str]] = None) -> list[Any]:
@@ -290,14 +290,14 @@ def _generate_overview(self, classes: list[str], functions: list[str], output_di
             overview += "\n\n## Classes\n"
             for symbol in sorted(classes):
                 href = output_dir / symbol
-                overview += f"""<p class="overview-symbol"><a href="/{str(href).replace("tmp/", "reference/")}"><code>class {symbol}</code></a></p>"""
+                overview += f"""<p class="overview-symbol"><a href="/{str(href).replace("tmp/", "docs/api-reference/")}"><code>class {symbol}</code></a></p>"""
             overview += "\n"
 
         if functions:
             overview += "\n\n## Functions\n"
             for symbol in sorted(functions):
                 href = output_dir / symbol
-                overview += f"""<p class="overview-symbol"><a href="/{str(href).replace("tmp/", "reference/")}"><code>{symbol}</code></a></p>"""
+                overview += f"""<p class="overview-symbol"><a href="/{str(href).replace("tmp/", "docs/api-reference/")}"><code>{symbol}</code></a></p>"""
             overview += "\n"
 
         return overview
@@ -372,7 +372,7 @@ def main() -> None:
         "--api-dir",
         type=Path,
         help="Directory containing API documentation to process",
-        default=website_dir / "reference",
+        default=website_dir / "docs" / "api-reference",
     )
 
     args = parser.parse_args()

website/docs/.gitignore

@@ -1 +1,2 @@
 topics
+api-reference

website/docs/use-cases/.gitignore

@@ -0,0 +1,2 @@
+community-gallery
+notebooks

website/docs/use-cases/reference-agents/captainagent.mdx

@@ -0,0 +1 @@
+TODO

website/docs/use-cases/reference-agents/communication-agents.mdx

@@ -0,0 +1 @@
+TODO

website/docs/use-cases/reference-agents/documentagent.mdx

@@ -0,0 +1 @@
+TODO

website/docs/use-cases/reference-agents/reasoningagent.mdx

@@ -0,0 +1 @@
+TODO

website/docs/use-cases/reference-agents/websurferagent.mdx

@@ -0,0 +1 @@
+TODO

website/docs/use-cases/sample-apps/sample-apps.mdx

@@ -0,0 +1 @@
+TODO

website/mint-json-template.json.jinja

@@ -49,11 +49,11 @@
     },
     {
       "name": "API References",
-      "url": "reference"
+      "url": "docs/api-reference"
     },
     {
       "name": "Use Cases",
-      "url": "use-cases"
+      "url": "docs/use-cases"
     },
     {
       "name": "Contribute",
@@ -66,6 +66,14 @@
     {
       "name": "Ecosystem",
       "url": "ecosystem"
+    },
+    {
+      "name": "Blog",
+      "url": "docs/blog"
+    },
+    {
+      "name": "Community Talks",
+      "url": "docs/talks"
     }
   ],
   "anchors": [],
@@ -115,8 +123,28 @@
     {
       "group": "Use Cases",
       "pages": [
-        "/use-cases/agent_chat",
-        "/use-cases/enhanced_inference"
+        {
+          "group": "Reference Agents",
+          "pages": [
+            "docs/use-cases/reference-agents/captainagent",
+            "docs/use-cases/reference-agents/communication-agents",
+            "docs/use-cases/reference-agents/documentagent",
+            "docs/use-cases/reference-agents/reasoningagent",
+            "docs/use-cases/reference-agents/websurferagent"
+          ]
+        },
+        {
+          "group": "Notebooks",
+          "pages": ["docs/use-cases/notebooks/notebooks"]
+        },
+        {
+          "group": "Sample Apps",
+          "pages": ["docs/use-cases/sample-apps/sample-apps"]
+        },
+        {
+          "group": "Community Gallery",
+          "pages": ["docs/use-cases/community-gallery/community-gallery"]
+        }
       ]
     },
     {

website/mint-script.js

@@ -1,7 +1,7 @@
 (function () {
   function updateClass() {
     document.body.classList.remove("reference-page");
-    if (window.location.pathname.includes("/reference/")) {
+    if (window.location.pathname.includes("/docs/api-reference/")) {
       document.body.classList.add("reference-page");
     }
   }