feat: ratings leaderboard disk format

docs/guide/bkrl.md

@@ -0,0 +1,50 @@
+# Blitzkrieg Ratings Leaderboard
+
+A straightforward way of storing the entire World of Tanks Blitz ratings leaderboard to disk.
+
+```cpp
+primary BlitzkriegRatingsLeaderboard {
+  utf8"BKRL" magic;
+  Header header;
+  primary Body<header> body;
+}
+
+Header {
+  uint16 version; // always 1
+  Format format;
+  uint32 count;
+}
+
+Format enum<uint8> {
+  Minimal,
+  Comprehensive1,
+}
+
+Body<Header header> match<header.format> {
+  Minimal {
+    primary {
+      uint32 id;
+      uint16 score;
+    }[header.count] entries;
+  };
+
+  Comprehensive1 {
+    primary {
+      uint32 id;
+      uint16 score;
+
+      uint32 battles;
+      uint32 wins;
+      uint32 survived;
+
+      uint32 damageDealt;
+      uint32 damageReceived;
+
+      uint32 shots;
+      uint32 hits;
+
+      uint32 kills;
+    }[header.count] entries;
+  };
+}
+```

docs/guide/cdon.md

@@ -1,7 +1,5 @@
 # Cedilla Object Notation
 
-This documentation uses an experimental binary notation syntax called "Buffer Up".
-
 1. JSON compressed as CDON, written directly to disk (a direct 50% reduction).
 2. CDON further compressed with LZ4 (a clean 90% reduction).
 3. The raw JSON file as fetched from a random data source.
@@ -19,7 +17,7 @@ primary CedillaObjectNotation {
 }
 
 Header {
-  uint16 version;
+  uint16 version; // always 1
   FSFormat fsFormat;
   StringTable<fsFormat> stringTable;
 }