docs & taskfile

Taskfile.yml

@@ -211,10 +211,8 @@ tasks:
     cmds:
       # Only delete unreferenced snapshots on the default target — lots are
       # excluded under wasm. Note that this will also over-delete on Windows.
-      - cargo insta test --accept --unreferenced=auto
+      - cargo insta test --accept --features=test-dbs --unreferenced=auto
       - cargo insta test --accept --target=wasm32-unknown-unknown
-      # We build the book too, because that acts as a test
-      - cd web/book && mdbook build
 
   test-rust-fast:
     desc: Test prql-compiler's unit tests.

web/book/src/contributing/development.md

@@ -298,7 +298,8 @@ inconsistent in watchexec. Let's revert back if it gets solved.
 
 - **[Integration tests](https://github.com/PRQL/prql/blob/main/prql-compiler/tests/integration)**
   — we run tests with example queries against real databases to ensure we're
-  producing correct SQL.
+  producing correct SQL. These can be run locally with
+  `cargo test --features=test-dbs`.
 
 - **[GitHub Actions on every commit](https://github.com/PRQL/prql/blob/main/.github/workflows/pull-request.yaml)**
   — we run the tests described up to this point on every commit to a pull