Explain why

modmuss50 · Dec 5, 2024 · 71c662b · 71c662b
1 parent 1a325e1
commit 71c662b
Showing 1 changed file with 2 additions and 1 deletion.
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -99,7 +99,8 @@ Fabric API makes strong backwards compatibility guarantees, by which contributor
     - If vanilla exposes optionals in return types, then returning an optional is fine.
 - Avoid requiring the user to cast to a subtype if possible.
     - Adding methods to vanilla types can be done via interface injection.
-- Avoid exposing java `records` as public API
+- Avoid exposing java `records` as public API.
+    - Records expose more than is necessary for most APIs, which makes them difficult to evolve.
     - Prefer to expose an interface that is implemented by an impl record.
 
 ### API design patterns to consider