From b5565e19058a06e3c185d4e58aef510ab9b3b27d Mon Sep 17 00:00:00 2001
From: Daniel Peng <97350516+original4422@users.noreply.github.com>
Date: Tue, 13 Oct 2026 05:48:13 +0800
Subject: [PATCH] docs: fix SDK docs working directory instructions (#4525)

---
 docs/README.md | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/docs/README.md b/docs/README.md
index bce1ec668..c5a99943d 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -15,18 +15,21 @@ unreleased features.
 
 ### Preview the docs
 
+Run these commands from the LanceDB repository root. The subshell changes into
+`docs` to load `mkdocs.yml`, while leaving your shell in the repository root.
+
 ```shell
-cd docs
-mkdocs serve
+(cd docs && PYTHONPATH=. mkdocs serve)
 ```
 
 If you want to just generate the HTML files:
 
 ```shell
-PYTHONPATH=. mkdocs build -f docs/mkdocs.yml
+(cd docs && PYTHONPATH=. mkdocs build)
 ```
 
-If successful, you should see a `docs/site` directory that you can verify locally.
+If successful, you should see a `docs/site` directory in the repository root that
+you can verify locally.
 
 ## Adding examples