Integrations compatibility info

Author: p1c2u

README.md

@@ -38,6 +38,20 @@ and [OpenAPI v3.1](https://github.com/OAI/OpenAPI-Specification/blob/main/versio
 
 Check documentation to see more details about the features. All documentation is in the "docs" directory and online at [openapi-core.readthedocs.io](https://openapi-core.readthedocs.io)
 
+## Integrations compatibility matrix
+
+Supported [Integrations](https://openapi-core.readthedocs.io/en/latest/integrations.html) and it's versions:
+
+| Integration | Version(s) |
+| --- | --- |
+| AIOHTTP | versions 3.8+ and 3.11+ tracks |
+| Django | versions 4 and 5 |
+| Falcon | version 4 |
+| FastAPI | versions 0.11x and 0.12x |
+| Flask | versions 2 and 3 |
+| Requests | default dependency set |
+| Starlette | versions 0.4x and 0.5x |
+| Werkzeug | default dependency set |
 
 ## Installation
 

docs/contributing.md

@@ -71,3 +71,16 @@ pre-commit run --all-files
 ```
 
 Pre-commit check results are also attached to your PR through integration with GitHub Actions.
+
+### Integration compatibility matrix
+
+Contrib integrations are tested in CI against framework version variants and
+Python versions. The matrix source of truth is:
+
+- `.github/workflows/integration-tests.yml`
+
+When changing integration compatibility, update both:
+
+- dependency constraints in `pyproject.toml`
+- integration variants in `.github/workflows/integration-tests.yml`
+- information in `docs/integrations` and `README.md`

docs/integrations/aiohttp.md

@@ -1,6 +1,6 @@
 # aiohttp.web
 
-This section describes integration with [aiohttp.web](https://docs.aiohttp.org/en/stable/web.html) framework.
+This section describes integration with [aiohttp.web](https://docs.aiohttp.org/en/stable/web.html) framework. The integration supports aiohttp version 3.8+.
 
 ## Low level
 

docs/integrations/django.md

@@ -1,7 +1,7 @@
 # Django
 
 This section describes the integration with the [Django](https://www.djangoproject.com) web framework.
-The integration supports Django version 3.0 and above.
+The integration supports Django version 4 and 5.
 
 ## Middleware
 

docs/integrations/falcon.md

@@ -1,7 +1,7 @@
 # Falcon
 
 This section describes the integration with the [Falcon](https://falconframework.org) web framework.
-The integration supports Falcon version 3.0 and above.
+The integration supports Falcon version 4.
 
 !!! warning
 

docs/integrations/fastapi.md

@@ -1,6 +1,6 @@
 # FastAPI
 
-This section describes integration with [FastAPI](https://fastapi.tiangolo.com) ASGI framework.
+This section describes integration with [FastAPI](https://fastapi.tiangolo.com) ASGI framework. The integration supports FastAPI versions 0.11x and 0.12x.
 
 !!! note
 

docs/integrations/flask.md

@@ -1,6 +1,6 @@
 # Flask
 
-This section describes integration with the [Flask](https://flask.palletsprojects.com) web framework.
+This section describes integration with the [Flask](https://flask.palletsprojects.com) web framework. The integration supports Flask versions 2 and 3.
 
 ## View decorator
 

docs/integrations/starlette.md

@@ -1,6 +1,6 @@
 # Starlette
 
-This section describes integration with the [Starlette](https://www.starlette.io) ASGI framework.
+This section describes integration with the [Starlette](https://www.starlette.io) ASGI framework. The integration supports Flask versions 0.4x and 0.5x.
 
 ## Middleware