audience-specific sidebars

docs/guides/advertiser-dataprovider-guide.md

@@ -4,6 +4,7 @@ sidebar_label: Advertiser/Data Provider Integration Guide
 description: Covers integration steps for organizations that collect user data and push it to other UID2 participants.
 hide_table_of_contents: false
 sidebar_position: 07
+displayed_sidebar: sidebarAdvertisers
 ---
 
 # Advertiser/Data Provider Integration Guide

docs/intro.md

@@ -3,6 +3,7 @@ title: UID2 Overview
 description: Introduction to UID2 documentation.
 hide_table_of_contents: false
 sidebar_position: 01
+displayed_sidebar: docs
 ---
 
 # Unified ID 2.0 Overview

docs/overviews/overview-advertisers.md

@@ -6,12 +6,17 @@ sidebar_position: 04
 use_banner: true
 banner_title: UID2 Overview for Advertisers
 banner_description: Upgrade campaign activation with Unified ID 2.0.
+displayed_sidebar: sidebarAdvertisers
 ---
 
 As an advertiser, you can upgrade your first-party data tactics with Unified ID 2.0 (UID2) to deliver omnichannel campaigns across devices with one identifier, for more durable identity strategies and better addressability.
 
 Learn about benefits, workflow, documentation, and other resources for advertisers adopting UID2, as well as instructions for getting started.
 
+:::note
+If you want access in the left sidebar to the full set of UID2 documentation, see [Unified ID 2.0 Overview](../intro.md).
+:::
+
 ## Benefits of UID2 for Advertisers
 
 Here are just some of the intended benefits of using UID2 as part of your advertising strategy:

docs/overviews/overview-data-providers.md

@@ -6,6 +6,7 @@ sidebar_position: 08
 use_banner: true
 banner_title: UID2 Overview for Data Providers
 banner_description: An identity solution for the future.
+displayed_sidebar: sidebarDataProviders
 ---
 
 As a data and measurement provider, you can reduce identity fragmentation by adopting Unified ID 2.0 (UID2) to connect data with a more durable, omnichannel, and cross-device identifier to fulfil your customer use cases.
@@ -18,6 +19,10 @@ This solution is for you if you're offering data or related services for online
 
 Learn about the benefits, workflow, documentation, and other resources for data providers adopting UID2, as well as instructions for getting started.
 
+:::note
+If you want access in the left sidebar to the full set of UID2 documentation, see [Unified ID 2.0 Overview](../intro.md).
+:::
+
 ## Benefits of UID2 for Data Providers
 
 Here are just some of the intended benefits available to you as a data provider using UID2. You can:

docs/overviews/overview-dsps.md

@@ -6,6 +6,7 @@ sidebar_position: 06
 use_banner: true
 banner_title: UID2 Overview for DSPs
 banner_description: Enable data strategies with a more durable identifier.
+displayed_sidebar: sidebarDSPs
 ---
 
 As a demand-side platform (DSP, media-buying platform), you can facilitate identity strategies that leverage Unified ID 2.0 (UID2) to facilitate the following:
@@ -15,6 +16,10 @@ As a demand-side platform (DSP, media-buying platform), you can facilitate ident
 
 Learn about benefits, workflow, documentation, and other resources for DSPs adopting UID2, as well as instructions for getting started.
 
+:::note
+If you want access in the left sidebar to the full set of UID2 documentation, see [Unified ID 2.0 Overview](../intro.md).
+:::
+
 ## Benefits of UID2 for DSPs
 
 Here are just some of the intended benefits for DSPs using UID2. You can:

docs/overviews/overview-publishers.md

@@ -6,12 +6,17 @@ sidebar_position: 02
 use_banner: true
 banner_title: UID2 Overview for Publishers
 banner_description: Maintain audience targeting in the ever-changing advertising industry for better impression monetization and more relevance.
+displayed_sidebar: sidebarPublishers
 ---
 
 As a publisher, you can benefit from the cross-device presence of Unified ID 2.0 (UID2) and take advantage of a consistent identity fabric on all your inventory.
 
 Learn about benefits, workflow, documentation, and other resources for publishers adopting UID2, as well as instructions for getting started.
 
+:::note
+If you want access in the left sidebar to the full set of UID2 documentation, see [Unified ID 2.0 Overview](../intro.md).
+:::
+
 <!-- Learn about what the UID2 framework offers to publishers, including benefits, workflow, documentation and other resources, and how to get started. -->
 
 ## Benefits of UID2 for Publishers

sidebars.js

@@ -1,6 +1,22 @@
-const sidebars = {
-  docs: [
+function removeItems(sidebar, ...remove) {
+  const result = [];
+  for (let item of sidebar) {
+    if (typeof item === 'string') 
+    {
+      if (!remove.includes(item)) result.push(item);
+    }
+    else {
+      if (!remove.includes(item.label)) {
+        const {items, ...rest} = item;
+        const keepItems = removeItems(items, ...remove);
+        if (keepItems?.length > 0) result.push({...rest, items: keepItems});
+      }
+    }
+  }
+  return result;
+}
 
+const fullSidebar = [
     {
       type: 'category',
       label: 'UID2 Overview',
@@ -55,31 +71,14 @@ const sidebars = {
       ],
     },
 
-    {
-      type: 'category',
-      label: 'SDKs',
-      link: {
-        type: 'doc',
-        id: 'sdks/summary-sdks',
-      },
-      items: [
-        'sdks/client-side-identity',
-        'sdks/uid2-sdk-ref-java',
-        'sdks/uid2-sdk-ref-python',
-        'sdks/uid2-sdk-ref-csharp-dotnet',
-        'sdks/uid2-sdk-ref-cplusplus',
-        'sdks/uid2-sdk-ref-android',
-        'sdks/uid2-sdk-ref-ios',
-      ],
-    },
-
     {
       type: 'category',
       label: 'Integration Guides',
       link: {
         type: 'doc',
         id: 'guides/summary-guides',
       },
+      collapsed: false,
 
       items: [
 
@@ -89,7 +88,7 @@ const sidebars = {
           link: {
             type: 'generated-index',
           },
-          collapsed: true,
+          collapsed: false,
 
           items: [
           {
@@ -119,8 +118,7 @@ const sidebars = {
                 type: 'category',
                 label: 'JavaScript',
                 link: {
-                  type: 'doc',
-                  id: 'guides/integration-javascript',
+                  type: 'generated-index',
                 },
                 collapsed: true,
                 items: [
@@ -205,7 +203,26 @@ const sidebars = {
             'guides/operator-guide-azure-enclave',
           ],
         },
-       ],
+      ],
+    },
+
+    {
+      type: 'category',
+      label: 'SDKs',
+      link: {
+        type: 'doc',
+        id: 'sdks/summary-sdks',
+      },
+      collapsed: true,
+      items: [
+        'sdks/client-side-identity',
+        'sdks/uid2-sdk-ref-java',
+        'sdks/uid2-sdk-ref-python',
+        'sdks/uid2-sdk-ref-csharp-dotnet',
+        'sdks/uid2-sdk-ref-cplusplus',
+        'sdks/uid2-sdk-ref-android',
+        'sdks/uid2-sdk-ref-ios',
+      ],
     },
 
     {
@@ -215,6 +232,7 @@ const sidebars = {
         type: 'doc',
         id: 'endpoints/summary-endpoints',
       },
+      collapsed: true,
       items: [
         'endpoints/post-token-generate',
         'endpoints/post-token-validate',
@@ -231,6 +249,7 @@ const sidebars = {
         type: 'doc',
         id: 'sharing/sharing-overview',
       },
+      collapsed: true,
       items: [
         'sharing/sharing-use-cases',
         'sharing/sharing-implementing',
@@ -254,6 +273,152 @@ const sidebars = {
 
     'ref-info/glossary-uid',
     'ref-info/updates-doc',
-  ],
+  ];
+
+
+const sidebars = {
+  docs: fullSidebar,
+
+  sidebarPublishers: removeItems(fullSidebar, 
+    'overviews/overview-advertisers',
+    'overviews/overview-dsps',
+    'overviews/overview-data-providers',
+    'overviews/overview-operators-private',
+    'guides/advertiser-dataprovider-guide',
+    'guides/snowflake_integration',
+    'guides/integration-aws-entity-resolution',
+    'guides/dsp-guide',
+    'endpoints/post-identity-buckets',
+    'endpoints/post-identity-map'
+  ),
+
+  sidebarAdvertisers: removeItems(fullSidebar, 
+    'overviews/overview-publishers',
+    'overviews/overview-dsps',
+    'overviews/overview-data-providers',
+    'overviews/overview-operators-private',
+    'Publisher Integrations',
+    'Web',
+    'guides/integration-options-publisher-web',
+    'Prebid',
+    'guides/integration-prebid',
+    'guides/integration-prebid-client-side',
+    'guides/integration-prebid-server-side',
+    'JavaScript',
+    'guides/integration-javascript',
+    'guides/publisher-client-side',
+    'guides/integration-javascript-server-side',
+    'Server-Only',
+    'guides/custom-publisher-integration',
+    'GAM Secure Signals',
+    'guides/google-ss-integration',
+    'Mobile',
+    'guides/uid2-sdk-ref-android',
+    'guides/uid2-sdk-ref-ios',
+    'Prebid',
+    'guides/integration-prebid',
+    'guides/integration-prebid-client-side',
+    'guides/integration-prebid-server-side',
+    'Google Ad Manager',
+    'guides/google-ss-integration',
+    'guides/mobile-plugin-gma-android',
+    'guides/mobile-plugin-gma-ios',
+    'guides/mobile-plugin-ima-android',
+    'guides/mobile-plugin-ima-ios',
+    'guides/dsp-guide',
+    'sdks/client-side-identity',
+    'sdks/uid2-sdk-ref-android',
+    'sdks/uid2-sdk-ref-ios',
+    'endpoints/post-token-generate',
+    'endpoints/post-token-validate',
+    'endpoints/post-token-refresh',
+    'sharing/sharing-bid-stream'
+    ),
+
+  sidebarDSPs: removeItems(fullSidebar, 
+    'overviews/overview-publishers',
+    'overviews/overview-advertisers',
+    'overviews/overview-data-providers',
+    'overviews/overview-operators-private',
+    'Publisher Integrations',
+    'Web',
+    'guides/integration-options-publisher-web',
+    'Prebid',
+    'guides/integration-prebid',
+    'guides/integration-prebid-client-side',
+    'guides/integration-prebid-server-side',
+    'JavaScript',
+    'guides/integration-javascript',
+    'guides/publisher-client-side',
+    'guides/integration-javascript-server-side',
+    'Server-Only',
+    'guides/custom-publisher-integration',
+    'GAM Secure Signals',
+    'guides/google-ss-integration',
+    'Mobile',
+    'guides/uid2-sdk-ref-android',
+    'guides/uid2-sdk-ref-ios',
+    'Prebid',
+    'guides/integration-prebid',
+    'guides/integration-prebid-client-side',
+    'guides/integration-prebid-server-side',
+    'Google Ad Manager',
+    'guides/google-ss-integration',
+    'guides/mobile-plugin-gma-android',
+    'guides/mobile-plugin-gma-ios',
+    'guides/mobile-plugin-ima-android',
+    'guides/mobile-plugin-ima-ios',
+    'guides/advertiser-dataprovider-guide',
+    'guides/snowflake_integration',
+    'guides/integration-aws-entity-resolution',
+    'sdks/client-side-identity',
+    'sdks/uid2-sdk-ref-android',
+    'sdks/uid2-sdk-ref-ios',
+    'sharing/sharing-bid-stream'
+    ),
+
+  sidebarDataProviders: removeItems(fullSidebar, 
+    'overviews/overview-publishers',
+    'overviews/overview-advertisers',
+    'overviews/overview-dsps',
+    'overviews/overview-operators-private',
+    'Publisher Integrations',
+    'Web',
+    'guides/integration-options-publisher-web',
+    'Prebid',
+    'guides/integration-prebid',
+    'guides/integration-prebid-client-side',
+    'guides/integration-prebid-server-side',
+    'JavaScript',
+    'guides/integration-javascript',
+    'guides/publisher-client-side',
+    'guides/integration-javascript-server-side',
+    'Server-Only',
+    'guides/custom-publisher-integration',
+    'GAM Secure Signals',
+    'guides/google-ss-integration',
+    'Mobile',
+    'guides/uid2-sdk-ref-android',
+    'guides/uid2-sdk-ref-ios',
+    'Prebid',
+    'guides/integration-prebid',
+    'guides/integration-prebid-client-side',
+    'guides/integration-prebid-server-side',
+    'Google Ad Manager',
+    'guides/google-ss-integration',
+    'guides/mobile-plugin-gma-android',
+    'guides/mobile-plugin-gma-ios',
+    'guides/mobile-plugin-ima-android',
+    'guides/mobile-plugin-ima-ios',
+    'guides/dsp-guide',  
+    'sdks/client-side-identity',
+    'sdks/uid2-sdk-ref-android',
+    'sdks/uid2-sdk-ref-ios',
+    'endpoints/post-token-generate',
+    'endpoints/post-token-validate',
+    'endpoints/post-token-refresh',
+    'sharing/sharing-bid-stream'
+  ),
+
 };
 module.exports = sidebars;