From 525b73449e2dfc7eaae8ee9b724afb822fd245b1 Mon Sep 17 00:00:00 2001
From: Rand McKinney <crandmck@yahoo.com>
Date: Thu, 5 Feb 2026 11:50:26 -0800
Subject: [PATCH] Move JSON manifest ref up in sidebar nav, add collapse button

---
 docs/manifest/json-ref/builder-ref.mdx  |  2 +-
 docs/manifest/json-ref/index.md         |  4 +-
 docs/manifest/json-ref/manifest-def.mdx |  2 +-
 docs/manifest/json-ref/reader-ref.mdx   |  2 +-
 docs/manifest/json-ref/settings-ref.mdx |  2 +-
 docusaurus.config.js                    | 24 +++--------
 sidebars.js                             | 56 ++++++++++++-------------
 7 files changed, 40 insertions(+), 52 deletions(-)

diff --git a/docs/manifest/json-ref/builder-ref.mdx b/docs/manifest/json-ref/builder-ref.mdx
index 3054e6b8..2db834cc 100644
--- a/docs/manifest/json-ref/builder-ref.mdx
+++ b/docs/manifest/json-ref/builder-ref.mdx
@@ -4,7 +4,7 @@ title: Builder reference
 hide_table_of_contents: true
 ---
 
-:::danger Warning
+:::note
 This is a beta release of this reference. It is a work in progress and may have issues or errors.
 :::
 
diff --git a/docs/manifest/json-ref/index.md b/docs/manifest/json-ref/index.md
index 05f9c754..f6b850e6 100644
--- a/docs/manifest/json-ref/index.md
+++ b/docs/manifest/json-ref/index.md
@@ -1,10 +1,10 @@
 ---
 id: index
-title: JSON manifest reference
+title: SDK object reference
 hide_table_of_contents: true
 ---
 
-:::danger Warning
+:::note
 This is a beta release of these references. It is a work in progress and may have issues or errors. 
 :::
 
diff --git a/docs/manifest/json-ref/manifest-def.mdx b/docs/manifest/json-ref/manifest-def.mdx
index 158c1b8b..d8e87710 100644
--- a/docs/manifest/json-ref/manifest-def.mdx
+++ b/docs/manifest/json-ref/manifest-def.mdx
@@ -4,7 +4,7 @@ title: ManifestDefinition reference
 hide_table_of_contents: true
 ---
 
-:::danger Warning
+:::note
 This is a beta release of this reference. It is a work in progress and may have issues or errors.
 :::
 
diff --git a/docs/manifest/json-ref/reader-ref.mdx b/docs/manifest/json-ref/reader-ref.mdx
index 97f5216d..21acd192 100644
--- a/docs/manifest/json-ref/reader-ref.mdx
+++ b/docs/manifest/json-ref/reader-ref.mdx
@@ -4,7 +4,7 @@ title: Reader reference
 hide_table_of_contents: true
 ---
 
-:::danger Warning
+:::note
 This is a beta release of this reference. It is a work in progress and may have issues or errors.
 :::
 
diff --git a/docs/manifest/json-ref/settings-ref.mdx b/docs/manifest/json-ref/settings-ref.mdx
index cd54b5e0..eac71e8a 100644
--- a/docs/manifest/json-ref/settings-ref.mdx
+++ b/docs/manifest/json-ref/settings-ref.mdx
@@ -4,7 +4,7 @@ title: Settings reference
 hide_table_of_contents: true
 ---
 
-:::danger Warning
+:::note
 This is a beta release of this reference. It is a work in progress and may have issues or errors.
 :::
 
diff --git a/docusaurus.config.js b/docusaurus.config.js
index d4651312..68913b91 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -130,29 +130,11 @@ const config = {
       metadata: [
         //  { property: 'twitter:card', content: 'summary_large_image' },
         { property: 'og:card', content: 'summary_large_image' },
-        /*  
-      {
-          property: 'twitter:image',
-          content:
-            'https://opensource.contentauthenticity.org/img/open-source@2x.png?v=1',
-        },
-        {
-          property: 'twitter:description',
-          content:
-            'Integrate secure provenance signals into your site, app, or service using open-source tools developed by the Content Authenticity Initiative.',
-        },
-        */
         {
           property: 'og:description',
           content:
             'Integrate secure provenance signals into your site, app, or service using open-source tools developed by the Content Authenticity Initiative.',
         },
-        /*
-        {
-          property: 'twitter:title',
-          content: 'Open-source tools for content authenticity and provenance',
-        },
-        */
         {
           property: 'og:title',
           content: 'Open-source tools for content authenticity and provenance',
@@ -163,6 +145,12 @@ const config = {
       colorMode: {
         disableSwitch: true,
       },
+      docs: {
+        sidebar: {
+          hideable: true,
+          autoCollapseCategories: true,
+        },
+      },
       navbar: {
         logo: {
           alt: 'Content Authenticity Initiative',
diff --git a/sidebars.js b/sidebars.js
index 9bdc569a..b3c72808 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -68,34 +68,6 @@ const sidebars = {
             },
           ],
         },
-        {
-          type: 'category',
-          label: 'JSON manifest reference',
-          link: { type: 'doc', id: 'manifest/json-ref/index' },
-          collapsed: true,
-          items: [
-            {
-              type: 'doc',
-              id: 'manifest/json-ref/reader-schema',
-              label: 'Reader',
-            },
-            {
-              type: 'doc',
-              id: 'manifest/json-ref/builder-schema',
-              label: 'Builder',
-            },
-            {
-              type: 'doc',
-              id: 'manifest/json-ref/manifest-definition-schema',
-              label: 'ManifestDefinition',
-            },
-            {
-              type: 'doc',
-              id: 'manifest/json-ref/settings-schema',
-              label: 'Settings',
-            },
-          ],
-        },
         {
           type: 'doc',
           id: 'manifest/manifest-examples',
@@ -229,6 +201,34 @@ const sidebars = {
         },
       ],
     },
+    {
+      type: 'category',
+      label: 'SDK object reference',
+      link: { type: 'doc', id: 'manifest/json-ref/index' },
+      collapsed: true,
+      items: [
+        {
+          type: 'doc',
+          id: 'manifest/json-ref/reader-schema',
+          label: 'Reader',
+        },
+        {
+          type: 'doc',
+          id: 'manifest/json-ref/builder-schema',
+          label: 'Builder',
+        },
+        {
+          type: 'doc',
+          id: 'manifest/json-ref/manifest-definition-schema',
+          label: 'ManifestDefinition',
+        },
+        {
+          type: 'doc',
+          id: 'manifest/json-ref/settings-schema',
+          label: 'Settings',
+        },
+      ],
+    },
     {
       type: 'category',
       label: 'Python library',