Updates to IBM-related connectors

[Paul-Cornell]

• Astra DB has renamed "namespaces" to "keyspaces" in its UI and throughout its documentation. I've made similar updates across our docs accordingly.

• Added more how-to steps to the Astra DB connector docs inline, to keep from forcing readers to click back and forth between our docs and Astra DB's docs. See:

  • https://unstructured-53-ibm-connectors-2025-10-22.mintlify.app/ui/destinations/astradb
  • https://unstructured-53-ibm-connectors-2025-10-22.mintlify.app/api-reference/workflow/destinations/astradb
  • https://unstructured-53-ibm-connectors-2025-10-22.mintlify.app/open-source/ingestion/source-connectors/astradb
  • https://unstructured-53-ibm-connectors-2025-10-22.mintlify.app/open-source/ingestion/destination-connectors/astradb

• Added more how-to steps to the Milvus (on IBM watsonx.data) connector docs inline, to keep from forcing readers to click back and forth between our docs and IBM's docs. Also, rearranged the sections in these docs so that Milvus on IBM watsonx.data comes first, followed by Milvus on Zilliz Cloud, and then Milvus local. (Until now, Zilliz had come first.) See:

  • https://unstructured-53-ibm-connectors-2025-10-22.mintlify.app/ui/destinations/milvus
  • https://unstructured-53-ibm-connectors-2025-10-22.mintlify.app/api-reference/workflow/destinations/milvus
  • https://unstructured-53-ibm-connectors-2025-10-22.mintlify.app/open-source/ingestion/destination-connectors/milvus

• The Apache Iceberg-based IBM watsonx.data connector is not well-suited to embedding storage or semantic similarity queries. (Use the Astra DB or Milvus [on IBM watsonx.data] connectors instead.) See the top/beginning of:

  • https://unstructured-53-ibm-connectors-2025-10-22.mintlify.app/ui/destinations/ibm-watsonxdata
  • https://unstructured-53-ibm-connectors-2025-10-22.mintlify.app/api-reference/workflow/destinations/ibm-watsonxdata
  • https://unstructured-53-ibm-connectors-2025-10-22.mintlify.app/open-source/ingestion/destination-connectors/ibm-watsonxdata

---

Note

Adds guidance warning for IBM watsonx.data (Iceberg) destinations, expands Milvus on IBM watsonx.data and Astra DB docs with step-by-step setup, and updates Astra terminology from namespaces to keyspaces.

• IBM watsonx.data destinations:
  • Add tip warning that the connector relies on Apache Iceberg and is not suited for embeddings/semantic search; recommend Astra DB and Milvus instead in api-reference/workflow/destinations/ibm-watsonxdata.mdx, open-source/ingestion/destination-connectors/ibm-watsonxdata.mdx, and ui/destinations/ibm-watsonxdata.mdx.
• Milvus docs (snippets/general-shared-text/milvus.mdx):
  • Reorder sections to lead with Milvus on IBM watsonx.data.
  • Add detailed setup steps for IBM Cloud/watsonx.data Milvus (plans, instance creation, URI, auth via IBM Cloud API key), plus collection requirements.
  • Minor copy edits and schema section clarification.
• Astra DB docs:
  • Update terminology from “namespace(s)” to “keyspace(s)” and copy tweaks in snippets/general-shared-text/astradb-api-placeholders.mdx and snippets/general-shared-text/astradb-platform.mdx.
  • Substantially expand snippets/general-shared-text/astradb.mdx with step-by-step setup (account, database, token, keyspace, collection), clarify when collections are required, and adjust runtime behaviors/naming conventions.

^{Written by Cursor Bugbot for commit d02623a. This will update automatically on new commits. Configure here.}