diff --git a/go/perf/codec-perf-rig/README.md b/go/perf/codec-perf-rig/README.md
new file mode 100644
index 0000000000..03d8a8b0f1
--- /dev/null
+++ b/go/perf/codec-perf-rig/README.md
@@ -0,0 +1,23 @@
+This is a Go performance test rig which measures noms encoding/decoding along various axes.
+
+As of July 7, these are the numbers I get on my Macbook Pro 2.7 i5.
+
+Testing List: 		build 100000			    scan 100000			      insert 2000
+numbers (8 B)     451 ms (1.77 MB/s)		26 ms (30.26 MB/s)		275 ms (0.06 MB/s)
+strings (32 B)		444 ms (7.20 MB/s)		35 ms (90.04 MB/s)		321 ms (0.20 MB/s)
+structs (64 B)		682 ms (9.38 MB/s)		115 ms (55.34 MB/s)		239 ms (0.53 MB/s)
+
+Testing Set: 		  build 100000			    scan 100000			    insert 2000
+numbers (8 B)		  461 ms (1.73 MB/s)		23 ms (33.62 MB/s)		90 ms (0.18 MB/s)
+strings (32 B)		480 ms (6.67 MB/s)		28 ms (112.76 MB/s)		207 ms (0.31 MB/s)
+structs (64 B)		1608 ms (3.98 MB/s)		113 ms (56.29 MB/s)		306 ms (0.42 MB/s)
+
+Testing Map: 		  build 100000			    scan 100000			    insert 2000
+numbers (8 B)		  564 ms (1.42 MB/s)		44 ms (18.01 MB/s)		121 ms (0.13 MB/s)
+strings (32 B)		586 ms (5.46 MB/s)		61 ms (51.74 MB/s)		521 ms (0.12 MB/s)
+structs (64 B)		2005 ms (3.19 MB/s)		260 ms (24.61 MB/s)		530 ms (0.24 MB/s)
+
+Testing Blob: 		build 33 MB			      scan 33 MB
+                  553 ms (60.60 MB/s)		429 ms (78.21 MB/s)
+
+
diff --git a/samples/js/codec-perf-rig/README.md b/samples/js/codec-perf-rig/README.md
new file mode 100644
index 0000000000..7e2e6dea66
--- /dev/null
+++ b/samples/js/codec-perf-rig/README.md
@@ -0,0 +1,23 @@
+This is a js performance test rig which measures noms encoding/decoding along various axes.
+
+As of July 7, these are the numbers I get on my Macbook Pro 2.7 i5.
+
+Testing List: 		build 10000 			    scan 10000			      insert 200
+numbers (8 B)		  274 ms (0.29 MB/s)		94 ms (0.85 MB/s)		  359 ms (0.00 MB/s)
+strings (32 B)		223 ms (1.43 MB/s)		100 ms (3.20 MB/s)		337 ms (0.02 MB/s)
+structs (64 B)		591 ms (1.08 MB/s)		354 ms (1.81 MB/s)		342 ms (0.04 MB/s)
+
+Testing Set: 		  build 10000 			    scan 10000			      insert 200
+numbers (8 B)		  185 ms (0.43 MB/s)		91 ms (0.88 MB/s)		  320 ms (0.01 MB/s)
+strings (32 B)		226 ms (1.42 MB/s)		65 ms (4.92 MB/s)		  259 ms (0.02 MB/s)
+structs (64 B)		764 ms (0.84 MB/s)		349 ms (1.83 MB/s)		252 ms (0.05 MB/s)
+
+Testing Map: 		  build 10000 			    scan 10000			      insert 200
+numbers (8 B)		  235 ms (0.34 MB/s)		63 ms (1.27 MB/s)		  271 ms (0.01 MB/s)
+strings (32 B)		575 ms (0.56 MB/s)		103 ms (3.11 MB/s)		427 ms (0.01 MB/s)
+structs (64 B)		1025 ms (0.62 MB/s)		611 ms (1.05 MB/s)		423 ms (0.03 MB/s)
+
+Testing Blob: 		build 2.10 MB			    scan 2.10 MB
+                  580 ms (3.62 MB/s)		470 ms (4.46 MB/s)
+
+