diff --git a/src/net/torvald/imagefont/NewRunes.kt b/src/net/torvald/imagefont/NewRunes.kt
index 96a56b7f0..19e4bb704 100644
--- a/src/net/torvald/imagefont/NewRunes.kt
+++ b/src/net/torvald/imagefont/NewRunes.kt
@@ -53,4 +53,26 @@ class NewRunes : Font {
     override fun getWidth(str: String) = runeSize * str.length
 
     override fun getLineHeight() = (runeSize + linegap) * scale
-}
\ No newline at end of file
+}
+
+/*
+How runes are made:
+
+The new runes are based on Hangul writing system. The runes had two main goals:
+ - Implement the principle of its design (specifically, how this letter is altered from its base shape)
+    - {KIYEOK, KHIEUKH}, {TIKEUT, THIEUTH, NIEUN}, {PIEUP, PHIEUPH, MIEUM}, {CIEUC, CHIEUCH, SIOS} sets
+        are similar in shape
+    - Aspirated sounds keep similar shape to their base and have two distinctive dots
+    - Vowels are not random; they have rules
+    - In non-assembled writing, IEUNG only appears as "-ng" phoneme, so the shape is based on
+        old Hangul YESIEUNG, which actually had "-ng" sound
+ - "Doensori" are realised by prepending SIOS, much like older Korean orthography
+ - Good enough obfuscation
+
+
+Notes:
+ - In some letters (e.g. NIEUN-HIEUH), ligatures may applied
+ - EU appear as non-assembled shape; U-shape instead of dash
+
+
+ */
\ No newline at end of file