Improve documentation (#308)

Author: vanillajonathan

Src/Fido2.Models/Fido2Configuration.cs

@@ -6,6 +6,16 @@ namespace Fido2NetLib
 {
     public class Fido2Configuration
     {
+        private HashSet<string> _origins;
+        private HashSet<string> _fullyQualifiedOrigins;
+
+        /// <summary>
+        /// Create the configuration for Fido2.
+        /// </summary>
+        public Fido2Configuration()
+        {
+        }
+
         /// <summary>
         /// This member specifies a time, in milliseconds, that the caller is willing to wait for the call to complete. 
         /// This is treated as a hint, and MAY be overridden by the client.
@@ -28,12 +38,12 @@ public class Fido2Configuration
         public string ServerDomain { get; set; }
 
         /// <summary>
-        ///  A human friendly name of the RP
+        /// A human-friendly name of the RP.
         /// </summary>
         public string ServerName { get; set; }
 
         /// <summary>
-        /// A serialized URL which resolves to an image associated with the entity.For example, this could be a user’s avatar or a Relying Party's logo. This URL MUST be an a priori authenticated URL. Authenticators MUST accept and store a 128-byte minimum length for an icon member’s value. Authenticators MAY ignore an icon member’s value if its length is greater than 128 bytes. The URL’s scheme MAY be "data" to avoid fetches of the URL, at the cost of needing more storage.
+        /// A serialized URL which resolves to an image associated with the entity. For example, this could be a user’s avatar or a Relying Party's logo. This URL MUST be an a priori authenticated URL. Authenticators MUST accept and store a 128-byte minimum length for an icon member’s value. Authenticators MAY ignore an icon member’s value if its length is greater than 128 bytes. The URL’s scheme MAY be "data" to avoid fetches of the URL, at the cost of needing more storage.
         /// </summary>
         public string ServerIcon { get; set; }
 
@@ -88,7 +98,7 @@ public HashSet<string> FullyQualifiedOrigins
         }
 
         /// <summary>
-        /// MDSCacheDirPath
+        /// Metadata service cache directory path.
         /// </summary>
         public string MDSCacheDirPath { get; set; }
 
@@ -103,15 +113,5 @@ public HashSet<string> FullyQualifiedOrigins
             AuthenticatorStatus.USER_KEY_PHYSICAL_COMPROMISE,
             AuthenticatorStatus.REVOKED
         };
-
-        /// <summary>
-        /// Create the configuration for Fido2
-        /// </summary>
-        public Fido2Configuration()
-        {
-        }
-
-        private HashSet<string> _origins;
-        private HashSet<string> _fullyQualifiedOrigins;
     }
 }