Record the platform flags that were only in conversation

Development and testing are Windows-only, so anything unverified elsewhere needs to be written down or it gets assumed to work. Several of these have already cost time once: PostgreSQL 18 moving its data directory silently gives a carried-over compose file an empty volume, and a loopback-bound Tomcat beat Docker's 0.0.0.0 publish for `localhost`, making every Keycloak realm 404 while the container looked healthy. The largest entry is the Avalonia WebView on Linux, which remains the biggest risk in the plan and is why the terminal sits behind ITerminalHost. Also records two things this milestone deliberately left undone -- no rate limiting on the enrollment and sync write paths until M2, and /me not touching last_seen_at_utc -- so neither reads later as an oversight.
2026-07-28 16:08:04 +02:00
parent a628762cd1
commit b7325b78ca
2 changed files with 97 additions and 0 deletions
@@ -70,6 +70,11 @@ dotnet run --project src/DodoSSH.Api
 It listens on `http://localhost:5233`, serving `/healthz/live`, `/healthz/ready` and — in
 Development — `/openapi/v1.json`.

+Development and testing are currently **Windows-only**. Anything known or suspected to differ on
+Linux and macOS is tracked in [`docs/platform-flags.md`](docs/platform-flags.md), along with the
+deployment gotchas that have already cost time once. Read it before assuming something works
+off-Windows.
+
 ### Conventions the build enforces

 - Warnings are errors. `dotnet format --verify-no-changes` gates CI.