diff --git a/rtl/l2mc/readme.md b/rtl/l2mc/readme.md
index cca70d3..5c3d920 100644
--- a/rtl/l2mc/readme.md
+++ b/rtl/l2mc/readme.md
@@ -1,10 +1,14 @@
 # L2 Multicore
 
-* WB bridge for multiple cores
+* Multicore bridge to WB
 
-   * generate 1-4 core interfaces (slave WB-I, slave WB-D, OPMC extension (opcode/WIMG/...))
+   * generate 1-4 core interfaces (possibly mixed)
 
-   * configurable load and store queues per interface (if pipelined buses)
+      * slave WB-I, slave WB-D, OPMC extension (opcode/WIMG/...)
+
+      * a2i/a2o out-of-order/credits/... style
+
+   * configurable load and store queues per interface (if pipelined/credited interfaces)
 
    * point-of-coherency/snoop/sync/... logic
 
diff --git a/rtl/noc/readme.md b/rtl/noc/readme.md
new file mode 100644
index 0000000..5314f29
--- /dev/null
+++ b/rtl/noc/readme.md
@@ -0,0 +1,9 @@
+# Network-on-chip
+
+* serial interface (configurable width) for
+
+   * core-core message passing
+
+   * high-level signal passing (config/mode/status/...), debug, other sideband info
+
+