-
Notifications
You must be signed in to change notification settings - Fork 25.6k
Closed
Labels
:mlMachine learningMachine learning>docsGeneral docs changesGeneral docs changesTeam:DocsMeta label for docs teamMeta label for docs teamTeam:MLMeta label for the ML teamMeta label for the ML team
Description
The “Tutorial: semantic search with semantic_text” in the Elasticsearch documentation currently uses the ELSER model, which has been deprecated as of version 8.16. However, the tutorial does not include any deprecation warning to notify users about this status. This can lead to confusion for users following the tutorial, as they may unknowingly rely on a deprecated service.
Steps to Reproduce:
1. Navigate to the tutorial: [Semantic Search Tutorial](https://github.com/elastic/elasticsearch/issues/link-to-tutorial-page).
2. Observe that there is no mention of ELSER being deprecated.
3. Compare with the [ELSER documentation](https://github.com/elastic/elasticsearch/issues/link-to-elser-page), which clearly states the deprecation notice:
The ELSER service is deprecated as of version 8.16 and will be removed in a future release. Use the Elasticsearch inference service instead, with model_id included in service_settings.
Expected Behavior:
• The tutorial should clearly display a deprecation warning for the ELSER service.
• The warning should guide users to use the recommended Elasticsearch inference service with model_id in service_settings as an alternative.
Suggested Fix:
Deprecated in 8.16
The ELSER service used in this tutorial is deprecated and will be removed in a future release. Use the Elasticsearch inference service with model_id included in service_settings instead. Refer to the [ELSER documentation](https://github.com/elastic/elasticsearch/issues/link-to-elser-page) for details.
Metadata
Metadata
Assignees
Labels
:mlMachine learningMachine learning>docsGeneral docs changesGeneral docs changesTeam:DocsMeta label for docs teamMeta label for docs teamTeam:MLMeta label for the ML teamMeta label for the ML team