X-Git-Url: https://code.kerkeslager.com/?p=ton;a=blobdiff_plain;f=README.rst;h=bb854ee7211c3de0a18dabdde017f71070039dde;hp=809a3258693b43925ec9cdc09bb178e14c713a84;hb=HEAD;hpb=5d2690ed8a1b31c4d695f6c6293773d89262b08a

diff --git a/README.rst b/README.rst
index 809a325..bb854ee 100644
--- a/README.rst
+++ b/README.rst
@@ -1,2 +1,22 @@
-# don
-Dual Object Notation
+TON: Twofold Object Notation
+============================
+
+TON is a twofold object notation with equivalent binary and human-readable
+forms. The binary form is optimized for speed and size, while the human-
+readable form is designed to be easy-to-understand. Every TON object in binary
+representation has one unambiguously equivalent TON string representation
+(ignoring whitespace), and every TON object in string representation has one
+unambiguously equivalent TON binary representation. This means that you can
+use the binary representation and get all the benefits of binary, but if you
+need to inspect the contents of the binary it's simple to convert it to the
+string notation and get all the benefits of a human-readable representation.
+
+Without further ado, here's what the human-readable representation looks like:::
+
+    {
+      'foo'utf8: 1i8,
+      'bar'utf8: 'baz'utf16,
+      'qux'utf8: [1i16, -1i16],
+      'quux'utf8: [2i32, -2i32],
+      'quuz'utf8: [3i64, -3i64]
+    }