Add further admonition about mixin back compat

smithy-lang · Jan 20, 2022 · 7e9329b · 7e9329b
1 parent 16a6059
commit 7e9329b
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/docs/source/1.0/spec/core/model.rst b/docs/source/1.0/spec/core/model.rst
@@ -2998,6 +2998,11 @@ runtime polymorphism for types generated from Smithy models. Smithy model
 transformations like code generation or converting to other model formats
 like OpenAPI SHOULD completely elide mixins by flattening the model.
 
+It is a backward compatible change to remove a mixin from a shape as long as
+equivalent traits and members of the mixin are applied directly to the shape.
+Such a change should have no impact on generated artifacts like code or
+OpenAPI models.
+
 
 Mixins cannot be referenced other than as mixins to other shapes
 ================================================================