From 87b07b40c81ecd0ec36ec9947b8d317ef90fb48a Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Tue, 20 Jan 2026 19:57:49 -0800
Subject: [PATCH 01/34] Update .gitignore

---
 .gitignore | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.gitignore b/.gitignore
index 9f6ddb38..f45a283c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -47,3 +47,5 @@ cdn-dev
 
 .venv
 .claude
+
+__pycache__

From d14f97bc432850d487bbaffc3a8d225543f0d393 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Tue, 20 Jan 2026 19:58:27 -0800
Subject: [PATCH 02/34] Add since-version badge

---
 docs/macros.py             | 28 ++++++++++++++++++++++++++++
 docs/stylesheets/extra.css | 22 ++++++++++++++++++++++
 mkdocs.yml                 |  3 +++
 pixi.toml                  |  3 ++-
 4 files changed, 55 insertions(+), 1 deletion(-)
 create mode 100644 docs/macros.py

diff --git a/docs/macros.py b/docs/macros.py
new file mode 100644
index 00000000..d95e8727
--- /dev/null
+++ b/docs/macros.py
@@ -0,0 +1,28 @@
+# Copyright 2026 Columnar Technologies Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+def define_env(env):
+    @env.macro
+    def since_version(version):
+        """Create a "since v1.2.3" badge for annotation featuresw ith.
+
+        Args:
+            version: git tag for version
+        """
+        return (
+            f'<span class="version-badge">'
+            f'<a href="https://github.com/columnar-tech/dbc/releases/{version}" target="_blank">SINCE {version}</a>'
+            f'</span>'
+        )
diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
index 8b8f5244..b1577b57 100644
--- a/docs/stylesheets/extra.css
+++ b/docs/stylesheets/extra.css
@@ -2,6 +2,28 @@
   --md-default-bg-color: rgb(33, 33, 33);
   --md-code-bg-color: rgb(45, 45, 45);
 }
+
+/* since_version badge styling. see macros.py */
+.version-badge {
+  background: var(--md-accent-fg-color);
+  color: var(--md-accent-bg-color);
+  padding: 2px 6px;
+  border-radius: 3px;
+  font-size: 0.75em;
+  font-weight: bold;
+  display: inline-block;
+}
+
+.version-badge a {
+  color: inherit;
+  text-decoration: none;
+}
+
+.version-badge a:hover {
+  color: inherit;
+  text-decoration: underline;
+}
+
 /* Hide the site name in the header... */
 .md-header__title .md-header__topic:first-of-type {
   display: none !important;
diff --git a/mkdocs.yml b/mkdocs.yml
index 14c22367..e5d11434 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -46,6 +46,7 @@ nav:
       - Using a Driver List: guides/driver_list.md
       - Driver Managers: guides/driver_manager.md
       - Python Notebooks: guides/python_notebooks.md
+      - Private Registries: guides/private_registries.md
   - Concepts:
       - concepts/index.md
       - Driver: concepts/driver.md
@@ -119,6 +120,8 @@ exclude_docs: |
 extra_javascript:
   - scripts/extra.js
 plugins:
+  - macros:
+      module_name: docs/macros
   - privacy
   - search
   - social:
diff --git a/pixi.toml b/pixi.toml
index 6fa35ba1..59aab115 100644
--- a/pixi.toml
+++ b/pixi.toml
@@ -35,8 +35,9 @@ cdn-generate = "python scripts/cdn.py"
 cdn-serve = "python -m http.server -d cdn-dev"
 
 [feature.docs.pypi-dependencies]
-mkdocs-material = { version = "*", extras = ["imaging"] }
 mkdocs-llmstxt = "*"
+mkdocs-material = { version = "*", extras = ["imaging"] }
+mkdocs-macros-plugin = "*"
 
 [feature.docs.dependencies]
 cairo = ">=1.18.4,<2"

From 5471686b5149829be99bcd352579569a30d4939a Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Tue, 20 Jan 2026 19:58:37 -0800
Subject: [PATCH 03/34] add auth command to cli docs

---
 docs/reference/cli.md | 47 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index 4ac5f054..5a0e840a 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -46,6 +46,7 @@ $ dbc [OPTIONS] <COMMAND>
 <dt><a href="#sync">dbc sync</a></dt><dd><p>Install the drivers from the <a href="../../concepts/driver_list/">driver list</a></p></dd>
 <dt><a href="#info">dbc info</a></dt><dd><p>Get information about a driver</p></dd>
 <dt><a href="#docs">dbc docs</a></dt><dd><p>Open driver documentation in a web browser</p></dd>
+<dt><a href="#auth">dbc auth</a></dt><dd><p>Manage driver registry credentials</p></dd>
 </dl>
 
 ## search
@@ -301,3 +302,49 @@ $ dbc docs <DRIVER>
 `--quiet`, `-q`
 
 :   Suppress all output
+
+## auth
+
+{{ since_version('v0.2.0') }}
+
+<h3>Usage</h3>
+
+```console
+$ dbc auth
+$ dbc auth login
+$ dbc auth logout
+```
+
+<h3>Subcommands</h3>
+
+### login
+
+<h3>Arguments</h3>
+
+`REGISTRYURL`
+
+:   Optional. URL of the driver registry to authenticate with.
+
+<h3>Options</h3>
+
+`--clientid CLIENTID`
+
+:   OAuth Client ID (can also be set via `DBC_OAUTH_CLIENT_ID`)
+
+`--api-key API-KEY`
+
+:   Authenticate using an API key instead of OAuth (use '-' to read from stdin)
+
+### logout
+
+<h3>Arguments</h3>
+
+`REGISTRYURL`
+
+:   Optional. URL of the driver registry to log out from
+
+<h3>Options</h3>
+
+`--purge`
+
+:   Remove all local auth credentials for dbc

From 444959f27d510c8f3203c2c06d164da778deef72 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Tue, 20 Jan 2026 19:58:47 -0800
Subject: [PATCH 04/34] add note in finding drivers about auth

---
 docs/guides/finding_drivers.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/guides/finding_drivers.md b/docs/guides/finding_drivers.md
index be8e52c5..cab396e9 100644
--- a/docs/guides/finding_drivers.md
+++ b/docs/guides/finding_drivers.md
@@ -49,6 +49,18 @@ $ dbc search sql
 • sqlite - An ADBC driver for SQLite developed under the Apache Software Foundation
 ```
 
+## Private Drivers
+
+If you are [logged in](./private_registries.md) to a private registry, you will see some drivers marked with a `[private]` label:
+
+```console
+$ go run ./cmd/dbc search
+...
+oracle [private] An ADBC driver for Oracle Database developed by Columnar
+```
+
+These drivers can be [installed](./installing.md) and added to [driver lists](../concepts/driver_list.md) just like regular drivers.
+
 ## Options
 
 ### Verbose

From fc66ed699376740f1010b066ef42b859552273c8 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Tue, 20 Jan 2026 20:22:24 -0800
Subject: [PATCH 05/34] add private drivers guide

---
 docs/guides/private_drivers.md | 39 ++++++++++++++++++++++++++++++++++
 mkdocs.yml                     |  2 +-
 2 files changed, 40 insertions(+), 1 deletion(-)
 create mode 100644 docs/guides/private_drivers.md

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
new file mode 100644
index 00000000..cc3bc06b
--- /dev/null
+++ b/docs/guides/private_drivers.md
@@ -0,0 +1,39 @@
+<!--
+Copyright 2026 Columnar Technologies Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+
+# Private Drivers
+
+{{ since_version('v0.2.0') }}
+
+Most drivers available with dbc are hosted on Columnar's public [driver registry](../reference/driver_registry.md). Some of the drivers you see when you run dbc search may be marked with a `[private]` label. These drivers require logging in to install and a license to use.
+
+## Logging In
+
+To log into Columnar's private registry, run `dbc auth login`. You will see the following in your terminal and your default web browser will be opened:
+
+```console
+$ go run ./cmd/dbc auth login
+Opening https://auth.columnar.tech/activate?user_code=XXXX-XXXX in your default web browser...
+⠏ Waiting for confirmation...
+```
+
+In your browser, you will see a "Device Confirmation" prompt and, once you click "Continue", you will be redirected to log in with your login provider of choice.
+
+## Starting a Trial
+
+To use any drivers you install marked with `[private]`, you must obtain a obtain a license. Licenses can be obtained from your [Account](https://cloud.columnar.tech/account) page by clicking "Start Free 14-Day Trial".
+
+Once your license is created in the web interface, you do not need to download the license manually. If you ran `dbc auth login` before starting a license, you will need to run `dbc auth logout` and then run `dbc auth login` again to download your license.
diff --git a/mkdocs.yml b/mkdocs.yml
index e5d11434..3689ae66 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -46,7 +46,7 @@ nav:
       - Using a Driver List: guides/driver_list.md
       - Driver Managers: guides/driver_manager.md
       - Python Notebooks: guides/python_notebooks.md
-      - Private Registries: guides/private_registries.md
+      - Private Drivers: guides/private_drivers.md
   - Concepts:
       - concepts/index.md
       - Driver: concepts/driver.md

From eb7292b09b030694448887e7dab3ff09c86b1ba3 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Tue, 20 Jan 2026 20:24:59 -0800
Subject: [PATCH 06/34] fix typo in macros.py docstring and broken link in
 finding_drivers.md

---
 docs/guides/finding_drivers.md | 2 +-
 docs/macros.py                 | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/guides/finding_drivers.md b/docs/guides/finding_drivers.md
index cab396e9..795c307b 100644
--- a/docs/guides/finding_drivers.md
+++ b/docs/guides/finding_drivers.md
@@ -51,7 +51,7 @@ $ dbc search sql
 
 ## Private Drivers
 
-If you are [logged in](./private_registries.md) to a private registry, you will see some drivers marked with a `[private]` label:
+If you are [logged in](./private_drivers.md) to a private registry, you will see some drivers marked with a `[private]` label:
 
 ```console
 $ go run ./cmd/dbc search
diff --git a/docs/macros.py b/docs/macros.py
index d95e8727..6296ecd7 100644
--- a/docs/macros.py
+++ b/docs/macros.py
@@ -16,7 +16,7 @@
 def define_env(env):
     @env.macro
     def since_version(version):
-        """Create a "since v1.2.3" badge for annotation featuresw ith.
+        """Create a "since v1.2.3" badge for annotation features with.
 
         Args:
             version: git tag for version

From 2d193cc9168b75b814c29c3ddd553ebc824c2060 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Wed, 21 Jan 2026 10:02:49 -0800
Subject: [PATCH 07/34] Update docs/guides/private_drivers.md

Co-authored-by: Ian Cook <ianmcook@gmail.com>
---
 docs/guides/private_drivers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index cc3bc06b..8368ba88 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -18,7 +18,7 @@ limitations under the License.
 
 {{ since_version('v0.2.0') }}
 
-Most drivers available with dbc are hosted on Columnar's public [driver registry](../reference/driver_registry.md). Some of the drivers you see when you run dbc search may be marked with a `[private]` label. These drivers require logging in to install and a license to use.
+Most drivers available with dbc are hosted on Columnar's public [driver registry](../reference/driver_registry.md). Some of the drivers you see when you run `dbc search` may be marked with a `[private]` label. These drivers require logging in to install and a license to use.
 
 ## Logging In
 

From fcd6adedef8d6a3dc11d8856237b112bbdf32d11 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Wed, 21 Jan 2026 10:02:56 -0800
Subject: [PATCH 08/34] Update docs/guides/private_drivers.md

Co-authored-by: Ian Cook <ianmcook@gmail.com>
---
 docs/guides/private_drivers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index 8368ba88..6f851f91 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -22,7 +22,7 @@ Most drivers available with dbc are hosted on Columnar's public [driver registry
 
 ## Logging In
 
-To log into Columnar's private registry, run `dbc auth login`. You will see the following in your terminal and your default web browser will be opened:
+To log into Columnar's private driver registry, run `dbc auth login`. You will see the following in your terminal and your default web browser will be opened:
 
 ```console
 $ go run ./cmd/dbc auth login

From 6c0df8c804991b73cd77858e7394a9cd4d49e9ac Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Wed, 21 Jan 2026 10:03:03 -0800
Subject: [PATCH 09/34] Update docs/guides/private_drivers.md

Co-authored-by: Ian Cook <ianmcook@gmail.com>
---
 docs/guides/private_drivers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index 6f851f91..136afa3a 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -25,7 +25,7 @@ Most drivers available with dbc are hosted on Columnar's public [driver registry
 To log into Columnar's private driver registry, run `dbc auth login`. You will see the following in your terminal and your default web browser will be opened:
 
 ```console
-$ go run ./cmd/dbc auth login
+$ dbc auth login
 Opening https://auth.columnar.tech/activate?user_code=XXXX-XXXX in your default web browser...
 ⠏ Waiting for confirmation...
 ```

From 66a0f04875b425d2e1660b60f791a9f5978d328c Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Wed, 21 Jan 2026 10:03:16 -0800
Subject: [PATCH 10/34] Update docs/guides/private_drivers.md

Co-authored-by: Ian Cook <ianmcook@gmail.com>
---
 docs/guides/private_drivers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index 136afa3a..d77f5b93 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -30,7 +30,7 @@ Opening https://auth.columnar.tech/activate?user_code=XXXX-XXXX in your default
 ⠏ Waiting for confirmation...
 ```
 
-In your browser, you will see a "Device Confirmation" prompt and, once you click "Continue", you will be redirected to log in with your login provider of choice.
+In your browser, you will see a **Device Confirmation** prompt and, once you click **Continue**, you will be redirected to log in with your login provider of choice.
 
 ## Starting a Trial
 

From d79ac95c7848383e8c2b718ffbbdc4d5163351e9 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Wed, 21 Jan 2026 10:14:32 -0800
Subject: [PATCH 11/34] Update docs/guides/private_drivers.md

Co-authored-by: Ian Cook <ianmcook@gmail.com>
---
 docs/guides/private_drivers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index d77f5b93..b6324292 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -34,6 +34,6 @@ In your browser, you will see a **Device Confirmation** prompt and, once you cli
 
 ## Starting a Trial
 
-To use any drivers you install marked with `[private]`, you must obtain a obtain a license. Licenses can be obtained from your [Account](https://cloud.columnar.tech/account) page by clicking "Start Free 14-Day Trial".
+To use any drivers you install marked with `[private]`, you must obtain a obtain a license. Licenses can be obtained from your [Account](https://cloud.columnar.tech/account) page by clicking **Start Free 14-Day Trial**.
 
 Once your license is created in the web interface, you do not need to download the license manually. If you ran `dbc auth login` before starting a license, you will need to run `dbc auth logout` and then run `dbc auth login` again to download your license.

From 9d3c1a462877db1ad3601b857c26fa9c9cbd9860 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Wed, 21 Jan 2026 10:14:54 -0800
Subject: [PATCH 12/34] Update docs/guides/finding_drivers.md

Co-authored-by: Ian Cook <ianmcook@gmail.com>
---
 docs/guides/finding_drivers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/finding_drivers.md b/docs/guides/finding_drivers.md
index 795c307b..e7ab8a68 100644
--- a/docs/guides/finding_drivers.md
+++ b/docs/guides/finding_drivers.md
@@ -54,7 +54,7 @@ $ dbc search sql
 If you are [logged in](./private_drivers.md) to a private registry, you will see some drivers marked with a `[private]` label:
 
 ```console
-$ go run ./cmd/dbc search
+$ dbc search
 ...
 oracle [private] An ADBC driver for Oracle Database developed by Columnar
 ```

From ebe0c5102ad33ed16f4d2d2ce671115a5cf44ff3 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 13:32:14 -0800
Subject: [PATCH 13/34] Update docs/guides/private_drivers.md

Co-authored-by: Ian Cook <ianmcook@gmail.com>
---
 docs/guides/private_drivers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index b6324292..1d08e6c5 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -36,4 +36,4 @@ In your browser, you will see a **Device Confirmation** prompt and, once you cli
 
 To use any drivers you install marked with `[private]`, you must obtain a obtain a license. Licenses can be obtained from your [Account](https://cloud.columnar.tech/account) page by clicking **Start Free 14-Day Trial**.
 
-Once your license is created in the web interface, you do not need to download the license manually. If you ran `dbc auth login` before starting a license, you will need to run `dbc auth logout` and then run `dbc auth login` again to download your license.
+After creating your license in the web interface, you don't need to download the license file manually. If you've logged in using `dbc auth login`, dbc will automatically fetch the license file when needed.

From 1b917ed708b3a56acd4f8a9ea50e6fcc6e15dbd5 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 13:36:49 -0800
Subject: [PATCH 14/34] Update private_drivers.md

---
 docs/guides/private_drivers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index 1d08e6c5..e7959351 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -30,7 +30,7 @@ Opening https://auth.columnar.tech/activate?user_code=XXXX-XXXX in your default
 ⠏ Waiting for confirmation...
 ```
 
-In your browser, you will see a **Device Confirmation** prompt and, once you click **Continue**, you will be redirected to log in with your login provider of choice.
+In your browser, you will see a **Device Confirmation** prompt and, once you click **Confirm**, you will be redirected to log in with your login provider of choice.
 
 ## Starting a Trial
 

From 8e4e304bb9d9de2208984d21503228e5841fd497 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 14:18:47 -0800
Subject: [PATCH 15/34] rework private drivers

---
 docs/guides/private_drivers.md | 34 ++++++++++++++++++++++++++++++----
 1 file changed, 30 insertions(+), 4 deletions(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index e7959351..9b2895d5 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -18,7 +18,14 @@ limitations under the License.
 
 {{ since_version('v0.2.0') }}
 
-Most drivers available with dbc are hosted on Columnar's public [driver registry](../reference/driver_registry.md). Some of the drivers you see when you run `dbc search` may be marked with a `[private]` label. These drivers require logging in to install and a license to use.
+Most drivers available with dbc are hosted on Columnar's public [driver registry](../reference/driver_registry.md). However, some of the drivers you see when you run `dbc search` may be marked with a `[private]` label.
+
+To use these drivers, you must:
+
+1. Log in to [Columnar Cloud](https://cloud.columnar.tech) with dbc
+2. Start a trial license
+
+Continue reading to learn how to log in and get a trial license.
 
 ## Logging In
 
@@ -30,10 +37,29 @@ Opening https://auth.columnar.tech/activate?user_code=XXXX-XXXX in your default
 ⠏ Waiting for confirmation...
 ```
 
-In your browser, you will see a **Device Confirmation** prompt and, once you click **Confirm**, you will be redirected to log in with your login provider of choice.
+In your browser, you will see a **Device Confirmation** prompt and, once you click **Confirm**, you will be redirected to log in with your login provider of choice. Once you log in, you will be redirected to [Columnar Cloud](https://cloud.columnar.tech/). Keep the tab open and continue on to the next step.
 
 ## Starting a Trial
 
-To use any drivers you install marked with `[private]`, you must obtain a obtain a license. Licenses can be obtained from your [Account](https://cloud.columnar.tech/account) page by clicking **Start Free 14-Day Trial**.
+To use drivers marked with `[private]`, you must obtain a obtain a license. This is a separate step from logging in.
+
+Licenses can be obtained from your [Account](https://cloud.columnar.tech/account) page on Columnar Cloud by clicking **Start Free 14-Day Trial**. Follow any instructions in the dialog that opens up and click **Accept** to create your license.
+
+!!! warning
+
+    dbc can automatically fetch your license but only if you run `dbc auth logout` and run `dbc auth login` again after starting your trial.
+
+    For example, you will most likely follow these steps to use a private driver after you set up your account:
+
+    1. Run `dbc auth login`
+    2. Create a trial license on your [Account](https://cloud.columnar.tech/account) page
+    3. Run `dbc auth logout`
+    4. Run `dbc auth login`
+
+If you'd prefer to download the license manually, you can click **Download License File** and place the downloaded file in the appropriate location for your operating system:
+
+- Windows: `%LocalAppData%/dbc/credentials`
+- macOS:  `~/Library/Application Support/Columnar/dbc/credentials`
+- Linux: `~/.local/share/dbc/credentials`
 
-After creating your license in the web interface, you don't need to download the license file manually. If you've logged in using `dbc auth login`, dbc will automatically fetch the license file when needed.
+You may also use a custom location by setting the environment variable `XDG_DATA_HOME` to an absolute path of your choosing.

From 7da9fc209a6f9f1740f80939057cd031fe095090 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 14:22:40 -0800
Subject: [PATCH 16/34] Update cli.md

---
 docs/reference/cli.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index 5a0e840a..44e5be79 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -323,7 +323,7 @@ $ dbc auth logout
 
 `REGISTRYURL`
 
-:   Optional. URL of the driver registry to authenticate with.
+:   Optional. URL of the driver registry to authenticate with. Defaults to Columnar's private driver registry if not provided.
 
 <h3>Options</h3>
 

From b0029cd1b2bd5aa6621f138424223ed404d69360 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 14:28:35 -0800
Subject: [PATCH 17/34] Update cli.md

---
 docs/reference/cli.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index 44e5be79..4c6aef84 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -323,7 +323,7 @@ $ dbc auth logout
 
 `REGISTRYURL`
 
-:   Optional. URL of the driver registry to authenticate with. Defaults to Columnar's private driver registry if not provided.
+:   Optional. URL of the driver registry to authenticate with. Defaults to [https://dbc-cdn-private.columnar.tech/](https://dbc-cdn-private.columnar.tech/).
 
 <h3>Options</h3>
 

From 1e166b97be9eedcbbb3f20995bbe8119c597b645 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 15:01:46 -0800
Subject: [PATCH 18/34] Update private_drivers.md

---
 docs/guides/private_drivers.md | 24 ++++++++++++++++++------
 1 file changed, 18 insertions(+), 6 deletions(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index 9b2895d5..09a812bb 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -25,7 +25,7 @@ To use these drivers, you must:
 1. Log in to [Columnar Cloud](https://cloud.columnar.tech) with dbc
 2. Start a trial license
 
-Continue reading to learn how to log in and get a trial license.
+Continue reading to learn how to log in start a trial.
 
 ## Logging In
 
@@ -37,22 +37,22 @@ Opening https://auth.columnar.tech/activate?user_code=XXXX-XXXX in your default
 ⠏ Waiting for confirmation...
 ```
 
-In your browser, you will see a **Device Confirmation** prompt and, once you click **Confirm**, you will be redirected to log in with your login provider of choice. Once you log in, you will be redirected to [Columnar Cloud](https://cloud.columnar.tech/). Keep the tab open and continue on to the next step.
+In your browser, you will see a **Device Confirmation** prompt and, once you click **Confirm**, you will be redirected to log in with the provider of your choice. Once you log in, you will be redirected to [Columnar Cloud](https://cloud.columnar.tech/). Keep the tab open and continue on to the next step.
 
 ## Starting a Trial
 
-To use drivers marked with `[private]`, you must obtain a obtain a license. This is a separate step from logging in.
+While you can install private drivers without a trial, you must have a license to use one. This is a separate step from logging in.
 
 Licenses can be obtained from your [Account](https://cloud.columnar.tech/account) page on Columnar Cloud by clicking **Start Free 14-Day Trial**. Follow any instructions in the dialog that opens up and click **Accept** to create your license.
 
 !!! warning
 
-    dbc can automatically fetch your license but only if you run `dbc auth logout` and run `dbc auth login` again after starting your trial.
+    dbc can automatically obtain your license but only if you run `dbc auth logout` and run `dbc auth login` again after starting your trial.
 
-    For example, you will most likely follow these steps to use a private driver after you set up your account:
+    For example, you will most likely follow these steps the first time you
 
     1. Run `dbc auth login`
-    2. Create a trial license on your [Account](https://cloud.columnar.tech/account) page
+    2. Start a trial license on your [Account](https://cloud.columnar.tech/account) page
     3. Run `dbc auth logout`
     4. Run `dbc auth login`
 
@@ -63,3 +63,15 @@ If you'd prefer to download the license manually, you can click **Download Licen
 - Linux: `~/.local/share/dbc/credentials`
 
 You may also use a custom location by setting the environment variable `XDG_DATA_HOME` to an absolute path of your choosing.
+
+## Logging Out
+
+To log out, run `dbc auth logout`.
+
+By default, the `logout` command doesn't purge any driver licenses from your system and only removes your login credentials. If you wish remove the local copy of your license run:
+
+```console
+$ dbc auth logout --purge
+```
+
+Note that this command only removes the local copy of your license and does not cancel your trial.

From 634d171ce4c0214988b350a9802f6dbff0007c65 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 15:18:10 -0800
Subject: [PATCH 19/34] Update driver_registry.md

---
 docs/concepts/driver_registry.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/concepts/driver_registry.md b/docs/concepts/driver_registry.md
index 621b1954..df744bb4 100644
--- a/docs/concepts/driver_registry.md
+++ b/docs/concepts/driver_registry.md
@@ -16,6 +16,8 @@ limitations under the License.
 
 # Driver Registry
 
-dbc installs drivers from a "driver registry" which is an internet-accessible index of installable [ADBC driver](./driver.md) packages. Currently, dbc supports a single driver registry which is located at [https://dbc-cdn.columnar.tech](https://dbc-cdn.columnar.tech) and is managed by [Columnar](https://columnar.tech).
+dbc installs drivers from a "driver registry" which is an internet-accessible index of installable [ADBC driver](./driver.md) packages.
 
-When you run a command like [`dbc search`](../reference/cli.md#search) or [`dbc install`](../reference/cli.md#install), dbc gets information about the drivers that are available in the driver registry by downloading `index.yaml` from [https://dbc-cdn.columnar.tech](https://dbc-cdn.columnar.tech/index.yaml) or using a cached copy.
+By default, dbc is configured to communicate with Columnar's public and private driver registries. Most drivers will be from the public registry but some will be marked with a `[private]` label which means they're from the private registry. See [Private Drivers](../guides/private_drivers.md) for information on how to install and use private drivers.
+
+When you run a command like [`dbc search`](../reference/cli.md#search) or [`dbc install`](../reference/cli.md#install), dbc gets information about the drivers that are available from each configured registry by downloading its `index.yaml` or using a cached copy.

From 86e37261e062fd278e0ebf922555964966c49fec Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 15:37:43 -0800
Subject: [PATCH 20/34] boop

---
 docs/guides/private_drivers.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index 09a812bb..ac50a0b1 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -75,3 +75,7 @@ $ dbc auth logout --purge
 ```
 
 Note that this command only removes the local copy of your license and does not cancel your trial.
+
+## API Keys
+
+TODO

From 631b2f5e4338f4b3b89dab73c7464d223d3c3805 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 15:43:44 -0800
Subject: [PATCH 21/34] Update private_drivers.md

---
 docs/guides/private_drivers.md | 11 ++---------
 1 file changed, 2 insertions(+), 9 deletions(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index ac50a0b1..fc34a207 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -45,16 +45,9 @@ While you can install private drivers without a trial, you must have a license t
 
 Licenses can be obtained from your [Account](https://cloud.columnar.tech/account) page on Columnar Cloud by clicking **Start Free 14-Day Trial**. Follow any instructions in the dialog that opens up and click **Accept** to create your license.
 
-!!! warning
+### Downloading Your License
 
-    dbc can automatically obtain your license but only if you run `dbc auth logout` and run `dbc auth login` again after starting your trial.
-
-    For example, you will most likely follow these steps the first time you
-
-    1. Run `dbc auth login`
-    2. Start a trial license on your [Account](https://cloud.columnar.tech/account) page
-    3. Run `dbc auth logout`
-    4. Run `dbc auth login`
+dbc will automatically download your license when you try to install a private driver after you start your trial.
 
 If you'd prefer to download the license manually, you can click **Download License File** and place the downloaded file in the appropriate location for your operating system:
 

From ce3a55e17c7c030f253f1f160a9f92ff20ff0536 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 15:47:05 -0800
Subject: [PATCH 22/34] Update private_drivers.md

---
 docs/guides/private_drivers.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index fc34a207..eb87d665 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -20,7 +20,7 @@ limitations under the License.
 
 Most drivers available with dbc are hosted on Columnar's public [driver registry](../reference/driver_registry.md). However, some of the drivers you see when you run `dbc search` may be marked with a `[private]` label.
 
-To use these drivers, you must:
+To install and use these drivers, you must:
 
 1. Log in to [Columnar Cloud](https://cloud.columnar.tech) with dbc
 2. Start a trial license
@@ -41,7 +41,7 @@ In your browser, you will see a **Device Confirmation** prompt and, once you cli
 
 ## Starting a Trial
 
-While you can install private drivers without a trial, you must have a license to use one. This is a separate step from logging in.
+To install and use a private driver, you must start a trial and obtain a license. This is a separate step from logging in.
 
 Licenses can be obtained from your [Account](https://cloud.columnar.tech/account) page on Columnar Cloud by clicking **Start Free 14-Day Trial**. Follow any instructions in the dialog that opens up and click **Accept** to create your license.
 

From 9c948d6ef548b5531a967ff1827eb86bf8d39f70 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 15:59:07 -0800
Subject: [PATCH 23/34] Update private_drivers.md

---
 docs/guides/private_drivers.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index eb87d665..30686b4b 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -47,7 +47,10 @@ Licenses can be obtained from your [Account](https://cloud.columnar.tech/account
 
 ### Downloading Your License
 
-dbc will automatically download your license when you try to install a private driver after you start your trial.
+dbc will automatically download your license if you:
+
+1. Have an active license
+2. Run `dbc install` with a private driver
 
 If you'd prefer to download the license manually, you can click **Download License File** and place the downloaded file in the appropriate location for your operating system:
 
@@ -55,7 +58,7 @@ If you'd prefer to download the license manually, you can click **Download Licen
 - macOS:  `~/Library/Application Support/Columnar/dbc/credentials`
 - Linux: `~/.local/share/dbc/credentials`
 
-You may also use a custom location by setting the environment variable `XDG_DATA_HOME` to an absolute path of your choosing.
+You may also use a custom location by setting the environment variable `XDG_DATA_HOME` to an absolute path of your choosing. If you do this, you must ensure you set the same value of `XDG_DATA_HOME` when loading drivers with the [driver manager](../concepts/driver_manager.md) for the drivers to find your license.
 
 ## Logging Out
 

From a48621946053d1d94d1ce9f6c0971e68a599dc2f Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 19:29:04 -0800
Subject: [PATCH 24/34] Add note about purge

---
 docs/guides/private_drivers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index 30686b4b..73b05df5 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -70,7 +70,7 @@ By default, the `logout` command doesn't purge any driver licenses from your sys
 $ dbc auth logout --purge
 ```
 
-Note that this command only removes the local copy of your license and does not cancel your trial.
+Note that this command only removes the local copy of your license and does not cancel any active licenses you may have in your [Columnar Cloud](https://cloud.columnar.tech) account. After running `dbc auth logout --purge`, the next time you run `dbc auth login`, your license will be automatically downloaded again.
 
 ## API Keys
 

From 6a829086223802e970209035b895bd190241a887 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 19:29:09 -0800
Subject: [PATCH 25/34] Add API keys section

---
 docs/guides/private_drivers.md | 23 ++++++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index 73b05df5..0f48a315 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -74,4 +74,25 @@ Note that this command only removes the local copy of your license and does not
 
 ## API Keys
 
-TODO
+dbc also supports logging in to private driver registries via API key. This is primarily intended for use [Continuous Integration](https://en.wikipedia.org/wiki/Continuous_integration) systems or any system where logging in with a web browser is not possible.
+
+To create an API key, open a web browser to your [API keys](https://cloud.columnar.tech/apikeys) page.
+
+!!! note inline end
+
+    If you've already created an API key, you will see a **Create API Key** button instead.
+
+If you haven't created any API keys before, you will see a **Create Your First API Key** button. After clicking that, enter a name, optionally choose an expiration, and click **Create**. On the following screen, you will see your new API key and instructions to copy it to your clipboard.
+
+!!! note
+
+    API keys grant full access to your account so be sure to store it in a secure way.
+
+
+Then to use your API to log in, run:
+
+```console
+$ dbc auth login --api-key "<YOUR_API_KEY_HERE>"
+```
+
+Once you've run this successfully, dbc is now logged in and you can install private drivers as you would normally.

From 93f1845a94a098459f70ebdd6cba68614e6f2d7e Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 19:29:46 -0800
Subject: [PATCH 26/34] Update docs/guides/private_drivers.md

Co-authored-by: Matt Topol <zotthewizard@gmail.com>
---
 docs/guides/private_drivers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index 0f48a315..0a7660b1 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -25,7 +25,7 @@ To install and use these drivers, you must:
 1. Log in to [Columnar Cloud](https://cloud.columnar.tech) with dbc
 2. Start a trial license
 
-Continue reading to learn how to log in start a trial.
+Continue reading to learn how to log in and start a trial.
 
 ## Logging In
 

From 59448ea44db890d8e36e939a65a36089051e532d Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 19:32:14 -0800
Subject: [PATCH 27/34] proforead

---
 docs/guides/private_drivers.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index 0a7660b1..d343e5c8 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -74,7 +74,7 @@ Note that this command only removes the local copy of your license and does not
 
 ## API Keys
 
-dbc also supports logging in to private driver registries via API key. This is primarily intended for use [Continuous Integration](https://en.wikipedia.org/wiki/Continuous_integration) systems or any system where logging in with a web browser is not possible.
+dbc also supports logging in to private driver registries via API key. This is primarily intended for use in [Continuous Integration](https://en.wikipedia.org/wiki/Continuous_integration) systems or any system where logging in with a web browser is not possible.
 
 To create an API key, open a web browser to your [API keys](https://cloud.columnar.tech/apikeys) page.
 
@@ -82,14 +82,14 @@ To create an API key, open a web browser to your [API keys](https://cloud.column
 
     If you've already created an API key, you will see a **Create API Key** button instead.
 
-If you haven't created any API keys before, you will see a **Create Your First API Key** button. After clicking that, enter a name, optionally choose an expiration, and click **Create**. On the following screen, you will see your new API key and instructions to copy it to your clipboard.
+If you haven't created any API keys before, you will see a **Create Your First API Key** button. After clicking it, enter a name, optionally choose an expiration, and click **Create**. On the following screen, you will see your new API key and instructions to copy it to your clipboard.
 
 !!! note
 
     API keys grant full access to your account so be sure to store it in a secure way.
 
 
-Then to use your API to log in, run:
+Then to use your API key to log in, run:
 
 ```console
 $ dbc auth login --api-key "<YOUR_API_KEY_HERE>"

From 0440ac792efc5ffcd8a0739605bc15fea1d276da Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 19:34:27 -0800
Subject: [PATCH 28/34] Update cli.md

---
 docs/reference/cli.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index 4c6aef84..082d1f15 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -341,7 +341,7 @@ $ dbc auth logout
 
 `REGISTRYURL`
 
-:   Optional. URL of the driver registry to log out from
+:   Optional. URL of the driver registry to log out from. Defaults to [https://dbc-cdn-private.columnar.tech/](https://dbc-cdn-private.columnar.tech/).
 
 <h3>Options</h3>
 

From 57f12af5b39987b0767d5383f5bf0fc2cc955bf4 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Thu, 22 Jan 2026 19:37:24 -0800
Subject: [PATCH 29/34] add note about account

---
 docs/guides/private_drivers.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index d343e5c8..d72ca240 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -29,7 +29,9 @@ Continue reading to learn how to log in and start a trial.
 
 ## Logging In
 
-To log into Columnar's private driver registry, run `dbc auth login`. You will see the following in your terminal and your default web browser will be opened:
+To log into Columnar's private driver registry, run `dbc auth login`. This will automatically create an account for you the first time you log in.
+
+You will see the following in your terminal and your default web browser will be opened:
 
 ```console
 $ dbc auth login

From 7d527b498545fb728ff1f40daf21a99137aa76e1 Mon Sep 17 00:00:00 2001
From: Ian Cook <ianmcook@gmail.com>
Date: Fri, 23 Jan 2026 00:50:50 -0500
Subject: [PATCH 30/34] Fix broken link

---
 docs/guides/private_drivers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index d72ca240..274ce8d5 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -18,7 +18,7 @@ limitations under the License.
 
 {{ since_version('v0.2.0') }}
 
-Most drivers available with dbc are hosted on Columnar's public [driver registry](../reference/driver_registry.md). However, some of the drivers you see when you run `dbc search` may be marked with a `[private]` label.
+Most drivers available with dbc are hosted on Columnar's public [driver registry](../concepts/driver_registry.md). However, some of the drivers you see when you run `dbc search` may be marked with a `[private]` label.
 
 To install and use these drivers, you must:
 

From df1a6da3891d6d3f6f48517adeeae79ef58608c8 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Fri, 23 Jan 2026 12:42:16 -0800
Subject: [PATCH 31/34] Add warning about purge

---
 docs/guides/private_drivers.md | 9 ++++++++-
 docs/reference/cli.md          | 4 ++++
 2 files changed, 12 insertions(+), 1 deletion(-)

diff --git a/docs/guides/private_drivers.md b/docs/guides/private_drivers.md
index 274ce8d5..9e27f7c2 100644
--- a/docs/guides/private_drivers.md
+++ b/docs/guides/private_drivers.md
@@ -72,7 +72,14 @@ By default, the `logout` command doesn't purge any driver licenses from your sys
 $ dbc auth logout --purge
 ```
 
-Note that this command only removes the local copy of your license and does not cancel any active licenses you may have in your [Columnar Cloud](https://cloud.columnar.tech) account. After running `dbc auth logout --purge`, the next time you run `dbc auth login`, your license will be automatically downloaded again.
+!!! note
+
+    Note that this command only removes the local copy of your license and does not cancel any active licenses you may have in your [Columnar Cloud](https://cloud.columnar.tech) account.
+
+!!! warning
+
+    ADBC drivers that require a license (i.e., private drivers) will stop working after you run this command. You can re-download your license with `dbc auth login`. See [Downloading Your License](#downloading-your-license).
+
 
 ## API Keys
 
diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index 082d1f15..f780fef7 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -348,3 +348,7 @@ $ dbc auth logout
 `--purge`
 
 :   Remove all local auth credentials for dbc
+
+    !!! warning
+
+        ADBC drivers that require a license (i.e., private drivers) will stop working after you run this command. You can re-download your license with `dbc auth login`. See [Downloading Your License](../guides/private_drivers.md#downloading-your-license).

From f0b1c2a4429b0b1403a2c1cb7abfb763535ab041 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Fri, 23 Jan 2026 12:43:31 -0800
Subject: [PATCH 32/34] Update docs/reference/cli.md

Co-authored-by: Ian Cook <ianmcook@gmail.com>
---
 docs/reference/cli.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/reference/cli.md b/docs/reference/cli.md
index f780fef7..c99cd9cd 100644
--- a/docs/reference/cli.md
+++ b/docs/reference/cli.md
@@ -310,7 +310,6 @@ $ dbc docs <DRIVER>
 <h3>Usage</h3>
 
 ```console
-$ dbc auth
 $ dbc auth login
 $ dbc auth logout
 ```

From 7a7d7af81aac926729ded374ab23a083ffbb6a5f Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Fri, 23 Jan 2026 12:55:25 -0800
Subject: [PATCH 33/34] Don't highlight shell built-ins

---
 docs/stylesheets/extra.css | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
index b1577b57..323d84cb 100644
--- a/docs/stylesheets/extra.css
+++ b/docs/stylesheets/extra.css
@@ -24,6 +24,13 @@
   text-decoration: underline;
 }
 
+/* Disable highlighting for shell built-ins. This means words in console blocks
+like echo, export, logout, and source will use the same color as other commands
+and won't show up highlighted as purple. */
+.highlight .nb {
+  color: inherit;
+}
+
 /* Hide the site name in the header... */
 .md-header__title .md-header__topic:first-of-type {
   display: none !important;

From 9c6797e44467bff36e7a27bcc1be814a95471708 Mon Sep 17 00:00:00 2001
From: Bryce Mecum <petridish@gmail.com>
Date: Tue, 10 Feb 2026 07:53:38 -0800
Subject: [PATCH 34/34] Update pixi.lock

---
 pixi.lock | 53 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)

diff --git a/pixi.lock b/pixi.lock
index fceecac4..8a988778 100644
--- a/pixi.lock
+++ b/pixi.lock
@@ -182,6 +182,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/0f/e7/aa315e6a749d9b96c2504a1ba0ba031ba2d0517e972ce22682e3fccecb09/cssselect2-0.8.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/07/6c/aa3f2f849e01cb6a001cd8554a88d4c77c5c1a31c95bdf1cf9301e6d9ef4/defusedxml-0.7.1-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/f7/ec/67fbef5d497f86283db54c22eec6f6140243aae73265799baaaa19cd17fb/ghp_import-2.1.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/1f/7f/13cd798d180af4bf4c0ceddeefba2b864a63c71645abc0308b768d67bb81/hjson-3.1.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/62/a1/3d680cbfd5f4b8f15abc1d571870c5fc3e594bb582bc3b64ea099db13e56/jinja2-3.1.6-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/70/81/54e3ce63502cd085a0c556652a4e1b919c45a446bd1e5300e10c44c8c521/markdown-3.10-py3-none-any.whl
@@ -195,6 +196,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/22/5b/dbc6a8cddc9cfa9c4971d59fb12bb8d42e161b7e7f8cc89e49137c5b279c/mkdocs-1.6.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/9f/d4/029f984e8d3f3b6b726bd33cafc473b75e9e44c0f7e80a5b29abc466bdea/mkdocs_get_deps-0.2.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ad/2b/82928cc9e8d9269cd79e7ebf015efdc4945e6c646e86ec1d4dba1707f215/mkdocs_llmstxt-0.5.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/51/62/9fffba5bb9ed3d31a932ad35038ba9483d59850256ee0fea7f1187173983/mkdocs_macros_plugin-1.5.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/04/87/eefe8d5e764f4cf50ed91b943f8e8f96b5efd65489d8303b7a36e2e79834/mkdocs_material-9.7.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5b/54/662a4743aa81d9582ee9339d4ffa3c8fd40a4965e033d77b9da9774d3960/mkdocs_material_extensions-1.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/20/12/38679034af332785aac8774540895e234f4d07f7545804097de4b666afd8/packaging-25.0-py3-none-any.whl
@@ -211,6 +213,8 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/46/2c/1462b1d0a634697ae9e55b3cecdcb64788e8b7d63f54d923fcd0bb140aed/soupsieve-2.8.3-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/17/43/47c7cf84b3bd74a8631b02d47db356656bb8dff6f2e61a4c749963814d0d/super_collections-0.6.2-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/33/d1/8bb87d21e9aeb323cc03034f5eaf2c8f69841e40e4853c2627edf8111ed3/termcolor-3.3.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/e6/34/ebdc18bae6aa14fbee1a08b63c015c72b64868ff7dae68808ab500c492e2/tinycss2-1.4.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a7/c2/fe1e52489ae3122415c51f387e221dd0773709bad6c6cdaa599e8a2c5185/urllib3-2.5.0-py3-none-any.whl
@@ -266,6 +270,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/0f/e7/aa315e6a749d9b96c2504a1ba0ba031ba2d0517e972ce22682e3fccecb09/cssselect2-0.8.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/07/6c/aa3f2f849e01cb6a001cd8554a88d4c77c5c1a31c95bdf1cf9301e6d9ef4/defusedxml-0.7.1-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/f7/ec/67fbef5d497f86283db54c22eec6f6140243aae73265799baaaa19cd17fb/ghp_import-2.1.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/1f/7f/13cd798d180af4bf4c0ceddeefba2b864a63c71645abc0308b768d67bb81/hjson-3.1.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/62/a1/3d680cbfd5f4b8f15abc1d571870c5fc3e594bb582bc3b64ea099db13e56/jinja2-3.1.6-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/70/81/54e3ce63502cd085a0c556652a4e1b919c45a446bd1e5300e10c44c8c521/markdown-3.10-py3-none-any.whl
@@ -279,6 +284,7 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/22/5b/dbc6a8cddc9cfa9c4971d59fb12bb8d42e161b7e7f8cc89e49137c5b279c/mkdocs-1.6.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/9f/d4/029f984e8d3f3b6b726bd33cafc473b75e9e44c0f7e80a5b29abc466bdea/mkdocs_get_deps-0.2.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/ad/2b/82928cc9e8d9269cd79e7ebf015efdc4945e6c646e86ec1d4dba1707f215/mkdocs_llmstxt-0.5.0-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/51/62/9fffba5bb9ed3d31a932ad35038ba9483d59850256ee0fea7f1187173983/mkdocs_macros_plugin-1.5.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/04/87/eefe8d5e764f4cf50ed91b943f8e8f96b5efd65489d8303b7a36e2e79834/mkdocs_material-9.7.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/5b/54/662a4743aa81d9582ee9339d4ffa3c8fd40a4965e033d77b9da9774d3960/mkdocs_material_extensions-1.3.1-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/20/12/38679034af332785aac8774540895e234f4d07f7545804097de4b666afd8/packaging-25.0-py3-none-any.whl
@@ -295,6 +301,8 @@ environments:
       - pypi: https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/46/2c/1462b1d0a634697ae9e55b3cecdcb64788e8b7d63f54d923fcd0bb140aed/soupsieve-2.8.3-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/17/43/47c7cf84b3bd74a8631b02d47db356656bb8dff6f2e61a4c749963814d0d/super_collections-0.6.2-py3-none-any.whl
+      - pypi: https://files.pythonhosted.org/packages/33/d1/8bb87d21e9aeb323cc03034f5eaf2c8f69841e40e4853c2627edf8111ed3/termcolor-3.3.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/e6/34/ebdc18bae6aa14fbee1a08b63c015c72b64868ff7dae68808ab500c492e2/tinycss2-1.4.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl
       - pypi: https://files.pythonhosted.org/packages/a7/c2/fe1e52489ae3122415c51f387e221dd0773709bad6c6cdaa599e8a2c5185/urllib3-2.5.0-py3-none-any.whl
@@ -645,6 +653,10 @@ packages:
   - markdown ; extra == 'dev'
   - flake8 ; extra == 'dev'
   - wheel ; extra == 'dev'
+- pypi: https://files.pythonhosted.org/packages/1f/7f/13cd798d180af4bf4c0ceddeefba2b864a63c71645abc0308b768d67bb81/hjson-3.1.0-py3-none-any.whl
+  name: hjson
+  version: 3.1.0
+  sha256: 65713cdcf13214fb554eb8b4ef803419733f4f5e551047c9b711098ab7186b89
 - conda: https://conda.anaconda.org/conda-forge/linux-64/icu-75.1-he02047a_0.conda
   sha256: 71e750d509f5fa3421087ba88ef9a7b9be11c53174af3aa4d06aff4c18b38e8e
   md5: 8b189310083baabfb622af68fd9d3ae3
@@ -1203,6 +1215,29 @@ packages:
   - mdformat>=0.7.21
   - mdformat-tables>=1.0
   requires_python: '>=3.10'
+- pypi: https://files.pythonhosted.org/packages/51/62/9fffba5bb9ed3d31a932ad35038ba9483d59850256ee0fea7f1187173983/mkdocs_macros_plugin-1.5.0-py3-none-any.whl
+  name: mkdocs-macros-plugin
+  version: 1.5.0
+  sha256: c10fabd812bf50f9170609d0ed518e54f1f0e12c334ac29141723a83c881dd6f
+  requires_dist:
+  - hjson
+  - jinja2
+  - mkdocs>=0.17
+  - packaging
+  - pathspec
+  - python-dateutil
+  - pyyaml
+  - requests
+  - super-collections>=0.6.2
+  - termcolor
+  - pytest ; extra == 'test'
+  - mkdocs-include-markdown-plugin ; extra == 'test'
+  - mkdocs-macros-test ; extra == 'test'
+  - mkdocs-material>=6.2 ; extra == 'test'
+  - mkdocs-test>=0.6.0 ; extra == 'test'
+  - mkdocs-d2-plugin ; extra == 'test'
+  - mkdocs-mermaid2-plugin ; extra == 'doc'
+  requires_python: '>=3.8'
 - pypi: https://files.pythonhosted.org/packages/04/87/eefe8d5e764f4cf50ed91b943f8e8f96b5efd65489d8303b7a36e2e79834/mkdocs_material-9.7.0-py3-none-any.whl
   name: mkdocs-material
   version: 9.7.0
@@ -1674,6 +1709,24 @@ packages:
   version: 2.8.3
   sha256: ed64f2ba4eebeab06cc4962affce381647455978ffc1e36bb79a545b91f45a95
   requires_python: '>=3.9'
+- pypi: https://files.pythonhosted.org/packages/17/43/47c7cf84b3bd74a8631b02d47db356656bb8dff6f2e61a4c749963814d0d/super_collections-0.6.2-py3-none-any.whl
+  name: super-collections
+  version: 0.6.2
+  sha256: 291b74d26299e9051d69ad9d89e61b07b6646f86a57a2f5ab3063d206eee9c56
+  requires_dist:
+  - hjson
+  - pytest>=7.0 ; extra == 'test'
+  - rich ; extra == 'test'
+  - pyyaml ; extra == 'test'
+  requires_python: '>=3.8'
+- pypi: https://files.pythonhosted.org/packages/33/d1/8bb87d21e9aeb323cc03034f5eaf2c8f69841e40e4853c2627edf8111ed3/termcolor-3.3.0-py3-none-any.whl
+  name: termcolor
+  version: 3.3.0
+  sha256: cf642efadaf0a8ebbbf4bc7a31cec2f9b5f21a9f726f4ccbb08192c9c26f43a5
+  requires_dist:
+  - pytest ; extra == 'tests'
+  - pytest-cov ; extra == 'tests'
+  requires_python: '>=3.10'
 - pypi: https://files.pythonhosted.org/packages/e6/34/ebdc18bae6aa14fbee1a08b63c015c72b64868ff7dae68808ab500c492e2/tinycss2-1.4.0-py3-none-any.whl
   name: tinycss2
   version: 1.4.0