From 6424cb799ee7c36db0bd79af73556bafba9ea877 Mon Sep 17 00:00:00 2001
From: "Chloe M." <chloe@mensia.org>
Date: Sun, 28 Jun 2026 01:26:27 +0000
Subject: [PATCH] docs: Add README.md

Signed-off-by: Chloe M. <chloe@mensia.org>
---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9b30acb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# The CUMHOLE initial ramdisk format
+
+Cumhole is a wovely initrd format meant for bundling files into a format in which individual
+files can be extracted by path.
+
+## What makes this different than e.g., TAR?
+
+Unlike TAR, CUMHOLE avoids metadata soup and octal encodings, in addition, we employ an offset table
+at the beginning of each archive [as opposed to the end where data is stored] where the minimal metadata
+lives as well as an offset to per-file data!