Skip to content

Update semantic_text ingestion workflow and relocate advanced quantization content#5668

Draft
charlotte-hoblik wants to merge 6 commits intomainfrom
charlotte-semantic-search-semantic-text
Draft

Update semantic_text ingestion workflow and relocate advanced quantization content#5668
charlotte-hoblik wants to merge 6 commits intomainfrom
charlotte-semantic-search-semantic-text

Conversation

@charlotte-hoblik
Copy link
Copy Markdown
Contributor

@charlotte-hoblik charlotte-hoblik commented Mar 29, 2026

This PR significantly simplifies the beginner experience for the semantic_text tutorial and separates advanced cluster configuration into its own dedicated page.

  • Replaced legacy ingestion workflow (Addresses #3956): Removed the UI-based Data Visualizer upload and _reindex steps. Replaced them with a programmatic _bulk API call to simulate ingestion and inference simultaneously.

  • Relocated advanced content (Addresses #847): Extracted the highly technical "Optimizing vector storage with index_options" section (BBQ, DiskBBQ, quantization) from the beginner tutorial into a new, standalone page (vector-storage-for-semantic-search.md).

  • Added cross-linking: Added a note and a bullet point in the "Further reading" section to gracefully route advanced users to the new vector storage optimization page.

  • semantic-search-semantic-text.md → Tutorial: Updated the page and the frontmatter to match the tutorial content type.

  • vector-storage-for-semantic-search.md → How-to guide: Updated and restructured the page and the frontmatter to match the how-to content type.

Connected to: #3956, https://github.com/elastic/docs-content-internal/issues/847, https://github.com/elastic/docs-content-internal/issues/936

@charlotte-hoblik charlotte-hoblik self-assigned this Mar 29, 2026
@charlotte-hoblik charlotte-hoblik added the documentation Improvements or additions to documentation label Mar 29, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 31, 2026

@github-actions
Copy link
Copy Markdown
Contributor

✅ Vale Linting Results

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide.

To use Vale locally or report issues, refer to Elastic style guide for Vale.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant