changed index

1 files changed, 7 insertions, 5 deletions

diff --git a/index.html b/index.html
index cb41511..fda5fd4 100644
--- a/index.html
+++ b/index.html
@@ -49,11 +49,13 @@ will be two variants available:
   State Machine Compiler</a>.</li>
 </ul>
 <p>
-Both variants of the JSON generator generate UTF-8 character sequences by default.
-If an :ascii_only option with a true value is given, they escape all non-ASCII
-and control characters with \uXXXX escape sequences, and support UTF-16
-surrogate pairs in order to be able to generate the whole range of unicode code
-points.
+Both variants of the JSON generator escape all non-ASCII an control
+characters with \uXXXX escape sequences, and support UTF-16 surrogate pairs
+in order to be able to generate the whole range of unicode code points. This
+means that generated JSON text is encoded as UTF-8 (because ASCII is a subset
+of UTF-8) and at the same time avoids decoding problems for receiving
+endpoints, that don't expect UTF-8 encoded texts. On the negative side this
+may lead to a bit longer strings than necessarry.
 </p>
 <p>
 It's also easy to extend JSON data types for arbitrary Ruby classes (including