.

2 files changed, 8 insertions, 0 deletions

diff --git a/linux/vocabulary.md b/linux/vocabulary.md
index 1356d1d0..6348ed10 100644
--- a/linux/vocabulary.md
+++ b/linux/vocabulary.md
@@ -2,6 +2,10 @@
 
 ### Data Structures
 
+For memory safety, the following data structures are opaque and only modified
+using functions described further down. I still find it useful to understand
+how they work under the hood.
+
 - Handles: addresses to objects allocated on the heap. They're augmented with
   book-keeping to guarantee memory-safety, and so cannot be stored in registers.
   See [mu.md](mu.md) for details, but in brief:
diff --git a/vocabulary.md b/vocabulary.md
index 9471d132..1ecbdf8d 100644
--- a/vocabulary.md
+++ b/vocabulary.md
@@ -2,6 +2,10 @@
 
 ### Data Structures
 
+For memory safety, the following data structures are opaque and only modified
+using functions described further down. I still find it useful to understand
+how they work under the hood.
+
 - Handles: addresses to objects allocated on the heap. They're augmented with
   book-keeping to guarantee memory-safety, and so cannot be stored in registers.
   See [mu.md](mu.md) for details, but in brief: