style: fix doc issues for Connectors

Author: mamoonraja

Connection/RESTConnector.cs

@@ -258,7 +258,7 @@ public bool? DisableSslVerification
         /// <summary>
         /// This function returns a RESTConnector object for the given service and function.
         /// </summary>
-        /// <param name="serviceID">The ID of the service.</param>
+        /// <param name="authenticator">Authenticator used to authenticate service.</param>
         /// <param name="function">The name of the function.</param>
         /// <returns>Returns a RESTConnector object or null on error.</returns>
         ///
@@ -304,31 +304,30 @@ public bool Send(Request request)
 
         #region Authenticate request
         /// <summary>
-        /// Authenticate based on bearer token
+        /// Add Authentication headers
         /// </summary>
-        /// <param name="request">The request object.</param>
-        /// <returns>true is returned on success, false is returned if the Request can't be sent.</returns>
+        /// <param name="bearerToken">The bearer token to authenticate.</param>
         public void WithAuthentication(string bearerToken)
         {
             if (Headers == null)
             {
                Headers = new Dictionary<string,string>();;
             }
-            Headers.Add("Authorization", string.Format("Bearer {0}", bearerToken));
+            Headers.Add(AUTHENTICATION_AUTHORIZATION_HEADER, string.Format("Bearer {0}", bearerToken));
         }
 
         /// <summary>
-        /// Authenticate based on bearer token
+        /// Add Authentication headers
         /// </summary>
-        /// <param name="request">The request object.</param>
-        /// <returns>true is returned on success, false is returned if the Request can't be sent.</returns>
+        /// <param name="username">Username</param>
+        /// <param name="password">Password.</param>
         public void WithAuthentication(string username, string password)
         {
             if (Headers == null)
             {
                Headers = new Dictionary<string,string>();;
             }
-            Headers.Add("Authorization", Utility.CreateAuthorization(username, password));
+            Headers.Add(AUTHENTICATION_AUTHORIZATION_HEADER, Utility.CreateAuthorization(username, password));
         }
         #endregion
 

Connection/WSConnector.cs

@@ -142,31 +142,30 @@ public TextMessage(string text, Dictionary<string, string> headers = null)
 
         #region Authenticate request
         /// <summary>
-        /// Authenticate based on bearer token
+        /// Add Authentication headers
         /// </summary>
-        /// <param name="request">The request object.</param>
-        /// <returns>true is returned on success, false is returned if the Request can't be sent.</returns>
+        /// <param name="bearerToken">The bearer token to authenticate.</param>
         public void WithAuthentication(string bearerToken)
         {
             if (Headers == null)
             {
                Headers = new Dictionary<string,string>();;
             }
-            Headers.Add("Authorization", string.Format("Bearer {0}", bearerToken));
+            Headers.Add(AUTHENTICATION_AUTHORIZATION_HEADER, string.Format("Bearer {0}", bearerToken));
         }
 
         /// <summary>
-        /// Authenticate based on bearer token
+        /// Add Authentication headers
         /// </summary>
-        /// <param name="request">The request object.</param>
-        /// <returns>true is returned on success, false is returned if the Request can't be sent.</returns>
+        /// <param name="username">Username</param>
+        /// <param name="password">Password.</param>
         public void WithAuthentication(string username, string password)
         {
             if (Headers == null)
             {
                Headers = new Dictionary<string,string>();;
             }
-            Headers.Add("Authorization", Utility.CreateAuthorization(username, password));
+            Headers.Add(AUTHENTICATION_AUTHORIZATION_HEADER, Utility.CreateAuthorization(username, password));
         }
         #endregion
 
@@ -325,7 +324,7 @@ public static string FixupURL(string URL)
         /// <summary>
         /// Create a WSConnector for the given service and function. 
         /// </summary>
-        /// <param name="authenticator">The credentials for the service.</param>
+        /// <param name="authenticator">The authenticator for the service.</param>
         /// <param name="function">The name of the function to connect.</param>
         /// <param name="args">Additional function arguments.</param>
         /// <returns>The WSConnector object or null or error.</returns>

Utilities/Utility.cs

@@ -1241,8 +1241,7 @@ public static List<string> GetCredentialsPaths()
         #region String to Double
         public static double StringToDouble(string input)
         {
-            double output;
-            double.TryParse(input, out output);
+            double.TryParse(input, out double output);
             return output;
         }
         #endregion