diff --git a/README b/README
new file mode 100644
index 0000000..7f42aba
--- /dev/null
+++ b/README
@@ -0,0 +1,7 @@
+decimal-code
+============
+
+Convert decimal numbers to BCD, AIKEN and STIBITZ (excess-3).
+
+Input lines are interpreted as space-separated encoding and value.
+Tab separated values (decimal, BCD, AIKEN, STIBITZ) are printed.