From 5d8ff27709ee7c215dd45e4fe6ba7e632cba873c Mon Sep 17 00:00:00 2001
From: jorenham <jhammudoglu@gmail.com>
Date: Sat, 7 Sep 2024 01:24:25 +0200
Subject: [PATCH 1/3] replace the `optype` slogan (woops)  with something more
 appropriate

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index e500698a..41395642 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 <h1 align="center">scipy-stubs</h1>
 
 <p align="center">
-    Building blocks for precise & flexible type hints.
+    Type stubs for <a href="https://github.com/scipy/scipy">SciPy</a>.
 </p>
 
 <p align="center">

From a227bbbd45b17445a02a7f684b23b051e155fa7b Mon Sep 17 00:00:00 2001
From: jorenham <jhammudoglu@gmail.com>
Date: Sat, 7 Sep 2024 01:36:33 +0200
Subject: [PATCH 2/3] explain why it's probably fine to start using
 `scipy-stubs` already

---
 README.md | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 41395642..f975ebc7 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,13 @@
 
 ---
 
+> [!NOTE]
+> This project is in the alpha stage, so some annotations are missing, and some might
+> be (slightly) incorrect.
+> But either way, it's no problem to `scipy-stubs` at the moment:
+> Type-checkers will (already) understand `scipy` a lot better *with* `scipy-stubs`,
+> than without it.
+
 ## Installation
 
 The `scipy-stubs` package is available as on PyPI:
@@ -74,9 +81,6 @@ The `scipy-stubs` package is available as on PyPI:
 pip install scipy-stubs
 ```
 
-> [!IMPORTANT]
-> This project is in the early development stage, and is not ready for production use.
-
 ## Development Progress
 
 | Package or module                 | Stubs status    |

From a4c9bc287021857e693dd8108366750995239e09 Mon Sep 17 00:00:00 2001
From: jorenham <jhammudoglu@gmail.com>
Date: Sat, 7 Sep 2024 01:56:54 +0200
Subject: [PATCH 3/3] add a readme section about version compatibility

---
 README.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/README.md b/README.md
index f975ebc7..15b45b5f 100644
--- a/README.md
+++ b/README.md
@@ -81,6 +81,27 @@ The `scipy-stubs` package is available as on PyPI:
 pip install scipy-stubs
 ```
 
+## Version Compatibility
+
+### Type-checkers
+
+For validation and testing, `scipy-stubs` primarily uses
+[`basedmypy`](https://github.com/KotlinIsland/basedmypy) (a `mypy` fork) and
+[`basedpyright`](https://github.com/DetachHead/basedpyright) (a `pyright` fork).
+Because they are in generally stricter than `mypy` and `pyright`, they should be
+compatible as well.
+If you find that this is not the case, then don't hesitate to open an issue.
+
+### Required dependencies
+
+The versioning scheme of `scipy-stubs` includes the compatible `scipy` version.
+Later versions might work too, but in case of API-changes, the stubs could be outdated.
+
+Apart from `scipy`'s own dependencies (e.g. `numpy`), the only other
+required dependency is [`optype`](https://github.com/jorenham/optype).
+
+The exact version requirements are specified in the [`pyproject.toml`](pyproject.toml).
+
 ## Development Progress
 
 | Package or module                 | Stubs status    |