docs: add section for example configurations

Since ACLs may be at times a bit intransparent to a user, an example
section seems like a worthwhile addition.

Signed-off-by: Moritz Poldrack <git@moritz.sh>

docs/ref/acls.md

@@ -187,3 +187,29 @@ Here are the ACL's to implement the same permissions as above:
   ]
 }
 ```
+
+## Examples
+
+The following are examples of ready-to-use or -adapt snippets to use in your configuration.
+
+/// details | Full mesh
+
+This snippet allows all devices to access all other devices. It is the noop ACL.
+
+```json
+{
+  "acls": [
+    {
+      "action": "accept",
+      "src": [
+        "*"
+      ],
+      "dst": [
+        "*:*"
+      ]
+    }
+  ]
+}
+```
+
+///

mkdocs.yml

@@ -35,6 +35,7 @@ theme:
     # - navigation.tabs.sticky
     - navigation.top
     - navigation.tracking
+    - pymdownx.blocks.details
     - search.highlight
     - search.share
     - search.suggest
@@ -120,6 +121,7 @@ markdown_extensions:
       generic: true
   - pymdownx.betterem:
       smart_enable: all
+  - pymdownx.blocks.details
   - pymdownx.caret
   - pymdownx.details
   - pymdownx.emoji: