Shortened release notes

Author: Timovzl

DomainModeling/DomainModeling.csproj

@@ -54,50 +54,19 @@ Performance:
 - Enhancement: Reduced assembly size by having source-generated WrapperValueObject/Identity types use generic JSON serializers instead of generating their own.
 - Enhancement: Improved source generator performance.
 
-Misc improvements:
+Misc:
+- Semi-breaking: IFormattable & co for string wrappers have stopped treating null strings as "", as this could cover up mistakes instead of revealing them.
 - Semi-breaking: IIdentity now implements IWrapperValueObject.
-- Semi-breaking: I[Utf8][Span]Formattable implementations based on strings have stopped treating null strings as "", as this could cover up mistakes instead of revealing them.
-- Bug fix: Fixed a bug where source-generated records would always generate ToString()/Equals()/GetHashCode(), even if you wrote your own.
-- Bug fix: Fixed a bug where source-generated WrapperValueObject/Identity types would not recognize manual member implementations if they were explicit interface implementations.
-- Bug fix: Fixed a bug where the DummyBuilder generator struggled with nested types.
-- Bug fix: Fixed a bug where the analyzer would not properly warn that source generation on nested types is unsupported.
+- Feature: Non-generic Wrapper/Identity interfaces.
+- Feature: Analyzer warns when '==' or similar operator implicitly casts some IValueObject to something else. This avoids accidentally comparing unrelated types.
+- Fix: Fixed bug where source-generated records would always generate ToString()/Equals()/GetHashCode(), even if you wrote your own.
+- Fix: Fixed bug where source-generated Wrappers/Identities would not recognize manual member implementations if they were explicit interface implementations.
+- Fix: Fixed bug where DummyBuilder generator struggled with nested types.
+- Fix: Fixed bug where "no source generation on nested type" warning would not show.
+- Enhancement: Generated types now have the CompilerGeneratedAttribute.
+- Enhancement: Generated struct Wrappers/Identities now generate NULLABLE comparison operators, to circumvent counterintuitive lifting behavior.
 - Enhancement: Improved clarity of analyzer warnings, by stopping before subsequent problems occur.
 - Enhancement: Improved correctness of trimming.
-
-3.0.3:
-
-- Enhancement: Upgraded package versions.
-
-3.0.2:
-
-- Bug fix.
-
-3.0.1:
-
-- Bug fix.
-
-3.0.0:
-
-- BREAKING: Platform support: Dropped support for .NET 5.0 (EOL).
-- BREAKING: Marker attributes: [SourceGenerated] attribute is refactored into [Entity], [ValueObject], [WrapperValueObject<TValue>], etc. Obsolete marking helps with migrating.
-- BREAKING: DummyBuilder base class: The DummyBuilder<TModel, TModelBuilder> base class is deprecated in favor of the new [DummyBuilder<TModel>] attribute. Obsolete marking helps with migrating.
-- BREAKING: Private ctors: Source-generated ValueObject types now generate a private default ctor with [JsonConstructor], for logic-free deserialization. This may break deserialization if properties lack an init/set. Analyzer included.
-- BREAKING: Init properties: A new analyzer warns if a WrapperValueObject's Value property lacks an init/set, because logic-free deserialization then requires a workaround.
-- BREAKING: ISerializableDomainObject interface: Wrapper value objects and identities now require the new ISerializableDomainObject<TModel, TValue> interface (generated automatically).
-- Feature: Custom inheritance: Source generation with custom base classes is now easy, with marker attributes identifying the concrete types.
-- Feature: Optional inheritance: For source-generated value objects, wrappers, and identities, the base type or interface is generated and can be omitted.
-- Feature: DomainObjectSerializer (.NET 7+): The new DomainObjectSerializer type can be used to (de)serialize identities and wrappers without running any domain logic (such as parameterized ctors), and customizable per type.
-- Feature: Entity Framework mappings (.NET 7+): If Entity Framework is used, mappings by convention (that also bypass ctors) can be generated. Override DbContext.ConfigureConventions() and call ConfigureDomainModelConventions(). Its action param allows all identities, wrapper value objects, entities, and/or domain events to be mapped, even in a trimmer-safe way.
-- Feature: Miscellaneous mappings: Other third party components can similarly map domain objects. See the readme.
-- Feature: Marker attributes: Non-partial types with the new marker attributes skip source generation, but can still participate in mappings.
-- Feature: Record struct identities: Explicitly declared identity types now support "record struct", allowing their curly braces to be omitted: `public partial record struct GeneratedId;`
-- Feature: ValueObject validation helpers: Added ValueObject.ContainsNonPrintableCharactersOrDoubleQuotes(), a common validation requirement for proper names.
-- Feature: Formattable and parsable interfaces (.NET 7+): Generated identities and wrappers now implement IFormattable, IParsable<TSelf>, ISpanFormattable, and ISpanParsable<TSelf>, recursing into the wrapped type's implementation.
-- Feature: UTF-8 formattable and parsable interfaces (.NET 8+): Generated identities and wrappers now implement IUtf8SpanFormattable and IUtf8SpanParsable<TSelf>, recursing into the wrapped type's implementation.
-- Enhancement: JSON converters (.NET 7+): All generated JSON converters now pass through the new Serialize() and Deserialize() methods, for customizable and logic-free (de)serialization.
-- Enhancement: JSON converters (.NET 7+): ReadAsPropertyName() and WriteAsPropertyName() in generated JSON converters now recurse into the wrapped type's converter and also pass through the new Serialize() and Deserialize() methods.
-- Bug fix: IDE stability: Fixed a compile-time bug that could cause some of the IDE's features to crash, such as certain analyzers.
-- Minor feature: Additional interfaces: IEntity and IWrapperValueObject<TValue> interfaces are now available.
 		</Description>
 		<Copyright>The Architect</Copyright>
 		<Company>The Architect</Company>