@@ -0,0 +1,35 @@
+# modern-di-aiohttp 3.1.1 — documentation catches up with modern-di 3.1
+
+**No code changes.** The installed package is byte-identical to 3.1.0; nothing
+in `modern_di_aiohttp/` moved. This release exists to publish the corrected
+documentation, because the README a user reads on PyPI is rendered from the
+released distribution — so the fix below was invisible until now.
+
+## Fix
+
+- **The documented setup no longer passes `validate=True`.** modern-di 3.1 made
+  `Container(validate=...)` a deprecated no-op that emits
+  `ValidateArgumentWarning`. The README example therefore emitted a
+  `DeprecationWarning` on every construction, and — more quietly — silently
+  stopped validating anything, because that argument *was* the explicit opt-in
+  to graph validation. This package pins `modern-di>=3`, so users reached that
+  state on a routine upgrade.
+
+  The docs now build the container plain and call `container.validate()`
+  explicitly, after `setup_di`. That ordering matters and is unchanged:
+  `setup_di` registers this integration's providers, so validating first fails
+  any provider with a non-optional dependency on them.
+
+## Downstream
+
+Nothing is required of you. If you copied the old README snippet, drop
+`validate=True` — it does nothing on modern-di 3.1 and warns:
+
+```python
+container = Container(groups=[Dependencies])
+setup_di(...)
+container.validate()  # optional fail-fast, after setup_di registers its providers
+```
+
+Keeping it works, but a suite configured with `error::DeprecationWarning` will
+fail on it. The argument is removed in modern-di 4.0.