From a8ef6f08e01000f2a4455cedf94dfd75b1d42915 Mon Sep 17 00:00:00 2001
From: Tamo <tamo@meilisearch.com>
Date: Tue, 7 Jan 2025 16:31:39 +0100
Subject: [PATCH] Update crates/meilisearch-types/src/settings.rs

Co-authored-by: Louis Dureuil <louis@meilisearch.com>
---
 crates/meilisearch-types/src/settings.rs | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/crates/meilisearch-types/src/settings.rs b/crates/meilisearch-types/src/settings.rs
index 2ecef9383..658d7eec4 100644
--- a/crates/meilisearch-types/src/settings.rs
+++ b/crates/meilisearch-types/src/settings.rs
@@ -147,6 +147,13 @@ impl MergeWithError<milli::CriterionError> for DeserrJsonError<InvalidSettingsRa
 #[derive(Default, Serialize, Deserialize, PartialEq, Eq, Clone, ToSchema)]
 #[repr(transparent)]
 #[serde(transparent)]
+/// "Technical" type that is required due to utoipa.
+///
+/// We did not find a way to implement [`utoipa::ToSchema`] for the [`Setting`] enum,
+/// but most types can use the `value_type` macro parameter to workaround that issue.
+///
+/// However that type is used in the settings route, including through the macro that auto-generate
+/// all the settings route, so we can't remap the `value_type`.
 pub struct SettingEmbeddingSettings {
     #[schema(inline, value_type = Option<crate::milli::vector::settings::EmbeddingSettings>)]
     pub inner: Setting<crate::milli::vector::settings::EmbeddingSettings>,