diff --git a/thoughts.md b/thoughts.md
index ffe9c04d..6ac27c32 100644
--- a/thoughts.md
+++ b/thoughts.md
@@ -56,4 +56,16 @@ Here's how k3d types should translate to a runtime type:
 - Args    -> 
 - Ports   -> 
 - Restart -> 
-- Labels  -> container.Labels
\ No newline at end of file
+- Labels  -> container.Labels
+
+## expose ports / volumes
+
+- `--port [host:]port[:containerPort][/protocol][@group_identifier[[index] | @node_identifier]`
+  - Examples:
+    - `--port 0.0.0.0:8080:8081/tcp@workers` -> whole group
+    - `--port 80@workers[0]` -> single instance of group by list index
+    - `--port 80@workers[0,2-3]` -> multiple instances of a group by index lists and ranges
+    - `--port 80@k3d-test-worker-0` -> single instance by specific node identifier
+    - `--port 80@k3d-test-master-0@workers[1-5]` -> multiple instances by combination of node and group identifiers
+
+- analogous for volumes