docs: native enum rs_type = "Enum" breaking change in 2.0

SeaORM/docs/04-generate-entity/04-enumeration.md

@@ -88,7 +88,7 @@ pub enum Color {
 
 ```rust
 #[derive(EnumIter, DeriveActiveEnum)]
-#[sea_orm(rs_type = "String", db_type = "Enum", enum_name = "tea")]
+#[sea_orm(rs_type = "Enum", db_type = "Enum", enum_name = "tea")]
 pub enum Tea {
     #[sea_orm(string_value = "EverydayTea")]
     EverydayTea,
@@ -97,6 +97,41 @@ pub enum Tea {
 }
 ```
 
+:::tip Since `2.0.0`
+Native database enums now use `rs_type = "Enum"` (previously `rs_type = "String"`). This is a breaking change from SeaORM 1.x.
+
+The associated `ActiveEnum::Value` type is [`sea_query::Enum`](https://docs.rs/sea-query/1/sea_query/struct.Enum.html) instead of `String`, so that the value can carry the enum's type name as metadata. As a result, [`to_value`](https://docs.rs/sea-orm/2/sea_orm/entity/trait.ActiveEnum.html#tymethod.to_value) returns a `sea_query::Enum`, and [`try_from_value`](https://docs.rs/sea-orm/2/sea_orm/entity/trait.ActiveEnum.html#tymethod.try_from_value) expects a `&sea_query::Enum`.
+
+The `sea_query::Enum` struct is:
+
+```rust
+pub struct Enum {
+    pub type_name: EnumTypeName, // RcOrArc<str>
+    pub value: Cow<'static, str>,
+}
+```
+
+To convert a native enum variant **to** a `String`, read the `value` field:
+
+```rust
+let s: String = tea.to_value().value.into();
+```
+
+To convert a `String` **into** a native enum variant, construct a `sea_query::Enum` first:
+
+```rust
+use sea_orm::sea_query;
+
+let value = sea_query::Enum {
+    type_name: Tea::name().inner().into(),
+    value: input_string.into(),
+};
+let tea = Tea::try_from_value(&value)?;
+```
+
+String-backed (`rs_type = "String"`) and integer-backed (`rs_type = "i32"`) enums are unaffected: their `Value` type remains `String` / `i32`.
+:::
+
 ### MySQL
 
 MySQL enum is just part of the column definition, and cannot be reused for different tables.
@@ -142,7 +177,7 @@ manager
 
 ```rust
 #[derive(EnumIter, DeriveActiveEnum)]
-#[sea_orm(rs_type = "String", db_type = "Enum", enum_name = "tea")]
+#[sea_orm(rs_type = "Enum", db_type = "Enum", enum_name = "tea")]
 pub enum Tea {
     #[sea_orm(string_value = "EverydayTea")]
     EverydayTea,

SeaORM/docs/09-schema-statement/02-create-enum.md

@@ -112,7 +112,7 @@ pub struct Model {
 }
 
 #[derive(Debug, Clone, PartialEq, Eq, EnumIter, DeriveActiveEnum)]
-#[sea_orm(rs_type = "String", db_type = "Enum", enum_name = "tea")]
+#[sea_orm(rs_type = "Enum", db_type = "Enum", enum_name = "tea")]
 pub enum Tea {
     #[sea_orm(string_value = "EverydayTea")]
     EverydayTea,
@@ -121,7 +121,11 @@ pub enum Tea {
 }
 ```
 
-Note the `db_type` and extra `enum_name` attributes.
+Note the `rs_type = "Enum"`, `db_type = "Enum"` and extra `enum_name` attributes.
+
+:::tip Since `2.0.0`
+Native database enums use `rs_type = "Enum"` (previously `rs_type = "String"`). See [ActiveEnum → Native Database Enum](../04-generate-entity/04-enumeration.md#native-database-enum) for details on the new `sea_query::Enum` value type.
+:::
 
 ### PostgreSQL