From 536d23eb2a19d1e7643ec32b6e2f04b237058d46 Mon Sep 17 00:00:00 2001
From: Tyler Erickson <92862+tylere@users.noreply.github.com>
Date: Fri, 23 Oct 2026 16:13:13 -0700
Subject: [PATCH 1/2] docs: add analytics page describing the sidebar and
 owner/editor tab

Closes #42

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 docs/using-source/analytics.md | 23 +++++++++++++++++++++++
 sidebars.ts                    |  1 +
 2 files changed, 24 insertions(+)
 create mode 100644 docs/using-source/analytics.md

diff --git a/docs/using-source/analytics.md b/docs/using-source/analytics.md
new file mode 100644
index 0000000..28c0f3d
--- /dev/null
+++ b/docs/using-source/analytics.md
@@ -0,0 +1,23 @@
+---
+title: Analytics
+id: analytics
+slug: /analytics
+sidebar_position: 6
+---
+
+Source Cooperative provides two views of analytics for data products: a public sidebar visible to all visitors, and a detailed tab available to product owners and editors.
+
+## Analytics Sidebar
+
+Every public data product displays an analytics sidebar on its landing page. The sidebar shows summary statistics for the product, including request counts and data transfer volume. These metrics are visible to anyone who can view the product, giving potential users a sense of how actively a dataset is being used.
+
+## Analytics Tab
+
+Owners and editors of a data product can access the **Analytics** tab on the product page. This tab provides a more detailed breakdown of usage over time, including:
+
+- **Requests** — number of requests made to the product's data files
+- **Data transfer** — total bytes transferred to users
+- **Top files** — which files within the product are accessed most frequently
+- **Time range selector** — filter metrics by day, week, or month to spot usage trends
+
+To view the Analytics tab, open your data product page and click **Analytics** in the tab bar. The tab is only visible when you are signed in as an owner or editor of that product.
diff --git a/sidebars.ts b/sidebars.ts
index 2e1cf70..d10c2b3 100644
--- a/sidebars.ts
+++ b/sidebars.ts
@@ -43,6 +43,7 @@ const sidebars: SidebarsConfig = {
         },
         'using-source/bring-your-own-bucket',
         'using-source/data-proxy',
+        'using-source/analytics',
       ],
     },
     {

From 1515f8dff3c3475106ccaf63a504f1299976919d Mon Sep 17 00:00:00 2001
From: Tyler Erickson <92862+tylere@users.noreply.github.com>
Date: Fri, 23 Oct 2026 16:18:45 -0700
Subject: [PATCH 2/2] docs: use correct role names for analytics tab access
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Roles are owners, maintainers, and site admins — sourced from
ProductTabs.tsx tooltip text in source-cooperative/source.coop.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 docs/using-source/analytics.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/using-source/analytics.md b/docs/using-source/analytics.md
index 28c0f3d..19aaa54 100644
--- a/docs/using-source/analytics.md
+++ b/docs/using-source/analytics.md
@@ -13,11 +13,11 @@ Every public data product displays an analytics sidebar on its landing page. The
 
 ## Analytics Tab
 
-Owners and editors of a data product can access the **Analytics** tab on the product page. This tab provides a more detailed breakdown of usage over time, including:
+Owners, maintainers, and site admins of a data product can access the **Analytics** tab on the product page. This tab provides a more detailed breakdown of usage over time, including:
 
 - **Requests** — number of requests made to the product's data files
 - **Data transfer** — total bytes transferred to users
 - **Top files** — which files within the product are accessed most frequently
 - **Time range selector** — filter metrics by day, week, or month to spot usage trends
 
-To view the Analytics tab, open your data product page and click **Analytics** in the tab bar. The tab is only visible when you are signed in as an owner or editor of that product.
+To view the Analytics tab, open your data product page and click **ANALYTICS** in the tab bar. The tab is only visible when you are signed in as an owner, maintainer, or site admin of that product.