add logging policy documentation

README.md

@@ -143,6 +143,15 @@ cast send \
  0x3fAB184622Dc19b6109349B94811493BF2a45362
 ```
 
+## Documentation
+
+See the [doc index](/docs/README.md).
+
+- [OP Stack Primer](/docs/opstack.md)
+- [Port Configuration](/docs/port-config.md)
+- [Vocabulary](/docs/vocabulary.md)
+- [Logging Policy](/docs/logging.md)
+
 
 ## Contributing (for developers building simple-op-stack rollup)
 

docs/README.md

@@ -0,0 +1,8 @@
+# roll-op Documentation
+
+First, read the [top-level README](/README.md).
+
+- [OP Stack Primer](/docs/opstack.md)
+- [Port Configuration](/docs/port-config.md)
+- [Vocabulary](/docs/vocabulary.md)
+- [Logging Policy](/docs/logging.md)

docs/logging.md

@@ -0,0 +1,27 @@
+# Logging Policy
+
+The default logging policy for services (process that are supposed to keep running) is to rotate the
+logs once they reach 3M in size. This can be configured via the `logrotate_max_size` option (takes a
+number followed by a `k`/`M`/`G` suffix).
+
+The logs are rotated up to 300 times (accounted separately per log file) before the oldest rotations
+are removed. Rotations older than 14 days are also removed. This can be configured via the
+`logrotate_count` and `logrotate_max_days` options.
+
+Finally, you can override settings for individual log files. This is done by specifying logrotate
+commands directly (cf. [manpage]). Here's an example of how you can do this:
+
+```toml
+# at BOTTOM of the file
+[logrotate_overrides]
+"l1_node.log" = [
+ "size 1M",
+ "rotate 10",
+]
+"l2_node.log" = [
+ "size 300k",
+ "nocompress",
+]
+```
+
+[manpage]: https://linux.die.net/man/8/logrotate