docs(settings): state the direction of the period mistake plainly

Greptile read the warning as reversing the effect: it said a window written in
seconds is tighter, without saying which side gets tighter. It now says the
value is read as 60 ms, the window shrinks a thousandfold, and the limit becomes
stricter - the same sentence in the type and in default-settings.yaml.

Author: chappie-daemon

resources/default-settings.yaml

@@ -216,9 +216,13 @@ eventStore:
 dvm:
   workers: []
 limits:
-  # Every `period` below is in milliseconds. `period: 60` would be a 60 ms
-  # window and is not rejected, because 60 is a valid count of milliseconds.
-  # See RateLimit in src/@types/settings.ts.
+  # Every `period` below is a count of milliseconds. `period: 60`, written as if
+  # it meant 60 seconds, is read as 60 ms: the window shrinks a thousandfold, so
+  # the limit becomes a thousand times stricter than the author meant. Nothing
+  # rejects it, because 60 is a valid count of milliseconds. The unit cannot be
+  # inferred from the number, so it is stated here and on RateLimit in
+  # src/@types/settings.ts.
+  #
   # strategy selection configuration for rate limiting:
   rateLimiter:
     strategy: ewma

src/@types/settings.ts

@@ -28,10 +28,11 @@ export interface RateLimit {
    * Length of the window in milliseconds.
    *
    * Every shipped limit counts this way (`1000`, `60000`, `900000`, `3600000`),
-   * so `period: 60` asks for a 60 ms window: a thousand times tighter than a
-   * minute, and the relay honours it without complaint. Nothing can tell the
-   * two apart from the number alone, so the unit is documented where the value
-   * is set. The validator rejects anything that is not a whole count of
+   * so `period: 60`, written as if it meant 60 seconds, is read as a 60 ms
+   * window and makes the limit a thousand times stricter than intended. The
+   * relay honours it without complaint, and nothing can tell the two apart from
+   * the number alone, which is why the unit is documented where the value is
+   * set. The validator rejects anything that is not a whole count of
    * milliseconds, at least one.
    */
   period: number