From b0b18abff79ee84245acfe7f834f7ff96d4fbb0e Mon Sep 17 00:00:00 2001
From: Alex Fedoseev <alex@35mil.me>
Date: Tue, 18 Jun 2024 17:08:48 +0400
Subject: [PATCH] Disable Windows build on CI and add note to README

---
 .github/workflows/ci.yml | 2 +-
 README.md                | 3 +++
 src/lib.rs               | 6 ++++++
 3 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index e0ab1fc..c66f49b 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -11,7 +11,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        os: [ ubuntu-latest, macOS-latest, windows-latest ]
+        os: [ ubuntu-latest, macOS-latest ] # windows build is broken, see the note in README
     steps:
       - name: Checkout sources
         uses: actions/checkout@v2
diff --git a/README.md b/README.md
index 9604782..229a3e7 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,9 @@ See [docs.rs/steward](https://docs.rs/steward).
 See [`examples`](./examples).
 
 ## Limitations
+### Windows
+Apparently, Windows build is broken on recent versions of Rust due to [`winapi`](https://github.com/retep998/winapi-rs) being unmaintained. We need to migrate to [`windows-rs`](https://github.com/microsoft/windows-rs), but I don't know anything about Windows, so help is very welcome!
+
 ### Async runtimes
 Tokio only.
 
diff --git a/src/lib.rs b/src/lib.rs
index af38590..53dd98e 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -78,6 +78,12 @@
 //! ```
 //!
 //! ## Limitations
+//! ### Windows
+//! Apparently, Windows build is broken on recent versions of Rust due to
+//! [`winapi`](https://github.com/retep998/winapi-rs) being unmaintained.
+//! We need to migrate to [`windows-rs`](https://github.com/microsoft/windows-rs),
+//! but I don't know anything about Windows, so help is very welcome!
+//!
 //! ### Async runtimes
 //! Tokio only.