Skip to content

IBX-11003: Describe taxonomy suggestions in developer doc - #2964

Merged
mnocon merged 12 commits into
5.0from
IBX-11003
Dec 10, 2025
Merged

mnocon merged 12 commits into
5.0from
IBX-11003

Conversation

@dabrt

@dabrt dabrt commented Nov 28, 2025

Copy link
Copy Markdown
Contributor
Question Answer
JIRA Ticket IBX-11003
Versions 4.6, 5.0
Edition all

Describe taxonomy suggestions LTS update in developer doc

Checklist

  • Text renders correctly
  • Text has been checked with vale
  • Description metadata is up to date
  • Redirects cover removed/moved pages
  • Code samples are working
  • PHP code samples have been fixed with PHP CS fixer
  • Added link to this PR in relevant JIRA ticket or code PR

@github-actions

Copy link
Copy Markdown

Preview of modified files

Preview of modified Markdown:

@dabrt
dabrt changed the base branch from 5.0 to 4.6 December 1, 2025 15:18
@dabrt
dabrt changed the base branch from 4.6 to 5.0 December 1, 2025 15:21
Comment on lines +125 to +126
- when the database is reindexed, for example, after you enable the feature
- when an individual taxonomy entry is created or modified, it's embedding is updated

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The feature needs to be enabled for both

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The first sentence says exactly that.
Here, we are stressing that right after you enable the feature, you trigger the reindex and that's when the embeddings are calculated for the first time.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok, for me it was like two cases. In the first case, we need to enable the feature. In the second, we have no information on whether it should be enabled or not. When an individual taxonomy entry is created or modified, then embedding will be calculated only when the feature is enabled.

Comment thread docs/content_management/taxonomy/taxonomy.md Outdated
Comment thread docs/content_management/taxonomy/taxonomy.md Outdated
Comment thread docs/content_management/taxonomy/taxonomy.md Outdated
dabrt and others added 2 commits December 3, 2025 14:41
Co-authored-by: Mikolaj Adamczyk <mikadamczyk@gmail.com>
This way you can limit field selection to meaningful text fields and avoid unsupported field types.
Like in the case of the number of suggestions, you can override this setting per AI action by editing its configuration.

### Change the embedding generation model

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It needs to be mentioned that suggestions are less precise the more data is in the input. But maybe it is already mentioned in manuals of models that we are suggesting 🤔

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added tip in cd0a9ec

@mnocon mnocon added Wait with merge PRs that shouldn't be merged instantly Ready for MERGE and removed Needs DEV review labels Dec 4, 2025
@mnocon
mnocon merged commit 5e5b98e into 5.0 Dec 10, 2025
7 checks passed
@mnocon
mnocon deleted the IBX-11003 branch December 10, 2025 12:00
mnocon added a commit to mnocon/documentation-developer that referenced this pull request Dec 10, 2025
* IBX-11003: Describe taxonomy suggestions in developer doc

* IBX-11002: Configure Taxonomy suggestions

* Fix broken links

* Add default fields to configuration

* Remove the mention of KNN, which comes as default in Solr 9.

* Fix a link that leads to user documentation

* Apply suggestions from code review

Co-authored-by: Mikolaj Adamczyk <mikadamczyk@gmail.com>

* Review suggestions

* Reworded example

* Added tip

* Added ibexa_richtext field

* Fixed highlight

---------

Co-authored-by: Mikolaj Adamczyk <mikadamczyk@gmail.com>
Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com>
mnocon added a commit that referenced this pull request Dec 10, 2025
* IBX-11003: Describe taxonomy suggestions in developer doc

* IBX-11002: Configure Taxonomy suggestions

* Fix broken links

* Add default fields to configuration

* Remove the mention of KNN, which comes as default in Solr 9.

* Fix a link that leads to user documentation

* Apply suggestions from code review

Co-authored-by: Mikolaj Adamczyk <mikadamczyk@gmail.com>

* Review suggestions

* Reworded example

* Added tip

* Added ibexa_richtext field

* Fixed highlight

---------

Co-authored-by: Mikolaj Adamczyk <mikadamczyk@gmail.com>
Co-authored-by: Marek Nocoń <mnocon@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Ready for MERGE Wait with merge PRs that shouldn't be merged instantly

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants