diff --git a/docs/makefile b/docs/makefile
index 2ae0cfbe4..ea696ab49 100644
--- a/docs/makefile
+++ b/docs/makefile
@@ -114,7 +114,7 @@ ifneq ($(STAGE),)
 endif
 
 %.png:%.diagram
-	aafigure -o $@ $?
+	aafigure --scale 0.6 -o $@ $?
 ifneq ($(STAGE),)
 	cp $@ $(WEB_PATH)/$@
 endif
diff --git a/docs/read_disk_buffers.png b/docs/read_disk_buffers.png
index 80862a514..2c7edeee2 100644
Binary files a/docs/read_disk_buffers.png and b/docs/read_disk_buffers.png differ
diff --git a/docs/storage.png b/docs/storage.png
index e4207ef37..14f79370a 100644
Binary files a/docs/storage.png and b/docs/storage.png differ
diff --git a/docs/write_disk_buffers.diagram b/docs/write_disk_buffers.diagram
index 4f2326ef8..24a3aa7cc 100644
--- a/docs/write_disk_buffers.diagram
+++ b/docs/write_disk_buffers.diagram
@@ -1,15 +1,15 @@
 
-                   decrypt in place                move buffer ref.
-+----------------+ (no copy)        +------------+ (no copy)         +------------+
-| receive buffer +--=-------------->| plain text +--=--------------->| disk cache |
-+----------------+                  | buffer     |                   +------+-----+
-        ^                           +------------+                          |
-        | read() on socket                                 write() to file  | 
-        | (copy)                                           (copy)           | 
+                     "decrypt in place"              "move buffer ref."
++------------------+ "(no copy)"    +--------------+ "(no copy)"     +--------------+
+| "receive buffer" +--=------------>| "plain text" +--=------------->| "disk cache" |
++------------------+                | "buffer"     |                 +------+-------+
+        ^                           +--------------+                        |
+        | "read() on socket"                              "write() to file" |
+        | "(copy)"                                        "(copy)"          |
 ---=----|---------------------------------=---------------------------------|--=----
-        |                        kernel space                               |
+        |                       "kernel space"                              |
         |                                                                   v
-+-------+--------+                                               +-------------------+
-| socket kernel  |                                               | kernel page cache |
-| buffer         |                                               |                   |
-+----------------+                                               +-------------------+
++-------+---------+                                           +---------------------+
+| "socket kernel" |                                           | "kernel page cache" |
+| "buffer"        |                                           |                     |
++-----------------+                                           +---------------------+
diff --git a/docs/write_disk_buffers.png b/docs/write_disk_buffers.png
index ccaf85a2a..92d1e3a6b 100644
Binary files a/docs/write_disk_buffers.png and b/docs/write_disk_buffers.png differ