diff --git a/.forgejo/workflows/test.yml b/.forgejo/workflows/test.yml
index 1a7a6f89..fb057905 100644
--- a/.forgejo/workflows/test.yml
+++ b/.forgejo/workflows/test.yml
@@ -1,5 +1,8 @@
 name: test
 
+# Lint + short unit tests only. Integration tests needing Postgres/ffmpeg
+# run locally via docker-compose; they should guard with testing.Short().
+
 on:
   push:
     branches: [dev]