From 8145f65ccf8481b545bc0db1212875c3f7da306d Mon Sep 17 00:00:00 2001 From: Daniel Kimber Date: Tue, 10 Mar 2026 19:27:15 -0700 Subject: [PATCH 1/2] fix: remove duplicate path prefix from docs.json tab pages MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit When a tab has a `path` field (e.g. "/tutorials"), devdoc uses that as both the URL prefix and directory prefix when resolving pages. Pages must be listed relative to the tab path, not from the docs root. Before: tab path="/tutorials" + page "tutorials/index" → URL: /tutorials/tutorials/index → 404 on browser back/forward After: tab path="/tutorials" + page "index" → URL: /tutorials/index → correct Same fix applied to the API Reference tab pages. --- docs/docs.json | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/docs.json b/docs/docs.json index 979e17b..98e9e95 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -85,18 +85,18 @@ "group": "Getting Started", "icon": "rocket-launch", "pages": [ - "tutorials/index", - "tutorials/rql-basics" + "index", + "rql-basics" ] }, { "group": "Use Cases", "icon": "lightbulb", "pages": [ - "tutorials/document-relationships", - "tutorials/legal-search", - "tutorials/knowledge-base", - "tutorials/research-papers" + "document-relationships", + "legal-search", + "knowledge-base", + "research-papers" ] } ] @@ -117,8 +117,8 @@ "group": "Overview", "icon": "book-open", "pages": [ - "api-reference/introduction", - "api-reference/errors" + "introduction", + "errors" ] } ] From d355d2ed9d73eb153db26a4579fcdeeb73a1250a Mon Sep 17 00:00:00 2001 From: Daniel Kimber Date: Wed, 11 Mar 2026 09:26:52 -0700 Subject: [PATCH 2/2] fix: update Card hrefs to devdoc absolute URL format and restore docs.json MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Card components in MDX files used Mintlify-style relative hrefs (e.g. href="/tutorials/rql-basics"). With devdoc's resolveLink(), these get resolved using the current activeTab context, causing two bugs: 1. Tab-only links (href="/tutorials") navigate to /tutorials URL with no page context, showing a blank "Select an endpoint" state after the initial auto-navigation guard fires only once. 2. Cross-tab links (e.g. href="/tutorials/legal-search" from a Documentation page) resolve to /documentation/page/tutorials/legal-search — wrong tab, wrong sidebar. Fix: use devdoc's absolute URL format (href="/tutorials/page/tutorials/X") which bypasses the activeTab resolution entirely (resolveLink returns these unchanged when the path contains /page/). Also restore docs.json to correct state: pages must include the full path relative to docs root (e.g. "tutorials/index") so devdoc check can find the .mdx files. Reverts a bad prior attempt that stripped the prefix. Files changed: - docs/index.mdx: /tutorials → /tutorials/page/tutorials/index - docs/quickstart.mdx: /tutorials → /tutorials/page/tutorials/index - docs/guides/search.mdx: /tutorials/legal-search → absolute URL - docs/tutorials/index.mdx: all 8 Card hrefs → absolute URLs - docs/tutorials/rql-basics.mdx: /tutorials/legal-search → absolute URL - docs/tutorials/legal-search.mdx: /tutorials/knowledge-base → absolute URL - docs/tutorials/research-papers.mdx: /tutorials/rql-basics → absolute URL - docs/tutorials/knowledge-base.mdx: /tutorials/research-papers → absolute URL - docs/docs.json: restore tutorials/ prefix on page paths --- docs/docs.json | 16 +++++++-------- docs/guides/search.mdx | 2 +- docs/index.mdx | 2 +- docs/quickstart.mdx | 2 +- docs/tutorials/index.mdx | 32 +++++++++++++++--------------- docs/tutorials/knowledge-base.mdx | 2 +- docs/tutorials/legal-search.mdx | 2 +- docs/tutorials/research-papers.mdx | 2 +- docs/tutorials/rql-basics.mdx | 2 +- 9 files changed, 31 insertions(+), 31 deletions(-) diff --git a/docs/docs.json b/docs/docs.json index 98e9e95..979e17b 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -85,18 +85,18 @@ "group": "Getting Started", "icon": "rocket-launch", "pages": [ - "index", - "rql-basics" + "tutorials/index", + "tutorials/rql-basics" ] }, { "group": "Use Cases", "icon": "lightbulb", "pages": [ - "document-relationships", - "legal-search", - "knowledge-base", - "research-papers" + "tutorials/document-relationships", + "tutorials/legal-search", + "tutorials/knowledge-base", + "tutorials/research-papers" ] } ] @@ -117,8 +117,8 @@ "group": "Overview", "icon": "book-open", "pages": [ - "introduction", - "errors" + "api-reference/introduction", + "api-reference/errors" ] } ] diff --git a/docs/guides/search.mdx b/docs/guides/search.mdx index 9d2032a..a6fa734 100644 --- a/docs/guides/search.mdx +++ b/docs/guides/search.mdx @@ -264,7 +264,7 @@ REASON 'What are the indemnification obligations?' Organize content for efficient retrieval - + Build a complete contract search system diff --git a/docs/index.mdx b/docs/index.mdx index 557115f..c6e2a8e 100644 --- a/docs/index.mdx +++ b/docs/index.mdx @@ -199,7 +199,7 @@ REASON 'What are the termination conditions?' Extend extraction with custom plugins. - + Build real applications: legal search, research assistants, and more. diff --git a/docs/quickstart.mdx b/docs/quickstart.mdx index be601c3..978931f 100644 --- a/docs/quickstart.mdx +++ b/docs/quickstart.mdx @@ -387,7 +387,7 @@ This returns the complete tree with all nodes, summaries, and relationships. Docker Compose, environment variables, and production setup - + Build real-world applications diff --git a/docs/tutorials/index.mdx b/docs/tutorials/index.mdx index 361736f..ee318c7 100644 --- a/docs/tutorials/index.mdx +++ b/docs/tutorials/index.mdx @@ -8,7 +8,7 @@ Learn by building. These tutorials take you from concept to working application, ## Choose Your Path - + Start with **RQL Basics** to master the query language @@ -19,35 +19,35 @@ Learn by building. These tutorials take you from concept to working application, ## Tutorials - + **30 minutes** • Master ReasonDB's SQL-like query language - + Learn SELECT, WHERE, SEARCH, and REASON clauses. Understand how to combine structured queries with LLM reasoning for powerful hybrid search. - + **45 minutes** • Build a contract analysis system - + Ingest NDAs and service agreements. Search for specific clauses, compare terms across documents, and answer legal questions with cited sources. - - + + **45 minutes** • Create an academic research tool - + Build a system that searches scientific papers, synthesizes findings across studies, and extracts key methodologies and results. - - + + **30 minutes** • Deploy intelligent documentation search - + Transform static docs into an AI-powered Q&A system. Get precise answers instead of "related articles." - - + + **30 minutes** • Manage complex document hierarchies - + Link master agreements to amendments, track document versions, and query across related documents. @@ -93,10 +93,10 @@ Every tutorial follows the same structure: ## Ready? - + The recommended starting point for everyone - + If you're already comfortable with the basics diff --git a/docs/tutorials/knowledge-base.mdx b/docs/tutorials/knowledge-base.mdx index 0402fb8..844795e 100644 --- a/docs/tutorials/knowledge-base.mdx +++ b/docs/tutorials/knowledge-base.mdx @@ -362,7 +362,7 @@ SELECT title FROM knowledge_base WHERE tags CONTAINS ANY ('billing') LIMIT 3 ## Next Steps - + Analyze academic papers with ReasonDB diff --git a/docs/tutorials/legal-search.mdx b/docs/tutorials/legal-search.mdx index 751012a..094f054 100644 --- a/docs/tutorials/legal-search.mdx +++ b/docs/tutorials/legal-search.mdx @@ -375,7 +375,7 @@ REASON 'What clauses might be considered high-risk or unfavorable to Acme Corp?' ## Next Steps - + Build a Q&A system with ReasonDB diff --git a/docs/tutorials/research-papers.mdx b/docs/tutorials/research-papers.mdx index 2685036..c567f17 100644 --- a/docs/tutorials/research-papers.mdx +++ b/docs/tutorials/research-papers.mdx @@ -324,7 +324,7 @@ GROUP BY metadata.topic ## Next Steps - + Master the query language diff --git a/docs/tutorials/rql-basics.mdx b/docs/tutorials/rql-basics.mdx index 9c3b925..36ab0de 100644 --- a/docs/tutorials/rql-basics.mdx +++ b/docs/tutorials/rql-basics.mdx @@ -467,7 +467,7 @@ Test your RQL skills with these exercises: ## Next Steps - + Apply RQL to real legal documents