Cleaning-up xml docs

JWT.sln.DotSettings

@@ -1,4 +1,5 @@
 <wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
+	<s:String x:Key="/Default/CodeStyle/CodeFormatting/CSharpCodeStyle/ThisQualifier/INSTANCE_MEMBERS_QUALIFY_MEMBERS/@EntryValue">Property</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=HMACSHA/@EntryIndexedValue">HMACSHA</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=RS/@EntryIndexedValue">RS</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=RSA/@EntryIndexedValue">RSA</s:String>

src/JWT/Algorithms/IAlgorithmFactory.cs

@@ -8,13 +8,13 @@ public interface IAlgorithmFactory
         /// <summary>
         /// Creates an AlgorithmFactory using the provided algorithm name.
         /// </summary>
-        /// <param name="algorithmName">The name of the algorithm.</param>
+        /// <param name="algorithmName">The name of the algorithm</param>
         IJwtAlgorithm Create(string algorithmName);
 
         /// <summary>
         /// Creates an AlgorithmFactory using the provided algorithm enum.
         /// </summary>
-        /// <param name="algorithm">The enum value of the algorithm.</param>
+        /// <param name="algorithm">The enum value of the algorithm</param>
         IJwtAlgorithm Create(JwtHashAlgorithm algorithm);
     }
 }

src/JWT/Algorithms/IJwtAlgorithm.cs

@@ -8,8 +8,8 @@ public interface IJwtAlgorithm
         /// <summary>
         /// Signs provided byte array with provided key.
         /// </summary>
-        /// <param name="key">The key used to sign the data.</param>
-        /// <param name="bytesToSign">The data to sign.</param>
+        /// <param name="key">The key used to sign the data</param>
+        /// <param name="bytesToSign">The data to sign</param>
         byte[] Sign(byte[] key, byte[] bytesToSign);
 
         /// <summary>

src/JWT/Algorithms/RS256Algorithm.cs

@@ -13,7 +13,6 @@ public sealed class RS256Algorithm : IJwtAlgorithm
         /// <summary>
         /// Creates an instance using the provided certificate.
         /// </summary>
-        /// <param name="cert"></param>
         public RS256Algorithm(X509Certificate2 cert)
         {
             _cert = cert;
@@ -40,9 +39,8 @@ public byte[] Sign(byte[] bytesToSign)
         /// <summary>
         /// Verifies provided byte array with provided signature.
         /// </summary>
-        /// <param name="bytesToSign">The data to verify.</param>
+        /// <param name="bytesToSign">The data to verify</param>
         /// <param name="signature">The signature to verify with</param>
-        /// <returns></returns>
         public bool Verify(byte[] bytesToSign, byte[] signature)
         {
             var publicKey = GetPublicKey(_cert);

src/JWT/Builder/JwtBuilder.cs

@@ -26,8 +26,8 @@ public sealed class JwtBuilder
         /// <summary>
         /// Add header to the JWT.
         /// </summary>
-        /// <param name="name">Well-known header name.</param>
-        /// <param name="value">The value you want give to the header.</param>
+        /// <param name="name">Well-known header name</param>
+        /// <param name="value">The value you want give to the header</param>
         /// <returns>Current builder instance</returns>
         public JwtBuilder AddHeader(HeaderName name, string value)
         {
@@ -152,7 +152,7 @@ public JwtBuilder WithAlgorithm(IJwtAlgorithm algorithm)
         /// Sets certificate secret.
         /// </summary>
         /// <remarks>
-        /// Required to create new token that uses an asymmetric algorithm such as <seealso cref="RS256Algorithm" />.
+        /// Required to create new token that uses an asymmetric algorithm such as <seealso cref="RS256Algorithm" />
         /// </remarks>
         /// <returns>Current builder instance</returns>
         public JwtBuilder WithSecret(params string[] secrets)
@@ -186,8 +186,8 @@ public JwtBuilder WithVerifySignature(bool verify)
         /// <summary>
         /// Builds a token using the supplied dependencies.
         /// </summary>
-        /// <returns>The generated JWT.</returns>
-        /// <exception cref="InvalidOperationException">Thrown if either algorithm, serializer, encoder or secret is null.</exception>
+        /// <returns>The generated JWT</returns>
+        /// <exception cref="InvalidOperationException">Thrown if either algorithm, serializer, encoder or secret is null</exception>
         public string Build()
         {
             if (_encoder == null)
@@ -201,7 +201,7 @@ public string Build()
         /// <summary>
         /// Decodes a token using the supplied dependencies.
         /// </summary>
-        /// <param name="token">The JWT.</param>
+        /// <param name="token">The JWT</param>
         /// <returns>The JSON payload</returns>
         public string Decode(string token)
         {
@@ -214,8 +214,8 @@ public string Decode(string token)
         /// <summary>
         /// Decodes a token using the supplied dependencies.
         /// </summary>
-        /// <param name="token">The JWT.</param>
-        /// <returns>The payload converted to <see cref="T" />.</returns>
+        /// <param name="token">The JWT</param>
+        /// <returns>The payload converted to <see cref="T" /></returns>
         public T Decode<T>(string token)
         {
             if (_decoder == null)

src/JWT/Builder/JwtData.cs

@@ -17,7 +17,7 @@ public JwtData()
         }
 
         /// <summary>
-        /// Creates a new instance of <see cref="JwtData" />.
+        /// Creates a new instance of <see cref="JwtData" />
         /// </summary>
         /// <param name="payload">Dictionary that contans the payload</param>
         public JwtData(IDictionary<string, object> payload)
@@ -26,7 +26,7 @@ public JwtData(IDictionary<string, object> payload)
         }
 
         /// <summary>
-        /// Creates a new instance of <see cref="JwtData" />.
+        /// Creates a new instance of <see cref="JwtData" />
         /// </summary>
         /// <param name="header">Dictionary that contains the headers</param>
         /// <param name="payload">Dictionary that contans the payload</param>

src/JWT/IDateTimeProvider.cs

@@ -8,9 +8,8 @@ namespace JWT
     public interface IDateTimeProvider
     {
         /// <summary>
-        /// Get the current DateTime.
+        /// Gets the current DateTime.
         /// </summary>
-        /// <returns></returns>
         DateTimeOffset GetNow();
     }
 }