Update table operations docs with identified gaps

[prrao87]

Summary

Address three documentation gaps surfaced by the docs audit:

• Conflict handling for create_table — added a new "Handle existing tables" subsection right after the first basic create example, explaining when to use exist_ok (idempotent open) vs mode="overwrite" (replace), with the schema-validation behaviour and data-loss caveats called out.
• Tag-based version management — added a new "Tag-Based Versioning" section covering the full tags API (create, list, get_version, update, delete) plus checkout-by-tag. Notes that the Rust SDK uses a separate checkout_tag() method, while Python and TypeScript overload checkout() to accept either a numeric version or a tag string.
• Tag retention during cleanup — updated the existing optimize() cleanup note to make explicit that tagged versions are exempt from cleanup_older_than pruning and must have their tags removed before they become eligible for deletion.

Code blocks are added into testable snippets and tested with the latest version of LanceDB.

Test plan

• Python test suite passes
• TypeScript test suite passes
• Rust example builds and runs to completion
• make snippets regenerates without diff after a clean run
• Rendered docs preview shows three-language code tabs in both new sections
• All cross-page anchor links resolve

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
lancedb-bcbb4faf	🟢 Ready	View Preview	May 4, 2026, 1:06 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.