Skip to content

Comments

Clarify namespace model for LanceDB users; add concepts + SDK usage docs#163

Merged
prrao87 merged 4 commits intomainfrom
codex/explain-namespaces
Feb 20, 2026
Merged

Clarify namespace model for LanceDB users; add concepts + SDK usage docs#163
prrao87 merged 4 commits intomainfrom
codex/explain-namespaces

Conversation

@prrao87
Copy link
Contributor

@prrao87 prrao87 commented Feb 20, 2026

Fixes #141

Summary

This PR resolves user confusion per #141 by splitting namespace documentation into:

  • a concepts/explanation page: what namespaces are in LanceDB, where they fit, and why they matter
  • usage/how-to pages (how namespace parameters are used across SDKs).

It also removes the low-value “Feature catalog” page which was noisy (and likely out-of-date) and replaces it with something that's more directly useful for LanceDB users who may have heard of Lance, but don't clearly know how they fit together.

Why do we need this?

Users are seeing namespace in the SDK API reference (for example drop_table) without clear context on the following:

  • LanceDB as a catalog-level abstraction, and
  • how namespace paths relate to table resolution.

This PR makes that model explicit and easier to navigate as a new user learning how to use LanceDB and manage tables.

Validation

  • Regenerated snippets:
    • make snippets
  • Verified Python snippet source syntax:
    • uv run pytest tests/py/test_connection.py

@prrao87 prrao87 merged commit fae4979 into main Feb 20, 2026
2 checks passed
@prrao87 prrao87 deleted the codex/explain-namespaces branch February 20, 2026 16:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Confusion over "table" vs. "namespace" based on SDK docs

1 participant