Clarify analysis plugin support and custom dictionary limitations#6666
Clarify analysis plugin support and custom dictionary limitations#6666yetanothertw wants to merge 3 commits into
Conversation
Elastic Docs AI PR menuCheck the box to run an AI review for this pull request.
Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team. |
Vale Linting ResultsSummary: 1 warning found
|
| File | Line | Rule | Message |
|---|---|---|---|
| deploy-manage/deploy/elastic-cloud/upload-custom-plugins-bundles.md | 22 | Elastic.BritishSpellings | Use American English spelling 'among' instead of British English 'amongst'. |
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.
|
I tried listing all the differences in the Notes section of the plugins row, and this is what it looks like. IMO, it didn't make the distinction clear enough at-a-glance (someone pay perceive the checkmark covers everything): 
This is what the preview looks like now: |
| | [**Search applications**](/solutions/elasticsearch-solution-project/search-applications.md) | - UI and APIs <br>- Maintenance mode (beta) | - API-only <br>- Maintenance mode (beta) | UI not available in Serverless | | ||
| | **Shard management** | User-configurable | Managed by Elastic | No manual shard allocation in Serverless | | ||
| | [**Synonyms**](/solutions/search/full-text/search-with-synonyms.md) | - Index time synonyms <br>- File-based synonyms <br>- Synonyms API | Synonyms API only (does not support index-time or file-based synonyms) | | | ||
| | [**Synonyms**](/solutions/search/full-text/search-with-synonyms.md) | - Index time synonyms <br>- File-based synonyms <br>- Synonyms API | [Synonyms API]({{es-apis}}group/endpoint-synonyms) only (does not support index-time or file-based synonyms) | | |
There was a problem hiding this comment.
I wonder if we should be linking to the Serverless API docs for the synonym endpoint instead of the Elasticsearch API docs?
1 participant
Summary
Fixes #6449 and adds the following:
On
deploy-manage/deploy/elastic-cloud/differences-from-other-elasticsearch-offerings.md, updates the existingCustom plugins and bundlesrow, but instead of updating the Notes column as suggested in the issue, I've used some of the pattern from theNetwork securityrow ( which includes a parallel itemized lists in both deployment columns with per-item). The Serverless row now clarifies the options that are available and the ones that are not. Also, added info in the Notes column for the synonyms API. Since we already have aSynonymsrow, I've updated that with the link to the Synonyms API. I wonder if we should be linking to the Serverless API docs for the synonym endpoint instead of the Elasticsearch API docs?On
deploy-manage/deploy/elastic-cloud/upload-custom-plugins-bundles.md, I've added a new note to directing Serverless users to the synonym API for synonym management.Also closes #551
Somewhat related to #1075
Generative AI disclosure
Used the Auto agent mode in Cursor to find other pages that describe language-specific text analysis capabilities in Elasticsearch and compare that with the Serverless guidance I've added (to make sure no contradictions exist in the docset).