edit docs; etc.

Author: peteroupc

CBOR/PeterO/Cbor/CBOREncodeOptions.cs

@@ -55,6 +55,7 @@ public CBOREncodeOptions(
       this.ResolveReferences = false;
       this.AllowEmpty = false;
       this.Float64 = false;
+      this.KeepKeyOrder = false;
       this.UseIndefLengthStrings = useIndefLengthStrings;
       this.AllowDuplicateKeys = allowDuplicateKeys;
       this.Ctap2Canonical = ctap2Canonical;
@@ -209,7 +210,9 @@ public bool UseIndefLengthStrings {
 
     /// <summary>Gets a value indicating whether to preserve the order in
     /// which a CBOR map's keys appear when decoding a CBOR object, by
-    /// using maps created as though by CBORObject.NewOrderedMap.</summary>
+    /// using maps created as though by CBORObject.NewOrderedMap. If false,
+    /// key order is not guaranteed to be preserved when decoding
+    /// CBOR.</summary>
     /// <value>A value indicating whether to preserve the order in which a
     /// CBOR map's keys appear when decoding a CBOR object. The default is
     /// false.</value>

CBOR/PeterO/Cbor/JSONOptions.cs

@@ -319,7 +319,8 @@ public bool WriteBasic {
 
     /// <summary>Gets a value indicating whether to preserve the order in
     /// which a map's keys appear when decoding JSON, by using maps created
-    /// as though by CBORObject.NewOrderedMap.</summary>
+    /// as though by CBORObject.NewOrderedMap. If false, key order is not
+    /// guaranteed to be preserved when decoding JSON.</summary>
     /// <value>A value indicating whether to preserve the order in which a
     /// CBOR map's keys appear when decoding JSON. The default is
     /// false.</value>