diff --git a/AGENTS.md b/AGENTS.md
index 8da3d3dff..119ef75b2 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -1,7 +1,7 @@
 # Braintrust SDK Agent Guide
 
 This guide is for development of the Braintrust Python SDK in this repository.
-If you need to learn more about Braintrust itself, see the Braintrust docs: https://www.braintrust.dev/docs
+If you need to learn more about Braintrust itself, see the Braintrust docs: https://docs.braintrust.dev
 
 Use this file as the default playbook for work in this repository.
 
diff --git a/README.md b/README.md
index 835f21a3e..e0a9cc737 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 # Braintrust Python SDKs
 
-[Braintrust](https://www.braintrust.dev/) is a platform for evaluating and shipping AI products. Learn more at [braintrust.dev](https://www.braintrust.dev/) and in the [docs](https://www.braintrust.dev/docs).
+[Braintrust](https://www.braintrust.dev/) is a platform for evaluating and shipping AI products. Learn more at [braintrust.dev](https://www.braintrust.dev/) and in the [docs](https://docs.braintrust.dev).
 
 This repository contains Braintrust's Python SDKs and integrations, including:
 
@@ -89,8 +89,8 @@ BRAINTRUST_API_KEY=<YOUR_API_KEY> braintrust eval tutorial_eval.py
 
 ## Documentation
 
-- Python SDK docs: https://www.braintrust.dev/docs/reference/sdks/python
-- Release notes: https://www.braintrust.dev/docs/reference/release-notes
+- Python SDK docs: https://docs.braintrust.dev/sdks/python/versions/latest
+- Release notes: https://docs.braintrust.dev/changelog
 
 ## License
 
diff --git a/integrations/adk-py/README.md b/integrations/adk-py/README.md
index 00eb82a36..598870125 100644
--- a/integrations/adk-py/README.md
+++ b/integrations/adk-py/README.md
@@ -162,6 +162,6 @@ If your shell is not configured with `mise activate`, prefix commands with `mise
 
 ## Documentation
 
-- [Braintrust Documentation](https://www.braintrust.dev/docs)
-- [Braintrust Python SDK Documentation](https://www.braintrust.dev/docs/reference/sdks/python)
+- [Braintrust Documentation](https://docs.braintrust.dev)
+- [Braintrust Python SDK Documentation](https://docs.braintrust.dev/sdks/python/versions/latest)
 - [Google ADK Documentation](https://github.com/google/genai-agent-dev-kit)
diff --git a/integrations/langchain-py/README.md b/integrations/langchain-py/README.md
index 4772c9794..bedeec189 100644
--- a/integrations/langchain-py/README.md
+++ b/integrations/langchain-py/README.md
@@ -114,6 +114,6 @@ Review the [LangChain documentation](https://python.langchain.com/docs/modules/c
 
 ## Documentation
 
-- Braintrust docs: https://www.braintrust.dev/docs
-- Braintrust Python SDK docs: https://www.braintrust.dev/docs/reference/sdks/python
+- Braintrust docs: https://docs.braintrust.dev
+- Braintrust Python SDK docs: https://docs.braintrust.dev/sdks/python/versions/latest
 - LangChain callback docs: https://python.langchain.com/docs/modules/callbacks/
diff --git a/py/README.md b/py/README.md
index b0b3242dc..cc8eddc6c 100644
--- a/py/README.md
+++ b/py/README.md
@@ -64,8 +64,8 @@ Available extras:
 
 ## Documentation
 
-- Python SDK docs: https://www.braintrust.dev/docs/reference/sdks/python
-- Braintrust docs: https://www.braintrust.dev/docs
+- Python SDK docs: https://docs.braintrust.dev/sdks/python/versions/latest
+- Braintrust docs: https://docs.braintrust.dev
 - Repo publishing guide: https://github.com/braintrustdata/braintrust-sdk-python/blob/main/docs/publishing.md
 - Source code: https://github.com/braintrustdata/braintrust-sdk-python/tree/main/py
 
diff --git a/py/src/braintrust/cli/install/api.py b/py/src/braintrust/cli/install/api.py
index 6c95774a5..cb54523ef 100644
--- a/py/src/braintrust/cli/install/api.py
+++ b/py/src/braintrust/cli/install/api.py
@@ -327,7 +327,7 @@ def main(args):
             textwrap.dedent(
                 f"""\
             Stack with name {args.name} does not exist. Either create it manually by following
-            https://www.braintrust.dev/docs/admin/self-hosting/aws or use the --create flag."""
+            https://docs.braintrust.dev/admin/self-hosting/deploy or use the --create flag."""
             )
         )
         exit(1)
diff --git a/py/src/braintrust/wrappers/pytest_plugin/README.md b/py/src/braintrust/wrappers/pytest_plugin/README.md
index 3a09b485a..28555e7e0 100644
--- a/py/src/braintrust/wrappers/pytest_plugin/README.md
+++ b/py/src/braintrust/wrappers/pytest_plugin/README.md
@@ -59,7 +59,7 @@ pytest --braintrust --braintrust-project="my-project"
 
 ## Logging Data
 
-The `braintrust_span` fixture is a standard [`Span`](https://www.braintrust.dev/docs/reference/python#span) object. Use `span.log()` to record data:
+The `braintrust_span` fixture is a standard [`Span`](https://docs.braintrust.dev/sdks/python/versions/latest#span) object. Use `span.log()` to record data:
 
 ```python
 def test_example(braintrust_span):