update python api ref (#1251)

preview:
https://langsmith-sdk.readthedocs.io/en/bagatur-update_py_api_ref/

build locally with
```bash
make api_docs_build
```

clean up with 
```bash
make api_docs_clean
```

.readthedocs.yml

@@ -20,6 +20,7 @@ build:
     - . .venv/bin/activate
     - uv pip install -r python/docs/requirements.txt
     - . .venv/bin/activate && cd python/docs && make clobber generate-api-rst html && cd ../..
+    - cp python/docs/_build/html/reference.html python/docs/_build/html/index.html
     - cp -r python/docs/_build/html $READTHEDOCS_OUTPUT
 # Build documentation in the docs/ directory with Sphinx
 sphinx:

python/Makefile

@@ -62,3 +62,13 @@ build:
 
 publish:
 	poetry publish --dry-run
+
+api_docs_build:
+	poetry run python docs/create_api_rst.py
+	cd docs && poetry run make html
+	poetry run python docs/scripts/custom_formatter.py docs/_build/html/
+	cp docs/_build/html/{reference,index}.html
+	open docs/_build/html/index.html
+
+api_docs_clean:
+	git clean -fd ./docs/