zhiqiang-hhhh opened a new pull request, #3458:
URL: https://github.com/apache/doris-website/pull/3458
## Summary
This PR adds a new practical ANN vector-search handbook to Apache Doris
docs, based on the provided "Apache Doris 向量索引实用手册" content, and wires it into
both current and 4.x documentation trees.
## User Impact
Users now have a single hands-on guide for end-to-end ANN operations,
including:
- prerequisites and table constraints,
- table/index creation patterns,
- loading and index build workflows,
- TopN/range/filter query patterns,
- tuning checklist (`hnsw_ef_search`, `nprobe`, scan parallelism),
- troubleshooting and hybrid search practices.
The guide is available for:
- current docs (EN + ZH)
- versioned 4.x docs (EN + ZH)
## Root Cause
Existing vector-search docs covered algorithm details and performance data,
but lacked one consolidated operational handbook that walks through the
complete production workflow from schema to diagnostics.
## Changes
- Added practical guide doc (current EN):
- `docs/ai/vector-search/practical-guide.md`
- Added practical guide doc (current ZH):
-
`i18n/zh-CN/docusaurus-plugin-content-docs/current/ai/vector-search/practical-guide.md`
- Added practical guide doc (4.x EN):
- `versioned_docs/version-4.x/ai/vector-search/practical-guide.md`
- Added practical guide doc (4.x ZH):
-
`i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/ai/vector-search/practical-guide.md`
- Updated sidebars:
- `sidebars.ts`: add `ai/vector-search/practical-guide`
- `versioned_sidebars/version-4.x-sidebars.json`: add
`ai/vector-search/practical-guide`
## Validation
- Verified new files are in expected current/4.x and i18n locations.
- Verified sidebar entries are present in both current and 4.x sidebars.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
