Bump version: 0.22.4-beta.1 → 0.22.4-beta.2

2026-01-05 19:32:56 +00:00 · 2025-11-19 20:25:21 +00:00
30 changed files with 153 additions and 309 deletions
--- a/.github/ISSUE_TEMPLATE/documentation.yml
+++ b/.github/ISSUE_TEMPLATE/documentation.yml
@@ -18,6 +18,6 @@ body:
      label: Link
      description: >
        Provide a link to the existing documentation, if applicable.
-      placeholder: ex. https://lancedb.com/docs/tables/...
+      placeholder: ex. https://lancedb.github.io/lancedb/guides/tables/...
    validations:
      required: false
--- a/Cargo.lock
+++ b/Cargo.lock
@@ -3032,8 +3032,8 @@ checksum = "42703706b716c37f96a77aea830392ad231f44c9e9a67872fa5548707e11b11c"

 [[package]]
 name = "fsst"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow-array",
 "rand 0.9.2",
@@ -4217,8 +4217,8 @@ dependencies = [

 [[package]]
 name = "lance"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow",
 "arrow-arith",
@@ -4282,8 +4282,8 @@ dependencies = [

 [[package]]
 name = "lance-arrow"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow-array",
 "arrow-buffer",
@@ -4301,8 +4301,8 @@ dependencies = [

 [[package]]
 name = "lance-bitpacking"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrayref",
 "paste",
@@ -4311,8 +4311,8 @@ dependencies = [

 [[package]]
 name = "lance-core"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow-array",
 "arrow-buffer",
@@ -4348,8 +4348,8 @@ dependencies = [

 [[package]]
 name = "lance-datafusion"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow",
 "arrow-array",
@@ -4378,8 +4378,8 @@ dependencies = [

 [[package]]
 name = "lance-datagen"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow",
 "arrow-array",
@@ -4396,8 +4396,8 @@ dependencies = [

 [[package]]
 name = "lance-encoding"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow-arith",
 "arrow-array",
@@ -4434,8 +4434,8 @@ dependencies = [

 [[package]]
 name = "lance-file"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow-arith",
 "arrow-array",
@@ -4467,8 +4467,8 @@ dependencies = [

 [[package]]
 name = "lance-index"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow",
 "arrow-arith",
@@ -4529,8 +4529,8 @@ dependencies = [

 [[package]]
 name = "lance-io"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow",
 "arrow-arith",
@@ -4570,8 +4570,8 @@ dependencies = [

 [[package]]
 name = "lance-linalg"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow-array",
 "arrow-buffer",
@@ -4587,8 +4587,8 @@ dependencies = [

 [[package]]
 name = "lance-namespace"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow",
 "async-trait",
@@ -4600,8 +4600,8 @@ dependencies = [

 [[package]]
 name = "lance-namespace-impls"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow",
 "arrow-ipc",
@@ -4639,8 +4639,8 @@ dependencies = [

 [[package]]
 name = "lance-table"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow",
 "arrow-array",
@@ -4679,8 +4679,8 @@ dependencies = [

 [[package]]
 name = "lance-testing"
-version = "1.0.0-beta.6"
-source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.6#706189e92a5e8e2299bf0b9170c5d7dc5ea63189"
+version = "1.0.0-beta.3"
+source = "git+https://github.com/lance-format/lance.git?tag=v1.0.0-beta.3#95ff7f6e684c1911fc00c9c2811cce1a61c06ff5"
 dependencies = [
 "arrow-array",
 "arrow-schema",
@@ -4691,7 +4691,7 @@ dependencies = [

 [[package]]
 name = "lancedb"
-version = "0.22.4-beta.2"
+version = "0.22.4-beta.1"
 dependencies = [
 "ahash",
 "anyhow",
@@ -4786,7 +4786,7 @@ dependencies = [

 [[package]]
 name = "lancedb-nodejs"
-version = "0.22.4-beta.2"
+version = "0.22.4-beta.1"
 dependencies = [
 "arrow-array",
 "arrow-ipc",
@@ -4806,7 +4806,7 @@ dependencies = [

 [[package]]
 name = "lancedb-python"
-version = "0.25.4-beta.2"
+version = "0.25.4-beta.1"
 dependencies = [
 "arrow",
 "async-trait",
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -15,20 +15,20 @@ categories = ["database-implementations"]
 rust-version = "1.78.0"

 [workspace.dependencies]
-lance = { "version" = "=1.0.0-beta.6", default-features = false, "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-core = { "version" = "=1.0.0-beta.6", "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-datagen = { "version" = "=1.0.0-beta.6", "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-file = { "version" = "=1.0.0-beta.6", "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-io = { "version" = "=1.0.0-beta.6", default-features = false, "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-index = { "version" = "=1.0.0-beta.6", "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-linalg = { "version" = "=1.0.0-beta.6", "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-namespace = { "version" = "=1.0.0-beta.6", "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-namespace-impls = { "version" = "=1.0.0-beta.6", "features" = ["dir-aws", "dir-gcp", "dir-azure", "dir-oss", "rest"], "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-table = { "version" = "=1.0.0-beta.6", "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-testing = { "version" = "=1.0.0-beta.6", "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-datafusion = { "version" = "=1.0.0-beta.6", "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-encoding = { "version" = "=1.0.0-beta.6", "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
-lance-arrow = { "version" = "=1.0.0-beta.6", "tag" = "v1.0.0-beta.6", "git" = "https://github.com/lance-format/lance.git" }
+lance = { "version" = "=1.0.0-beta.3", default-features = false, "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-core = { "version" = "=1.0.0-beta.3", "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-datagen = { "version" = "=1.0.0-beta.3", "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-file = { "version" = "=1.0.0-beta.3", "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-io = { "version" = "=1.0.0-beta.3", default-features = false, "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-index = { "version" = "=1.0.0-beta.3", "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-linalg = { "version" = "=1.0.0-beta.3", "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-namespace = { "version" = "=1.0.0-beta.3", "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-namespace-impls = { "version" = "=1.0.0-beta.3", "features" = ["dir-aws", "dir-gcp", "dir-azure", "dir-oss", "rest"], "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-table = { "version" = "=1.0.0-beta.3", "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-testing = { "version" = "=1.0.0-beta.3", "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-datafusion = { "version" = "=1.0.0-beta.3", "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-encoding = { "version" = "=1.0.0-beta.3", "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
+lance-arrow = { "version" = "=1.0.0-beta.3", "tag" = "v1.0.0-beta.3", "git" = "https://github.com/lance-format/lance.git" }
 ahash = "0.8"
 # Note that this one does not include pyarrow
 arrow = { version = "56.2", optional = false }
--- a/README.md
+++ b/README.md
@@ -15,7 +15,7 @@

 # **The Multimodal AI Lakehouse**

-[**How to Install** ](#how-to-install) ✦ [**Detailed Documentation**](https://lancedb.com/docs) ✦ [**Tutorials and Recipes**](https://github.com/lancedb/vectordb-recipes/tree/main) ✦  [**Contributors**](#contributors) 
+[**How to Install** ](#how-to-install) ✦ [**Detailed Documentation**](https://lancedb.github.io/lancedb/) ✦ [**Tutorials and Recipes**](https://github.com/lancedb/vectordb-recipes/tree/main) ✦  [**Contributors**](#contributors) 

 **The ultimate multimodal data platform for AI/ML applications.** 

--- a/docs/README.md
+++ b/docs/README.md
@@ -1,8 +1,8 @@
 # LanceDB Documentation

-LanceDB docs are available at [lancedb.com/docs](https://lancedb.com/docs).
+LanceDB docs are deployed to https://lancedb.github.io/lancedb/.

-The SDK docs are built and deployed automatically by [Github Actions](../.github/workflows/docs.yml)
+Docs is built and deployed automatically by [Github Actions](../.github/workflows/docs.yml)
 whenever a commit is pushed to the `main` branch. So it is possible for the docs to show
 unreleased features.

--- a/docs/src/js/README.md
+++ b/docs/src/js/README.md
@@ -34,7 +34,7 @@ const results = await table.vectorSearch([0.1, 0.3]).limit(20).toArray();
 console.log(results);
 ```

-The [quickstart](https://lancedb.com/docs/quickstart/basic-usage/) contains a more complete example.
+The [quickstart](https://lancedb.github.io/lancedb/basic/) contains a more complete example.

 ## Development

--- a/docs/src/js/interfaces/ConnectionOptions.md
+++ b/docs/src/js/interfaces/ConnectionOptions.md
@@ -89,4 +89,4 @@ optional storageOptions: Record<string, string>;

 (For LanceDB OSS only): configuration for object storage.

-The available options are described at https://lancedb.com/docs/storage/
+The available options are described at https://lancedb.github.io/lancedb/guides/storage/
--- a/docs/src/js/interfaces/CreateTableOptions.md
+++ b/docs/src/js/interfaces/CreateTableOptions.md
@@ -97,4 +97,4 @@ Configuration for object storage.
 Options already set on the connection will be inherited by the table,
 but can be overridden here.

-The available options are described at https://lancedb.com/docs/storage/
+The available options are described at https://lancedb.github.io/lancedb/guides/storage/
--- a/docs/src/js/interfaces/OpenTableOptions.md
+++ b/docs/src/js/interfaces/OpenTableOptions.md
@@ -42,4 +42,4 @@ Configuration for object storage.
 Options already set on the connection will be inherited by the table,
 but can be overridden here.

-The available options are described at https://lancedb.com/docs/storage/
+The available options are described at https://lancedb.github.io/lancedb/guides/storage/
--- a/docs/src/python/python.md
+++ b/docs/src/python/python.md
@@ -30,12 +30,6 @@ is also an [asynchronous API client](#connections-asynchronous).

 ::: lancedb.table.Table

-::: lancedb.table.FragmentStatistics
-
-::: lancedb.table.FragmentSummaryStats
-
-::: lancedb.table.Tags
-
 ## Querying (Synchronous)

 ::: lancedb.query.Query
@@ -64,14 +58,6 @@ is also an [asynchronous API client](#connections-asynchronous).

 ::: lancedb.embeddings.open_clip.OpenClipEmbeddings

-## Remote configuration
-
-::: lancedb.remote.ClientConfig
-
-::: lancedb.remote.TimeoutConfig
-
-::: lancedb.remote.RetryConfig
-
 ## Context

 ::: lancedb.context.contextualize
@@ -129,8 +115,6 @@ Table hold your actual data as a collection of records / rows.

 ::: lancedb.table.AsyncTable

-::: lancedb.table.AsyncTags
-
 ## Indices (Asynchronous)

 Indices can be created on a table to speed up queries. This section
@@ -152,8 +136,6 @@ lists the indices that LanceDb supports.

 ::: lancedb.index.IvfFlat

-::: lancedb.table.IndexStatistics
-
 ## Querying (Asynchronous)

 Queries allow you to return data from your database. Basic queries can be
--- a/nodejs/README.md
+++ b/nodejs/README.md
@@ -30,7 +30,7 @@ const results = await table.vectorSearch([0.1, 0.3]).limit(20).toArray();
 console.log(results);
 ```

-The [quickstart](https://lancedb.com/docs/quickstart/basic-usage/) contains more complete examples.
+The [quickstart](https://lancedb.github.io/lancedb/basic/) contains a more complete example.

 ## Development

--- a/nodejs/lancedb/connection.ts
+++ b/nodejs/lancedb/connection.ts
@@ -42,7 +42,7 @@ export interface CreateTableOptions {
   * Options already set on the connection will be inherited by the table,
   * but can be overridden here.
   *
-   * The available options are described at https://lancedb.com/docs/storage/
+   * The available options are described at https://lancedb.github.io/lancedb/guides/storage/
   */
  storageOptions?: Record<string, string>;

@@ -78,7 +78,7 @@ export interface OpenTableOptions {
   * Options already set on the connection will be inherited by the table,
   * but can be overridden here.
   *
-   * The available options are described at https://lancedb.com/docs/storage/
+   * The available options are described at https://lancedb.github.io/lancedb/guides/storage/
   */
  storageOptions?: Record<string, string>;
  /**
--- a/nodejs/package-lock.json
+++ b/nodejs/package-lock.json
@@ -1,12 +1,12 @@
 {
  "name": "@lancedb/lancedb",
-  "version": "0.22.4-beta.2",
+  "version": "0.22.4-beta.1",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "@lancedb/lancedb",
-      "version": "0.22.4-beta.2",
+      "version": "0.22.4-beta.1",
      "cpu": [
        "x64",
        "arm64"
--- a/nodejs/src/lib.rs
+++ b/nodejs/src/lib.rs
@@ -35,7 +35,7 @@ pub struct ConnectionOptions {
    pub read_consistency_interval: Option<f64>,
    /// (For LanceDB OSS only): configuration for object storage.
    ///
-    /// The available options are described at https://lancedb.com/docs/storage/
+    /// The available options are described at https://lancedb.github.io/lancedb/guides/storage/
    pub storage_options: Option<HashMap<String, String>>,
    /// (For LanceDB OSS only): the session to use for this connection. Holds
    /// shared caches and other session-specific state.
--- a/python/python/lancedb/init.py
+++ b/python/python/lancedb/init.py
@@ -72,7 +72,7 @@ def connect(
        default configuration is used.
    storage_options: dict, optional
        Additional options for the storage backend. See available options at
-        <https://lancedb.com/docs/storage/>
+        <https://lancedb.github.io/lancedb/guides/storage/>
    session: Session, optional
        (For LanceDB OSS only)
        A session to use for this connection. Sessions allow you to configure
@@ -174,7 +174,7 @@ async def connect_async(
        default configuration is used.
    storage_options: dict, optional
        Additional options for the storage backend. See available options at
-        <https://lancedb.com/docs/storage/>
+        <https://lancedb.github.io/lancedb/guides/storage/>
    session: Session, optional
        (For LanceDB OSS only)
        A session to use for this connection. Sessions allow you to configure
--- a/python/python/lancedb/_lancedb.pyi
+++ b/python/python/lancedb/_lancedb.pyi
@@ -26,7 +26,7 @@ class Connection(object):
    async def close(self): ...
    async def list_namespaces(
        self,
-        namespace: Optional[List[str]],
+        namespace: List[str],
        page_token: Optional[str],
        limit: Optional[int],
    ) -> List[str]: ...
@@ -34,7 +34,7 @@ class Connection(object):
    async def drop_namespace(self, namespace: List[str]) -> None: ...
    async def table_names(
        self,
-        namespace: Optional[List[str]],
+        namespace: List[str],
        start_after: Optional[str],
        limit: Optional[int],
    ) -> list[str]: ...
@@ -43,7 +43,7 @@ class Connection(object):
        name: str,
        mode: str,
        data: pa.RecordBatchReader,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional[StorageOptionsProvider] = None,
        location: Optional[str] = None,
@@ -53,7 +53,7 @@ class Connection(object):
        name: str,
        mode: str,
        schema: pa.Schema,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional[StorageOptionsProvider] = None,
        location: Optional[str] = None,
@@ -61,7 +61,7 @@ class Connection(object):
    async def open_table(
        self,
        name: str,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional[StorageOptionsProvider] = None,
        index_cache_size: Optional[int] = None,
@@ -71,7 +71,7 @@ class Connection(object):
        self,
        target_table_name: str,
        source_uri: str,
-        target_namespace: Optional[List[str]] = None,
+        target_namespace: List[str] = [],
        source_version: Optional[int] = None,
        source_tag: Optional[str] = None,
        is_shallow: bool = True,
@@ -80,13 +80,11 @@ class Connection(object):
        self,
        cur_name: str,
        new_name: str,
-        cur_namespace: Optional[List[str]] = None,
-        new_namespace: Optional[List[str]] = None,
+        cur_namespace: List[str] = [],
+        new_namespace: List[str] = [],
    ) -> None: ...
-    async def drop_table(
-        self, name: str, namespace: Optional[List[str]] = None
-    ) -> None: ...
-    async def drop_all_tables(self, namespace: Optional[List[str]] = None) -> None: ...
+    async def drop_table(self, name: str, namespace: List[str] = []) -> None: ...
+    async def drop_all_tables(self, namespace: List[str] = []) -> None: ...

 class Table:
    def name(self) -> str: ...
--- a/python/python/lancedb/common.py
+++ b/python/python/lancedb/common.py
@@ -96,7 +96,7 @@ def data_to_reader(
            f"Unknown data type {type(data)}. "
            "Supported types: list of dicts, pandas DataFrame, polars DataFrame, "
            "pyarrow Table/RecordBatch, or Pydantic models. "
-            "See https://lancedb.com/docs/tables/ for examples."
+            "See https://lancedb.github.io/lancedb/guides/tables/ for examples."
        )


--- a/python/python/lancedb/db.py
+++ b/python/python/lancedb/db.py
@@ -54,7 +54,7 @@ class DBConnection(EnforceOverrides):

    def list_namespaces(
        self,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        page_token: Optional[str] = None,
        limit: int = 10,
    ) -> Iterable[str]:
@@ -75,8 +75,6 @@ class DBConnection(EnforceOverrides):
        Iterable of str
            List of immediate child namespace names
        """
-        if namespace is None:
-            namespace = []
        return []

    def create_namespace(self, namespace: List[str]) -> None:
@@ -109,7 +107,7 @@ class DBConnection(EnforceOverrides):
        page_token: Optional[str] = None,
        limit: int = 10,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
    ) -> Iterable[str]:
        """List all tables in this database, in sorted order

@@ -144,7 +142,7 @@ class DBConnection(EnforceOverrides):
        fill_value: float = 0.0,
        embedding_functions: Optional[List[EmbeddingFunctionConfig]] = None,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional["StorageOptionsProvider"] = None,
        data_storage_version: Optional[str] = None,
@@ -193,7 +191,7 @@ class DBConnection(EnforceOverrides):
            Additional options for the storage backend. Options already set on the
            connection will be inherited by the table, but can be overridden here.
            See available options at
-            <https://lancedb.com/docs/storage/>
+            <https://lancedb.github.io/lancedb/guides/storage/>
        data_storage_version: optional, str, default "stable"
            Deprecated.  Set `storage_options` when connecting to the database and set
            `new_table_data_storage_version` in the options.
@@ -310,7 +308,7 @@ class DBConnection(EnforceOverrides):
        self,
        name: str,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional["StorageOptionsProvider"] = None,
        index_cache_size: Optional[int] = None,
@@ -341,7 +339,7 @@ class DBConnection(EnforceOverrides):
            Additional options for the storage backend. Options already set on the
            connection will be inherited by the table, but can be overridden here.
            See available options at
-            <https://lancedb.com/docs/storage/>
+            <https://lancedb.github.io/lancedb/guides/storage/>

        Returns
        -------
@@ -349,7 +347,7 @@ class DBConnection(EnforceOverrides):
        """
        raise NotImplementedError

-    def drop_table(self, name: str, namespace: Optional[List[str]] = None):
+    def drop_table(self, name: str, namespace: List[str] = []):
        """Drop a table from the database.

        Parameters
@@ -360,16 +358,14 @@ class DBConnection(EnforceOverrides):
            The namespace to drop the table from.
            Empty list represents root namespace.
        """
-        if namespace is None:
-            namespace = []
        raise NotImplementedError

    def rename_table(
        self,
        cur_name: str,
        new_name: str,
-        cur_namespace: Optional[List[str]] = None,
-        new_namespace: Optional[List[str]] = None,
+        cur_namespace: List[str] = [],
+        new_namespace: List[str] = [],
    ):
        """Rename a table in the database.

@@ -386,10 +382,6 @@ class DBConnection(EnforceOverrides):
            The namespace to move the table to.
            If not specified, defaults to the same as cur_namespace.
        """
-        if cur_namespace is None:
-            cur_namespace = []
-        if new_namespace is None:
-            new_namespace = []
        raise NotImplementedError

    def drop_database(self):
@@ -399,7 +391,7 @@ class DBConnection(EnforceOverrides):
        """
        raise NotImplementedError

-    def drop_all_tables(self, namespace: Optional[List[str]] = None):
+    def drop_all_tables(self, namespace: List[str] = []):
        """
        Drop all tables from the database

@@ -409,8 +401,6 @@ class DBConnection(EnforceOverrides):
            The namespace to drop all tables from.
            None or empty list represents root namespace.
        """
-        if namespace is None:
-            namespace = []
        raise NotImplementedError

    @property
@@ -551,7 +541,7 @@ class LanceDBConnection(DBConnection):
    @override
    def list_namespaces(
        self,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        page_token: Optional[str] = None,
        limit: int = 10,
    ) -> Iterable[str]:
@@ -572,8 +562,6 @@ class LanceDBConnection(DBConnection):
        Iterable of str
            List of immediate child namespace names
        """
-        if namespace is None:
-            namespace = []
        return LOOP.run(
            self._conn.list_namespaces(
                namespace=namespace, page_token=page_token, limit=limit
@@ -608,7 +596,7 @@ class LanceDBConnection(DBConnection):
        page_token: Optional[str] = None,
        limit: int = 10,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
    ) -> Iterable[str]:
        """Get the names of all tables in the database. The names are sorted.

@@ -626,8 +614,6 @@ class LanceDBConnection(DBConnection):
        Iterator of str.
            A list of table names.
        """
-        if namespace is None:
-            namespace = []
        return LOOP.run(
            self._conn.table_names(
                namespace=namespace, start_after=page_token, limit=limit
@@ -652,7 +638,7 @@ class LanceDBConnection(DBConnection):
        fill_value: float = 0.0,
        embedding_functions: Optional[List[EmbeddingFunctionConfig]] = None,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional["StorageOptionsProvider"] = None,
        data_storage_version: Optional[str] = None,
@@ -669,8 +655,6 @@ class LanceDBConnection(DBConnection):
        ---
        DBConnection.create_table
        """
-        if namespace is None:
-            namespace = []
        if mode.lower() not in ["create", "overwrite"]:
            raise ValueError("mode must be either 'create' or 'overwrite'")
        validate_table_name(name)
@@ -696,7 +680,7 @@ class LanceDBConnection(DBConnection):
        self,
        name: str,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional["StorageOptionsProvider"] = None,
        index_cache_size: Optional[int] = None,
@@ -714,8 +698,6 @@ class LanceDBConnection(DBConnection):
        -------
        A LanceTable object representing the table.
        """
-        if namespace is None:
-            namespace = []
        if index_cache_size is not None:
            import warnings

@@ -741,7 +723,7 @@ class LanceDBConnection(DBConnection):
        target_table_name: str,
        source_uri: str,
        *,
-        target_namespace: Optional[List[str]] = None,
+        target_namespace: List[str] = [],
        source_version: Optional[int] = None,
        source_tag: Optional[str] = None,
        is_shallow: bool = True,
@@ -774,8 +756,6 @@ class LanceDBConnection(DBConnection):
        -------
        A LanceTable object representing the cloned table.
        """
-        if target_namespace is None:
-            target_namespace = []
        LOOP.run(
            self._conn.clone_table(
                target_table_name,
@@ -796,7 +776,7 @@ class LanceDBConnection(DBConnection):
    def drop_table(
        self,
        name: str,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        ignore_missing: bool = False,
    ):
        """Drop a table from the database.
@@ -810,8 +790,6 @@ class LanceDBConnection(DBConnection):
        ignore_missing: bool, default False
            If True, ignore if the table does not exist.
        """
-        if namespace is None:
-            namespace = []
        LOOP.run(
            self._conn.drop_table(
                name, namespace=namespace, ignore_missing=ignore_missing
@@ -819,9 +797,7 @@ class LanceDBConnection(DBConnection):
        )

    @override
-    def drop_all_tables(self, namespace: Optional[List[str]] = None):
-        if namespace is None:
-            namespace = []
+    def drop_all_tables(self, namespace: List[str] = []):
        LOOP.run(self._conn.drop_all_tables(namespace=namespace))

    @override
@@ -829,8 +805,8 @@ class LanceDBConnection(DBConnection):
        self,
        cur_name: str,
        new_name: str,
-        cur_namespace: Optional[List[str]] = None,
-        new_namespace: Optional[List[str]] = None,
+        cur_namespace: List[str] = [],
+        new_namespace: List[str] = [],
    ):
        """Rename a table in the database.

@@ -845,10 +821,6 @@ class LanceDBConnection(DBConnection):
        new_namespace: List[str], optional
            The namespace to move the table to.
        """
-        if cur_namespace is None:
-            cur_namespace = []
-        if new_namespace is None:
-            new_namespace = []
        LOOP.run(
            self._conn.rename_table(
                cur_name,
@@ -938,7 +910,7 @@ class AsyncConnection(object):

    async def list_namespaces(
        self,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        page_token: Optional[str] = None,
        limit: int = 10,
    ) -> Iterable[str]:
@@ -959,8 +931,6 @@ class AsyncConnection(object):
        Iterable of str
            List of immediate child namespace names (not full paths)
        """
-        if namespace is None:
-            namespace = []
        return await self._inner.list_namespaces(
            namespace=namespace, page_token=page_token, limit=limit
        )
@@ -988,7 +958,7 @@ class AsyncConnection(object):
    async def table_names(
        self,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        start_after: Optional[str] = None,
        limit: Optional[int] = None,
    ) -> Iterable[str]:
@@ -1012,8 +982,6 @@ class AsyncConnection(object):
        -------
        Iterable of str
        """
-        if namespace is None:
-            namespace = []
        return await self._inner.table_names(
            namespace=namespace, start_after=start_after, limit=limit
        )
@@ -1030,7 +998,7 @@ class AsyncConnection(object):
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional["StorageOptionsProvider"] = None,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        embedding_functions: Optional[List[EmbeddingFunctionConfig]] = None,
        location: Optional[str] = None,
    ) -> AsyncTable:
@@ -1077,7 +1045,7 @@ class AsyncConnection(object):
            Additional options for the storage backend. Options already set on the
            connection will be inherited by the table, but can be overridden here.
            See available options at
-            <https://lancedb.com/docs/storage/>
+            <https://lancedb.github.io/lancedb/guides/storage/>

        Returns
        -------
@@ -1187,8 +1155,6 @@ class AsyncConnection(object):
        ...     await db.create_table("table4", make_batches(), schema=schema)
        >>> asyncio.run(iterable_example())
        """
-        if namespace is None:
-            namespace = []
        metadata = None

        if embedding_functions is not None:
@@ -1246,7 +1212,7 @@ class AsyncConnection(object):
        self,
        name: str,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional["StorageOptionsProvider"] = None,
        index_cache_size: Optional[int] = None,
@@ -1265,7 +1231,7 @@ class AsyncConnection(object):
            Additional options for the storage backend. Options already set on the
            connection will be inherited by the table, but can be overridden here.
            See available options at
-            <https://lancedb.com/docs/storage/>
+            <https://lancedb.github.io/lancedb/guides/storage/>
        index_cache_size: int, default 256
            **Deprecated**: Use session-level cache configuration instead.
            Create a Session with custom cache sizes and pass it to lancedb.connect().
@@ -1288,8 +1254,6 @@ class AsyncConnection(object):
        -------
        A LanceTable object representing the table.
        """
-        if namespace is None:
-            namespace = []
        table = await self._inner.open_table(
            name,
            namespace=namespace,
@@ -1305,7 +1269,7 @@ class AsyncConnection(object):
        target_table_name: str,
        source_uri: str,
        *,
-        target_namespace: Optional[List[str]] = None,
+        target_namespace: List[str] = [],
        source_version: Optional[int] = None,
        source_tag: Optional[str] = None,
        is_shallow: bool = True,
@@ -1338,8 +1302,6 @@ class AsyncConnection(object):
        -------
        An AsyncTable object representing the cloned table.
        """
-        if target_namespace is None:
-            target_namespace = []
        table = await self._inner.clone_table(
            target_table_name,
            source_uri,
@@ -1354,8 +1316,8 @@ class AsyncConnection(object):
        self,
        cur_name: str,
        new_name: str,
-        cur_namespace: Optional[List[str]] = None,
-        new_namespace: Optional[List[str]] = None,
+        cur_namespace: List[str] = [],
+        new_namespace: List[str] = [],
    ):
        """Rename a table in the database.

@@ -1372,10 +1334,6 @@ class AsyncConnection(object):
            The namespace to move the table to.
            If not specified, defaults to the same as cur_namespace.
        """
-        if cur_namespace is None:
-            cur_namespace = []
-        if new_namespace is None:
-            new_namespace = []
        await self._inner.rename_table(
            cur_name, new_name, cur_namespace=cur_namespace, new_namespace=new_namespace
        )
@@ -1384,7 +1342,7 @@ class AsyncConnection(object):
        self,
        name: str,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        ignore_missing: bool = False,
    ):
        """Drop a table from the database.
@@ -1399,8 +1357,6 @@ class AsyncConnection(object):
        ignore_missing: bool, default False
            If True, ignore if the table does not exist.
        """
-        if namespace is None:
-            namespace = []
        try:
            await self._inner.drop_table(name, namespace=namespace)
        except ValueError as e:
@@ -1409,7 +1365,7 @@ class AsyncConnection(object):
            if f"Table '{name}' was not found" not in str(e):
                raise e

-    async def drop_all_tables(self, namespace: Optional[List[str]] = None):
+    async def drop_all_tables(self, namespace: List[str] = []):
        """Drop all tables from the database.

        Parameters
@@ -1418,8 +1374,6 @@ class AsyncConnection(object):
            The namespace to drop all tables from.
            None or empty list represents root namespace.
        """
-        if namespace is None:
-            namespace = []
        await self._inner.drop_all_tables(namespace=namespace)

    @deprecation.deprecated(
--- a/python/python/lancedb/namespace.py
+++ b/python/python/lancedb/namespace.py
@@ -235,10 +235,8 @@ class LanceNamespaceDBConnection(DBConnection):
        page_token: Optional[str] = None,
        limit: int = 10,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
    ) -> Iterable[str]:
-        if namespace is None:
-            namespace = []
        request = ListTablesRequest(id=namespace, page_token=page_token, limit=limit)
        response = self._ns.list_tables(request)
        return response.tables if response.tables else []
@@ -255,14 +253,12 @@ class LanceNamespaceDBConnection(DBConnection):
        fill_value: float = 0.0,
        embedding_functions: Optional[List[EmbeddingFunctionConfig]] = None,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional[StorageOptionsProvider] = None,
        data_storage_version: Optional[str] = None,
        enable_v2_manifest_paths: Optional[bool] = None,
    ) -> Table:
-        if namespace is None:
-            namespace = []
        if mode.lower() not in ["create", "overwrite"]:
            raise ValueError("mode must be either 'create' or 'overwrite'")
        validate_table_name(name)
@@ -351,13 +347,11 @@ class LanceNamespaceDBConnection(DBConnection):
        self,
        name: str,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional[StorageOptionsProvider] = None,
        index_cache_size: Optional[int] = None,
    ) -> Table:
-        if namespace is None:
-            namespace = []
        table_id = namespace + [name]
        request = DescribeTableRequest(id=table_id)
        response = self._ns.describe_table(request)
@@ -387,10 +381,8 @@ class LanceNamespaceDBConnection(DBConnection):
        )

    @override
-    def drop_table(self, name: str, namespace: Optional[List[str]] = None):
+    def drop_table(self, name: str, namespace: List[str] = []):
        # Use namespace drop_table directly
-        if namespace is None:
-            namespace = []
        table_id = namespace + [name]
        request = DropTableRequest(id=table_id)
        self._ns.drop_table(request)
@@ -400,13 +392,9 @@ class LanceNamespaceDBConnection(DBConnection):
        self,
        cur_name: str,
        new_name: str,
-        cur_namespace: Optional[List[str]] = None,
-        new_namespace: Optional[List[str]] = None,
+        cur_namespace: List[str] = [],
+        new_namespace: List[str] = [],
    ):
-        if cur_namespace is None:
-            cur_namespace = []
-        if new_namespace is None:
-            new_namespace = []
        raise NotImplementedError(
            "rename_table is not supported for namespace connections"
        )
@@ -418,16 +406,14 @@ class LanceNamespaceDBConnection(DBConnection):
        )

    @override
-    def drop_all_tables(self, namespace: Optional[List[str]] = None):
-        if namespace is None:
-            namespace = []
+    def drop_all_tables(self, namespace: List[str] = []):
        for table_name in self.table_names(namespace=namespace):
            self.drop_table(table_name, namespace=namespace)

    @override
    def list_namespaces(
        self,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        page_token: Optional[str] = None,
        limit: int = 10,
    ) -> Iterable[str]:
@@ -449,8 +435,6 @@ class LanceNamespaceDBConnection(DBConnection):
        Iterable[str]
            Names of child namespaces.
        """
-        if namespace is None:
-            namespace = []
        request = ListNamespacesRequest(
            id=namespace, page_token=page_token, limit=limit
        )
@@ -488,15 +472,13 @@ class LanceNamespaceDBConnection(DBConnection):
        name: str,
        table_uri: str,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional[StorageOptionsProvider] = None,
        index_cache_size: Optional[int] = None,
    ) -> LanceTable:
        # Open a table directly from a URI using the location parameter
        # Note: storage_options should already be merged by the caller
-        if namespace is None:
-            namespace = []
        temp_conn = LanceDBConnection(
            table_uri,  # Use the table location as the connection URI
            read_consistency_interval=self.read_consistency_interval,
@@ -557,11 +539,9 @@ class AsyncLanceNamespaceDBConnection:
        page_token: Optional[str] = None,
        limit: int = 10,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
    ) -> Iterable[str]:
        """List table names in the namespace."""
-        if namespace is None:
-            namespace = []
        request = ListTablesRequest(id=namespace, page_token=page_token, limit=limit)
        response = self._ns.list_tables(request)
        return response.tables if response.tables else []
@@ -577,15 +557,13 @@ class AsyncLanceNamespaceDBConnection:
        fill_value: float = 0.0,
        embedding_functions: Optional[List[EmbeddingFunctionConfig]] = None,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional[StorageOptionsProvider] = None,
        data_storage_version: Optional[str] = None,
        enable_v2_manifest_paths: Optional[bool] = None,
    ) -> AsyncTable:
        """Create a new table in the namespace."""
-        if namespace is None:
-            namespace = []
        if mode.lower() not in ["create", "overwrite"]:
            raise ValueError("mode must be either 'create' or 'overwrite'")
        validate_table_name(name)
@@ -677,14 +655,12 @@ class AsyncLanceNamespaceDBConnection:
        self,
        name: str,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional[StorageOptionsProvider] = None,
        index_cache_size: Optional[int] = None,
    ) -> AsyncTable:
        """Open an existing table from the namespace."""
-        if namespace is None:
-            namespace = []
        table_id = namespace + [name]
        request = DescribeTableRequest(id=table_id)
        response = self._ns.describe_table(request)
@@ -725,10 +701,8 @@ class AsyncLanceNamespaceDBConnection:
        lance_table = await asyncio.to_thread(_open_table)
        return lance_table._table

-    async def drop_table(self, name: str, namespace: Optional[List[str]] = None):
+    async def drop_table(self, name: str, namespace: List[str] = []):
        """Drop a table from the namespace."""
-        if namespace is None:
-            namespace = []
        table_id = namespace + [name]
        request = DropTableRequest(id=table_id)
        self._ns.drop_table(request)
@@ -737,14 +711,10 @@ class AsyncLanceNamespaceDBConnection:
        self,
        cur_name: str,
        new_name: str,
-        cur_namespace: Optional[List[str]] = None,
-        new_namespace: Optional[List[str]] = None,
+        cur_namespace: List[str] = [],
+        new_namespace: List[str] = [],
    ):
        """Rename is not supported for namespace connections."""
-        if cur_namespace is None:
-            cur_namespace = []
-        if new_namespace is None:
-            new_namespace = []
        raise NotImplementedError(
            "rename_table is not supported for namespace connections"
        )
@@ -755,17 +725,15 @@ class AsyncLanceNamespaceDBConnection:
            "drop_database is deprecated, use drop_all_tables instead"
        )

-    async def drop_all_tables(self, namespace: Optional[List[str]] = None):
+    async def drop_all_tables(self, namespace: List[str] = []):
        """Drop all tables in the namespace."""
-        if namespace is None:
-            namespace = []
        table_names = await self.table_names(namespace=namespace)
        for table_name in table_names:
            await self.drop_table(table_name, namespace=namespace)

    async def list_namespaces(
        self,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        page_token: Optional[str] = None,
        limit: int = 10,
    ) -> Iterable[str]:
@@ -787,8 +755,6 @@ class AsyncLanceNamespaceDBConnection:
        Iterable[str]
            Names of child namespaces.
        """
-        if namespace is None:
-            namespace = []
        request = ListNamespacesRequest(
            id=namespace, page_token=page_token, limit=limit
        )
--- a/python/python/lancedb/query.py
+++ b/python/python/lancedb/query.py
@@ -883,7 +883,7 @@ class LanceQueryBuilder(ABC):
        ----------
        where: str
            The where clause which is a valid SQL where clause. See
-            `Lance filter pushdown <https://lance.org/guide/read_and_write#filter-push-down>`_
+            `Lance filter pushdown <https://lancedb.github.io/lance/read_and_write.html#filter-push-down>`_
            for valid SQL expressions.
        prefilter: bool, default True
            If True, apply the filter before vector search, otherwise the
@@ -1356,7 +1356,7 @@ class LanceVectorQueryBuilder(LanceQueryBuilder):
        ----------
        where: str
            The where clause which is a valid SQL where clause. See
-            `Lance filter pushdown <https://lance.org/guide/read_and_write#filter-push-down>`_
+            `Lance filter pushdown <https://lancedb.github.io/lance/read_and_write.html#filter-push-down>`_
            for valid SQL expressions.
        prefilter: bool, default True
            If True, apply the filter before vector search, otherwise the
@@ -1495,7 +1495,7 @@ class LanceFtsQueryBuilder(LanceQueryBuilder):
        if self._phrase_query:
            if isinstance(query, str):
                if not query.startswith('"') or not query.endswith('"'):
-                    self._query = f'"{query}"'
+                    query = f'"{query}"'
            elif isinstance(query, FullTextQuery) and not isinstance(
                query, PhraseQuery
            ):
--- a/python/python/lancedb/remote/db.py
+++ b/python/python/lancedb/remote/db.py
@@ -104,7 +104,7 @@ class RemoteDBConnection(DBConnection):
    @override
    def list_namespaces(
        self,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        page_token: Optional[str] = None,
        limit: int = 10,
    ) -> Iterable[str]:
@@ -125,8 +125,6 @@ class RemoteDBConnection(DBConnection):
        Iterable of str
            List of immediate child namespace names
        """
-        if namespace is None:
-            namespace = []
        return LOOP.run(
            self._conn.list_namespaces(
                namespace=namespace, page_token=page_token, limit=limit
@@ -161,7 +159,7 @@ class RemoteDBConnection(DBConnection):
        page_token: Optional[str] = None,
        limit: int = 10,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
    ) -> Iterable[str]:
        """List the names of all tables in the database.

@@ -179,8 +177,6 @@ class RemoteDBConnection(DBConnection):
        -------
        An iterator of table names.
        """
-        if namespace is None:
-            namespace = []
        return LOOP.run(
            self._conn.table_names(
                namespace=namespace, start_after=page_token, limit=limit
@@ -192,7 +188,7 @@ class RemoteDBConnection(DBConnection):
        self,
        name: str,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        index_cache_size: Optional[int] = None,
    ) -> Table:
@@ -212,8 +208,6 @@ class RemoteDBConnection(DBConnection):
        """
        from .table import RemoteTable

-        if namespace is None:
-            namespace = []
        if index_cache_size is not None:
            logging.info(
                "index_cache_size is ignored in LanceDb Cloud"
@@ -228,7 +222,7 @@ class RemoteDBConnection(DBConnection):
        target_table_name: str,
        source_uri: str,
        *,
-        target_namespace: Optional[List[str]] = None,
+        target_namespace: List[str] = [],
        source_version: Optional[int] = None,
        source_tag: Optional[str] = None,
        is_shallow: bool = True,
@@ -258,8 +252,6 @@ class RemoteDBConnection(DBConnection):
        """
        from .table import RemoteTable

-        if target_namespace is None:
-            target_namespace = []
        table = LOOP.run(
            self._conn.clone_table(
                target_table_name,
@@ -283,7 +275,7 @@ class RemoteDBConnection(DBConnection):
        mode: Optional[str] = None,
        embedding_functions: Optional[List[EmbeddingFunctionConfig]] = None,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
    ) -> Table:
        """Create a [Table][lancedb.table.Table] in the database.

@@ -380,8 +372,6 @@ class RemoteDBConnection(DBConnection):
        LanceTable(table4)

        """
-        if namespace is None:
-            namespace = []
        validate_table_name(name)
        if embedding_functions is not None:
            logging.warning(
@@ -406,7 +396,7 @@ class RemoteDBConnection(DBConnection):
        return RemoteTable(table, self.db_name)

    @override
-    def drop_table(self, name: str, namespace: Optional[List[str]] = None):
+    def drop_table(self, name: str, namespace: List[str] = []):
        """Drop a table from the database.

        Parameters
@@ -417,8 +407,6 @@ class RemoteDBConnection(DBConnection):
            The namespace to drop the table from.
            None or empty list represents root namespace.
        """
-        if namespace is None:
-            namespace = []
        LOOP.run(self._conn.drop_table(name, namespace=namespace))

    @override
@@ -426,8 +414,8 @@ class RemoteDBConnection(DBConnection):
        self,
        cur_name: str,
        new_name: str,
-        cur_namespace: Optional[List[str]] = None,
-        new_namespace: Optional[List[str]] = None,
+        cur_namespace: List[str] = [],
+        new_namespace: List[str] = [],
    ):
        """Rename a table in the database.

@@ -438,10 +426,6 @@ class RemoteDBConnection(DBConnection):
        new_name: str
            The new name of the table.
        """
-        if cur_namespace is None:
-            cur_namespace = []
-        if new_namespace is None:
-            new_namespace = []
        LOOP.run(
            self._conn.rename_table(
                cur_name,
--- a/python/python/lancedb/remote/table.py
+++ b/python/python/lancedb/remote/table.py
@@ -652,17 +652,6 @@ class RemoteTable(Table):
            "migrate_v2_manifest_paths() is not supported on the LanceDB Cloud"
        )

-    def head(self, n=5) -> pa.Table:
-        """
-        Return the first `n` rows of the table.
-
-        Parameters
-        ----------
-        n: int, default 5
-            The number of rows to return.
-        """
-        return LOOP.run(self._table.query().limit(n).to_arrow())
-

 def add_index(tbl: pa.Table, i: int) -> pa.Table:
    return tbl.add_column(
--- a/python/python/lancedb/table.py
+++ b/python/python/lancedb/table.py
@@ -178,7 +178,7 @@ def _into_pyarrow_reader(
            f"Unknown data type {type(data)}. "
            "Supported types: list of dicts, pandas DataFrame, polars DataFrame, "
            "pyarrow Table/RecordBatch, or Pydantic models. "
-            "See https://lancedb.com/docs/tables/ for examples."
+            "See https://lancedb.github.io/lancedb/guides/tables/ for examples."
        )


@@ -1708,15 +1708,13 @@ class LanceTable(Table):
        connection: "LanceDBConnection",
        name: str,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional["StorageOptionsProvider"] = None,
        index_cache_size: Optional[int] = None,
        location: Optional[str] = None,
        _async: AsyncTable = None,
    ):
-        if namespace is None:
-            namespace = []
        self._conn = connection
        self._namespace = namespace
        self._location = location  # Store location for use in _dataset_path
@@ -1768,14 +1766,12 @@ class LanceTable(Table):
        db,
        name,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str]] = None,
        storage_options_provider: Optional["StorageOptionsProvider"] = None,
        index_cache_size: Optional[int] = None,
        location: Optional[str] = None,
    ):
-        if namespace is None:
-            namespace = []
        tbl = cls(
            db,
            name,
@@ -2627,7 +2623,7 @@ class LanceTable(Table):
        fill_value: float = 0.0,
        embedding_functions: Optional[List[EmbeddingFunctionConfig]] = None,
        *,
-        namespace: Optional[List[str]] = None,
+        namespace: List[str] = [],
        storage_options: Optional[Dict[str, str | bool]] = None,
        storage_options_provider: Optional["StorageOptionsProvider"] = None,
        data_storage_version: Optional[str] = None,
@@ -2687,8 +2683,6 @@ class LanceTable(Table):
            Deprecated.  Set `storage_options` when connecting to the database and set
            `new_table_enable_v2_manifest_paths` in the options.
        """
-        if namespace is None:
-            namespace = []
        self = cls.__new__(cls)
        self._conn = db
        self._namespace = namespace
--- a/python/python/tests/test_fts.py
+++ b/python/python/tests/test_fts.py
@@ -325,18 +325,11 @@ def test_search_fts_phrase_query(table):
        pass
    table.create_fts_index("text", use_tantivy=False, with_position=True, replace=True)
    results = table.search("puppy").limit(100).to_list()
-
-    # Test with quotation marks
    phrase_results = table.search('"puppy runs"').limit(100).to_list()
    assert len(results) > len(phrase_results)
    assert len(phrase_results) > 0

-    # Test with .phrase_query()
-    phrase_results = table.search("puppy runs").phrase_query().limit(100).to_list()
-    assert len(results) > len(phrase_results)
-    assert len(phrase_results) > 0
-
-    # Test with PhraseQuery()
+    # Test with a query
    phrase_results = (
        table.search(PhraseQuery("puppy runs", "text")).limit(100).to_list()
    )
--- a/python/python/tests/test_remote_db.py
+++ b/python/python/tests/test_remote_db.py
@@ -546,22 +546,6 @@ def query_test_table(query_handler, *, server_version=Version("0.1.0")):
        yield table


-def test_head():
-    def handler(body):
-        assert body == {
-            "k": 5,
-            "prefilter": True,
-            "vector": [],
-            "version": None,
-        }
-
-        return pa.table({"id": [1, 2, 3]})
-
-    with query_test_table(handler) as table:
-        data = table.head(5)
-        assert data == pa.table({"id": [1, 2, 3]})
-
-
 def test_query_sync_minimal():
    def handler(body):
        assert body == {
--- a/python/python/tests/test_table.py
+++ b/python/python/tests/test_table.py
@@ -1487,7 +1487,7 @@ def setup_hybrid_search_table(db: DBConnection, embedding_func):
    table.add([{"text": p} for p in phrases])

    # Create a fts index
-    table.create_fts_index("text", with_position=True)
+    table.create_fts_index("text")

    return table, MyTable, emb

--- a/rust/lancedb/src/connection.rs
+++ b/rust/lancedb/src/connection.rs
@@ -239,7 +239,7 @@ impl<const HAS_DATA: bool> CreateTableBuilder<HAS_DATA> {
    /// Options already set on the connection will be inherited by the table,
    /// but can be overridden here.
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    pub fn storage_option(mut self, key: impl Into<String>, value: impl Into<String>) -> Self {
        let store_options = self
            .request
@@ -259,7 +259,7 @@ impl<const HAS_DATA: bool> CreateTableBuilder<HAS_DATA> {
    /// Options already set on the connection will be inherited by the table,
    /// but can be overridden here.
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    pub fn storage_options(
        mut self,
        pairs: impl IntoIterator<Item = (impl Into<String>, impl Into<String>)>,
@@ -442,7 +442,7 @@ impl OpenTableBuilder {
    /// Options already set on the connection will be inherited by the table,
    /// but can be overridden here.
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    pub fn storage_option(mut self, key: impl Into<String>, value: impl Into<String>) -> Self {
        let storage_options = self
            .request
@@ -461,7 +461,7 @@ impl OpenTableBuilder {
    /// Options already set on the connection will be inherited by the table,
    /// but can be overridden here.
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    pub fn storage_options(
        mut self,
        pairs: impl IntoIterator<Item = (impl Into<String>, impl Into<String>)>,
@@ -959,7 +959,7 @@ impl ConnectBuilder {

    /// Set an option for the storage layer.
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    pub fn storage_option(mut self, key: impl Into<String>, value: impl Into<String>) -> Self {
        self.request.options.insert(key.into(), value.into());
        self
@@ -967,7 +967,7 @@ impl ConnectBuilder {

    /// Set multiple options for the storage layer.
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    pub fn storage_options(
        mut self,
        pairs: impl IntoIterator<Item = (impl Into<String>, impl Into<String>)>,
@@ -1102,7 +1102,7 @@ impl ConnectNamespaceBuilder {

    /// Set an option for the storage layer.
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    pub fn storage_option(mut self, key: impl Into<String>, value: impl Into<String>) -> Self {
        self.storage_options.insert(key.into(), value.into());
        self
@@ -1110,7 +1110,7 @@ impl ConnectNamespaceBuilder {

    /// Set multiple options for the storage layer.
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    pub fn storage_options(
        mut self,
        pairs: impl IntoIterator<Item = (impl Into<String>, impl Into<String>)>,
--- a/rust/lancedb/src/database/listing.rs
+++ b/rust/lancedb/src/database/listing.rs
@@ -60,7 +60,7 @@ pub struct ListingDatabaseOptions {
    /// These are used to create/list tables and they are inherited by all tables
    /// opened by this database.
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    pub storage_options: HashMap<String, String>,
 }

@@ -157,7 +157,7 @@ impl ListingDatabaseOptionsBuilder {

    /// Set an option for the storage layer.
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    pub fn storage_option(mut self, key: impl Into<String>, value: impl Into<String>) -> Self {
        self.options
            .storage_options
@@ -167,7 +167,7 @@ impl ListingDatabaseOptionsBuilder {

    /// Set multiple options for the storage layer.
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    pub fn storage_options(
        mut self,
        pairs: impl IntoIterator<Item = (impl Into<String>, impl Into<String>)>,
--- a/rust/lancedb/src/lib.rs
+++ b/rust/lancedb/src/lib.rs
@@ -71,7 +71,7 @@
 //! It treats [`FixedSizeList<Float16/Float32>`](https://docs.rs/arrow/latest/arrow/array/struct.FixedSizeListArray.html)
 //! columns as vector columns.
 //!
-//! For more details, please refer to the [LanceDB documentation](https://lancedb.com/docs).
+//! For more details, please refer to [LanceDB documentation](https://lancedb.github.io/lancedb/).
 //!
 //! #### Create a table
 //!
--- a/rust/lancedb/src/remote/db.rs
+++ b/rust/lancedb/src/remote/db.rs
@@ -90,7 +90,7 @@ pub struct RemoteDatabaseOptions {
    pub host_override: Option<String>,
    /// Storage options configure the storage layer (e.g. S3, GCS, Azure, etc.)
    ///
-    /// See available options at <https://lancedb.com/docs/storage/>
+    /// See available options at <https://lancedb.github.io/lancedb/guides/storage/>
    ///
    /// These options are only used for LanceDB Enterprise and only a subset of options
    /// are supported.