diff --git a/src/Auth0.AuthenticationApi/AuthenticationApiClient.cs b/src/Auth0.AuthenticationApi/AuthenticationApiClient.cs
index 92ef5f5c5..69393869c 100644
--- a/src/Auth0.AuthenticationApi/AuthenticationApiClient.cs
+++ b/src/Auth0.AuthenticationApi/AuthenticationApiClient.cs
@@ -1,10 +1,10 @@
-using System;
+using Auth0.AuthenticationApi.Builders;
+using Auth0.AuthenticationApi.Models;
+using Auth0.Core.Http;
+using System;
 using System.Collections.Generic;
 using System.Net.Http;
 using System.Threading.Tasks;
-using Auth0.AuthenticationApi.Builders;
-using Auth0.AuthenticationApi.Models;
-using Auth0.Core.Http;
 
 namespace Auth0.AuthenticationApi
 {
@@ -16,9 +16,6 @@ namespace Auth0.AuthenticationApi
     /// </remarks>
     public class AuthenticationApiClient : IAuthenticationApiClient
     {
-        /// <summary>
-        /// The base URI
-        /// </summary>
         private readonly Uri _baseUri;
 
         private AuthenticationApiClient(Uri baseUri, ApiConnection connection)
@@ -336,7 +333,13 @@ public async Task<AccessTokenResponse> GetTokenAsync(ResourceOwnerTokenRequest r
             return response;
         }
 
-        /// <inheritdoc />
+
+        /// <summary>
+        /// Gets information about the last API call made using this client.
+        /// </summary>
+        /// <returns>
+        /// A <see cref="ApiInfo"/> containing information about the last API call made.
+        /// </returns>
         public ApiInfo GetLastApiInfo()
         {
             return Connection.ApiInfo;
@@ -414,7 +417,7 @@ public Task<PasswordlessSmsResponse> StartPasswordlessSmsFlowAsync(PasswordlessS
         /// Unlinks a secondary account from a primary account.
         /// </summary>
         /// <param name="request">The <see cref="UnlinkUserRequest"/> containing the information of the accounts to unlink.</param>
-        /// <returns>Nothing</returns>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous unlink operation.</returns>
         public async Task UnlinkUserAsync(UnlinkUserRequest request)
         {
             await Connection.PostAsync<object>("unlink", request, null, null, null, null, null).ConfigureAwait(false);
diff --git a/src/Auth0.Core/Http/ApiConnection.cs b/src/Auth0.Core/Http/ApiConnection.cs
index 9b5a91000..b0783d18c 100644
--- a/src/Auth0.Core/Http/ApiConnection.cs
+++ b/src/Auth0.Core/Http/ApiConnection.cs
@@ -1,3 +1,5 @@
+using Auth0.Core.Exceptions;
+using Newtonsoft.Json;
 using System;
 using System.Collections.Generic;
 using System.Linq;
@@ -5,13 +7,11 @@
 using System.Reflection;
 using System.Text;
 using System.Threading.Tasks;
-using Auth0.Core.Exceptions;
-using Newtonsoft.Json;
 
 namespace Auth0.Core.Http
 {
     /// <summary>
-    /// The communication layer between the various API clients and the actual API backend.
+    /// The communication layer between the API clients and the HTTP REST backend.
     /// </summary>
     public class ApiConnection : IApiConnection, IDisposable
     {
@@ -26,12 +26,24 @@ public class ApiConnection : IApiConnection, IDisposable
         /// </summary>
         public ApiInfo ApiInfo { get; private set; }
 
+        /// <summary>
+        /// Creates a new instance of ApiConnection using an optional <see cref="HttpMessageHandler"/>.
+        /// </summary>
+        /// <param name="token">A valid Auth0 Management API v2 token.</param>
+        /// <param name="baseUrl">The URL of the tenant to manage.</param>
+        /// <param name="handler">An optional <see cref="HttpMessageHandler"/> to modify outgoing requests.</param>
         public ApiConnection(string token, string baseUrl, HttpMessageHandler handler = null)
             : this(token, baseUrl, new HttpClient(handler ?? new HttpClientHandler()))
         {
             _disposeHttpClient = true;
         }
 
+        /// <summary>
+        /// Creates a new instance of ApiConnection using a provided <see cref="HttpClient"/>.
+        /// </summary>
+        /// <param name="token">A valid Auth0 Management API v2 token.</param>
+        /// <param name="baseUrl">The URL of the tenant to manage.</param>
+        /// <param name="httpClient">A <see cref="HttpClient"/> used to send outgoing requests.</param>
         public ApiConnection(string token, string baseUrl, HttpClient httpClient)
         {
             _token = token;
@@ -81,14 +93,6 @@ private void ApplyHeaders(HttpRequestMessage message, IDictionary<string, object
                         message.Headers.Add(pair.Key, pair.Value.ToString());
         }
 
-        /// <summary>
-        /// Builds the content of the message. This will build the appropriate <see cref="HttpContent" /> for the request based
-        /// on the type of the parameters passed in.
-        /// </summary>
-        /// <param name="body">The body.</param>
-        /// <param name="parameters">The parameters.</param>
-        /// <param name="fileParameters">The file parameters.</param>
-        /// <returns>HttpContent.</returns>
         private HttpContent BuildMessageContent(object body, IDictionary<string, object> parameters,
             IList<FileUploadParameter> fileParameters)
         {
@@ -123,13 +127,6 @@ private HttpContent BuildMessageContent(object body, IDictionary<string, object>
             }), Encoding.UTF8, "application/json");
         }
 
-        /// <summary>
-        /// Builds up the URL for the request by substituting values for URL segments and adding query string parameters.
-        /// </summary>
-        /// <param name="resource">The resource.</param>
-        /// <param name="urlSegments">The URL segments.</param>
-        /// <param name="queryStrings">The query strings.</param>
-        /// <returns>Uri.</returns>
         private Uri BuildRequestUri(string resource, IDictionary<string, string> urlSegments,
             IDictionary<string, string> queryStrings)
         {
@@ -143,7 +140,7 @@ private Uri BuildRequestUri(string resource, IDictionary<string, string> urlSegm
         /// <param name="resource">The resource.</param>
         /// <param name="urlSegments">The URL segments.</param>
         /// <param name="queryStrings"></param>
-        /// <returns>Task&lt;T&gt;.</returns>
+        /// <returns>A <see cref="Task{T}"/> that represents the asynchronous Delete operation.</returns>
         public async Task<T> DeleteAsync<T>(string resource, IDictionary<string, string> urlSegments,
             IDictionary<string, string> queryStrings) where T : class
         {
@@ -166,7 +163,7 @@ public async Task<T> DeleteAsync<T>(string resource, IDictionary<string, string>
         /// <param name="body">The body.</param>
         /// <param name="urlSegments">The URL segments.</param>
         /// <param name="queryStrings"></param>
-        /// <returns>Task&lt;T&gt;.</returns>
+        /// <returns>A <see cref="Task{T}"/> that represents the asynchronous Delete operation.</returns>
         public async Task<T> DeleteAsync<T>(string resource, object body, IDictionary<string, string> urlSegments, IDictionary<string, string> queryStrings) where T : class
         {
             return await RunAsync<T>(resource,
@@ -210,13 +207,6 @@ public async Task<T> GetAsync<T>(string resource, IDictionary<string, string> ur
                 converters).ConfigureAwait(false);
         }
 
-        /// <summary>
-        /// Handles errors returned from the API. It will check the response code, deserialize any relevant JSON error payload
-        /// and throw an appropriate exception.
-        /// </summary>
-        /// <param name="response">The <see cref="HttpResponseMessage" /> returned from the API.</param>
-        /// <returns>A <see cref="Task" />.</returns>
-        /// <exception cref="ApiException"></exception>
         private async Task HandleErrors(HttpResponseMessage response)
         {
             if (!response.IsSuccessStatusCode)
@@ -251,13 +241,13 @@ private async Task HandleErrors(HttpResponseMessage response)
         }
 
         /// <summary>
-        /// Performs an HTTP PATCH.
+        /// Performs an HTTP PATCH operation.
         /// </summary>
         /// <typeparam name="T"></typeparam>
         /// <param name="resource">The resource.</param>
         /// <param name="body">The body.</param>
         /// <param name="urlSegments">The URL segments.</param>
-        /// <returns>Task&lt;T&gt;.</returns>
+        /// <returns>A <see cref="Task{T}"/> that represents the asynchronous Patch operation.</returns>
         public async Task<T> PatchAsync<T>(string resource, object body, Dictionary<string, string> urlSegments)
             where T : class
         {
@@ -283,7 +273,7 @@ public async Task<T> PatchAsync<T>(string resource, object body, Dictionary<stri
         /// <param name="urlSegments">The URL segments.</param>
         /// <param name="headers">The headers.</param>
         /// <param name="queryStrings">The query strings.</param>
-        /// <returns>Task&lt;T&gt;.</returns>
+        /// <returns>A <see cref="Task{T}"/> that represents the asynchronous Post operation.</returns>
         public async Task<T> PostAsync<T>(string resource, object body, IDictionary<string, object> parameters,
             IList<FileUploadParameter> fileParameters, IDictionary<string, string> urlSegments,
             IDictionary<string, object> headers, IDictionary<string, string> queryStrings) where T : class
@@ -310,7 +300,7 @@ public async Task<T> PostAsync<T>(string resource, object body, IDictionary<stri
         /// <param name="urlSegments">The URL segments.</param>
         /// <param name="headers">The headers.</param>
         /// <param name="queryStrings">The query strings.</param>
-        /// <returns>Task&lt;T&gt;.</returns>
+        /// <returns>A <see cref="Task{T}"/> that represents the asynchronous Put operation.</returns>
         public async Task<T> PutAsync<T>(string resource, object body, IDictionary<string, object> parameters,
             IList<FileUploadParameter> fileParameters, IDictionary<string, string> urlSegments,
             IDictionary<string, object> headers, IDictionary<string, string> queryStrings) where T : class
@@ -340,7 +330,7 @@ public async Task<T> PutAsync<T>(string resource, object body, IDictionary<strin
         /// <param name="headers">The headers.</param>
         /// <param name="fileParameters">The file parameters.</param>
         /// <param name="converters">The list of <see cref="JsonConverter" /> to use during deserialization.</param>
-        /// <returns>Task&lt;T&gt;.</returns>
+        /// <returns>A <see cref="Task{T}"/> that represents the asynchronous Run operation.</returns>
         private async Task<T> RunAsync<T>(string resource, HttpMethod httpMethod, object body,
             IDictionary<string, string> urlSegments, IDictionary<string, string> queryStrings,
             IDictionary<string, object> parameters, IDictionary<string, object> headers,
diff --git a/src/Auth0.ManagementApi/Clients/BlacklistedTokensClient.cs b/src/Auth0.ManagementApi/Clients/BlacklistedTokensClient.cs
index 2c101c6a1..6450af7d0 100644
--- a/src/Auth0.ManagementApi/Clients/BlacklistedTokensClient.cs
+++ b/src/Auth0.ManagementApi/Clients/BlacklistedTokensClient.cs
@@ -22,7 +22,7 @@ public BlacklistedTokensClient(IApiConnection connection)
         /// <summary>
         /// Gets all the blacklisted claims.
         /// </summary>
-        /// <param name="aud">The aud claim for which you want to get blacklisted tokens. This is your API Key.</param>
+        /// <param name="aud">The JWT's aud claim. The client_id of the client for which it was issued.</param>
         /// <returns>A list of <see cref="BlacklistedToken"/> objects.</returns>
         public Task<IList<BlacklistedToken>> GetAllAsync(string aud)
         {
@@ -37,7 +37,7 @@ public Task<IList<BlacklistedToken>> GetAllAsync(string aud)
         /// Blacklists a JWT token.
         /// </summary>
         /// <param name="request">The <see cref="BlacklistedTokenCreateRequest"/> containing the information of the token to blacklist.</param>
-        /// <returns>A <see cref="Task"/> indicating the request completion.</returns>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous create operation.</returns>
         public Task CreateAsync(BlacklistedTokenCreateRequest request)
         {
             return Connection.PostAsync<Client>("blacklists/tokens", request, null, null, null, null, null);
diff --git a/src/Auth0.ManagementApi/Clients/ClientBase.cs b/src/Auth0.ManagementApi/Clients/ClientBase.cs
index ff79a164a..32e5f3f98 100644
--- a/src/Auth0.ManagementApi/Clients/ClientBase.cs
+++ b/src/Auth0.ManagementApi/Clients/ClientBase.cs
@@ -8,7 +8,7 @@ namespace Auth0.ManagementApi.Clients
     public class ClientBase
     {
         /// <summary>
-        /// The <see cref="IApiConnection"/> which is used to make all HTTPS REST calls.
+        /// The <see cref="IApiConnection"/> which is used to make all REST calls.
         /// </summary>
         internal IApiConnection Connection { get; }
 
diff --git a/src/Auth0.ManagementApi/Clients/ClientGrantsClient.cs b/src/Auth0.ManagementApi/Clients/ClientGrantsClient.cs
index cc85afd15..6afda550d 100644
--- a/src/Auth0.ManagementApi/Clients/ClientGrantsClient.cs
+++ b/src/Auth0.ManagementApi/Clients/ClientGrantsClient.cs
@@ -36,7 +36,7 @@ public Task<ClientGrant> CreateAsync(ClientGrantCreateRequest request)
         /// Deletes a client grant.
         /// </summary>
         /// <param name="id">The identifier of the Client Grant to delete.</param>
-        /// <returns>A <see cref="Task"/> indicating the request completion.</returns>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteAsync(string id)
         {
             return Connection.DeleteAsync<object>("client-grants/{id}", 
@@ -51,7 +51,7 @@ public Task DeleteAsync(string id)
         /// </summary>
         /// <param name="request">Specifies criteria to use when querying client grants.</param>
         /// <param name="pagination">Specifies <see cref="PaginationInfo"/> to use in requesting paged results.</param>
-        /// <returns>A <see cref="IPagedList"/> containing the matching <see cref="ClientGrant"/> instances.</returns>
+        /// <returns>A <see cref="IPagedList{ClientGrant}"/> containing the client grants requested.</returns>
         public Task<IPagedList<ClientGrant>> GetAllAsync(GetClientGrantsRequest request, PaginationInfo pagination)
         {
             if (request == null)
diff --git a/src/Auth0.ManagementApi/Clients/ClientsClient.cs b/src/Auth0.ManagementApi/Clients/ClientsClient.cs
index 262836583..bc114f641 100644
--- a/src/Auth0.ManagementApi/Clients/ClientsClient.cs
+++ b/src/Auth0.ManagementApi/Clients/ClientsClient.cs
@@ -39,7 +39,7 @@ public Task<Client> CreateAsync(ClientCreateRequest request)
         /// Deletes a client and all its related assets (like rules, connections, etc) given its id.
         /// </summary>
         /// <param name="id">The id of the client to delete.</param>
-        /// <returns>A <see cref="Task"/> indicating the request completion.</returns>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteAsync(string id)
         {
             return Connection.DeleteAsync<object>("clients/{id}", 
@@ -111,7 +111,7 @@ public Task<Client> GetAsync(string id, string fields = null, bool includeFields
         /// <summary>
         /// Rotate a client secret. The generated secret is NOT base64 encoded.
         /// </summary>
-        /// <param name="id">The id of the client which secret needs to be rotated</param>
+        /// <param name="id">The id of the client which secret needs to be rotated.</param>
         /// <returns>The <see cref="Client"/> that has had its secret rotated.</returns>
         public Task<Client> RotateClientSecret(string id)
         {
diff --git a/src/Auth0.ManagementApi/Clients/ConnectionsClient.cs b/src/Auth0.ManagementApi/Clients/ConnectionsClient.cs
index 79ab713e6..51cd2b8cf 100644
--- a/src/Auth0.ManagementApi/Clients/ConnectionsClient.cs
+++ b/src/Auth0.ManagementApi/Clients/ConnectionsClient.cs
@@ -36,6 +36,7 @@ public Task<Connection> CreateAsync(ConnectionCreateRequest request)
         /// Deletes a connection and all its users.
         /// </summary>
         /// <param name="id">The id of the connection to delete.</param>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteAsync(string id)
         {
             return Connection.DeleteAsync<object>("connections/{id}", new Dictionary<string, string>
@@ -45,14 +46,14 @@ public Task DeleteAsync(string id)
         }
 
         /// <summary>
-        /// Deletes a specified connection user by its email.
+        /// Deletes a specified connection user by its <paramref name="email"/>.
         /// </summary>
         /// <remarks>
         /// Currently only database connections are supported and you cannot delete all users from specific connection.
         /// </remarks>
-        /// <param name="id">The identifier of the connection</param>
-        /// <param name="email">The email of the user to delete</param>
-        /// <returns></returns>
+        /// <param name="id">The identifier of the connection.</param>
+        /// <param name="email">The email of the user to delete.</param>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteUserAsync(string id, string email)
         {
             return Connection.DeleteAsync<object>("connections/{id}/users",
@@ -67,7 +68,7 @@ public Task DeleteUserAsync(string id, string email)
         }
 
         /// <summary>
-        /// Retrieves a connection by its <paramref name="id"/>
+        /// Retrieves a connection by its <paramref name="id"/>.
         /// </summary>
         /// <param name="id">The id of the connection to retrieve.</param>
         /// <param name="fields">A comma separated list of fields to include or exclude (depending on include_fields) from the result, empty to retrieve all fields.</param>
diff --git a/src/Auth0.ManagementApi/Clients/CustomDomainsClient.cs b/src/Auth0.ManagementApi/Clients/CustomDomainsClient.cs
index 2e08cc2f2..4a23cd8a7 100644
--- a/src/Auth0.ManagementApi/Clients/CustomDomainsClient.cs
+++ b/src/Auth0.ManagementApi/Clients/CustomDomainsClient.cs
@@ -23,7 +23,7 @@ internal CustomDomainsClient(IApiConnection connection)
         /// Creates a new custom domain and returns it.
         /// </summary>
         /// <param name="request">A <see cref="CustomDomainCreateRequest"/> representing the new domain.</param>
-        /// <returns>The new domain.</returns>
+        /// <returns>The <see cref="CustomDomain"/> containing the newly created custom domain.</returns>
         /// <remarks>The custom domain will need to be verified before it starts accepting requests.</remarks>
         public Task<CustomDomain> CreateAsync(CustomDomainCreateRequest request)
         {
@@ -34,7 +34,7 @@ public Task<CustomDomain> CreateAsync(CustomDomainCreateRequest request)
         /// Deletes a custom domain by its ID.
         /// </summary>
         /// <param name="id">The ID of the domain to delete.</param>
-        /// <returns></returns>
+        /// <returns>A <see cref="Task"/> that represents the asyncronous delete operation.</returns>
         /// <remarks>When deleted, Auth0 will stop serving requests for this domain.</remarks>
         public Task DeleteAsync(string id)
         {
@@ -48,7 +48,7 @@ public Task DeleteAsync(string id)
         /// <summary>
         /// Retrieves the status of every custom domain.
         /// </summary>
-        /// <returns>The list of custom domains</returns>
+        /// <returns>A <see cref="IList{CustomDomain}"/> containing the details of every custom domain.
         public Task<IList<CustomDomain>> GetAllAsync()
         {
             return Connection.GetAsync<IList<CustomDomain>>("custom-domains", null, null, null, null);
@@ -58,7 +58,7 @@ public Task<IList<CustomDomain>> GetAllAsync()
         /// Retrieves a custom domain status by its ID
         /// </summary>
         /// <param name="id">The ID of the domain to retrieve.</param>
-        /// <returns>The domain.</returns>
+        /// <returns>The <see cref="CustomDomain"/> that was requested.</returns>
         public Task<CustomDomain> GetAsync(string id)
         {
             return Connection.GetAsync<CustomDomain>("custom-domains/{id}",
@@ -73,7 +73,7 @@ public Task<CustomDomain> GetAsync(string id)
         /// Run the verification process for the custom domain. 
         /// </summary>
         /// <param name="id">The ID of the domain to verify.</param>
-        /// <returns></returns>
+        /// <returns>The <see cref="CustomDomainVerification"/> that was requested.</returns>
         public Task<CustomDomainVerificationResponse> VerifyAsync(string id)
         {
             return Connection.PostAsync<CustomDomainVerificationResponse>("custom-domains/{id}/verify", null, null, null, 
diff --git a/src/Auth0.ManagementApi/Clients/DeviceCredentialsClient.cs b/src/Auth0.ManagementApi/Clients/DeviceCredentialsClient.cs
index afc204c34..d5a02ca73 100644
--- a/src/Auth0.ManagementApi/Clients/DeviceCredentialsClient.cs
+++ b/src/Auth0.ManagementApi/Clients/DeviceCredentialsClient.cs
@@ -24,9 +24,9 @@ public DeviceCredentialsClient(ApiConnection connection)
         /// </summary>
         /// <param name="fields">A comma separated list of fields to include or exclude (depending on include_fields) from the result, empty to retrieve all fields.</param>
         /// <param name="includeFields">True if the fields specified are to be excluded from the result, false otherwise (defaults to true).</param>
-        /// <param name="userId">The user id of the devices to retrieve</param>
+        /// <param name="userId">The user id of the devices to retrieve.</param>
         /// <param name="clientId">The client id of the devices to retrieve.</param>
-        /// <param name="type">The type of credentials</param>
+        /// <param name="type">The type of credentials.</param>
         /// <returns>A list of <see cref="DeviceCredential"/> which conforms to the criteria specified.</returns>
         public Task<IList<DeviceCredential>> GetAllAsync(string fields = null, bool includeFields = true, string userId = null, string clientId = null, string type = null)
         {
@@ -45,7 +45,7 @@ public Task<IList<DeviceCredential>> GetAllAsync(string fields = null, bool incl
         /// Creates a new device credential.
         /// </summary>
         /// <param name="request">The request containing the details of the device credential to create.</param>
-        /// <returns>Tnew newly created <see cref="DeviceCredential"/></returns>
+        /// <returns>The newly created <see cref="DeviceCredential"/>.</returns>
         public Task<DeviceCredential> CreateAsync(DeviceCredentialCreateRequest request)
         {
             return Connection.PostAsync<DeviceCredential>("device-credentials", request, null, null, null, null, null);
@@ -54,7 +54,8 @@ public Task<DeviceCredential> CreateAsync(DeviceCredentialCreateRequest request)
         /// <summary>
         /// Deletes a device credential.
         /// </summary>
-        /// <param name="id">The id of the device credential to delete</param>
+        /// <param name="id">The id of the device credential to delete.</param>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteAsync(string id)
         {
             return Connection.DeleteAsync<object>("device-credentials/{id}", 
diff --git a/src/Auth0.ManagementApi/Clients/EmailProviderClient.cs b/src/Auth0.ManagementApi/Clients/EmailProviderClient.cs
index 84437fa15..90344edf1 100644
--- a/src/Auth0.ManagementApi/Clients/EmailProviderClient.cs
+++ b/src/Auth0.ManagementApi/Clients/EmailProviderClient.cs
@@ -5,7 +5,9 @@
 
 namespace Auth0.ManagementApi.Clients
 {
-    /// <inheritdoc />
+    /// <summary>
+    /// Contains all the methods to call the /emails/provider endpoints.
+    /// </summary
     public class EmailProviderClient : ClientBase
     {
         /// <summary>
@@ -33,7 +35,7 @@ public Task<EmailProvider> ConfigureAsync(EmailProviderConfigureRequest request)
         /// <summary>
         /// Deletes the email provider.
         /// </summary>
-        /// <returns></returns>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteAsync()
         {
             return Connection.DeleteAsync<object>("emails/provider", null, null);
diff --git a/src/Auth0.ManagementApi/Clients/EmailTemplatesClient.cs b/src/Auth0.ManagementApi/Clients/EmailTemplatesClient.cs
index 8c9098466..66b6cbf8d 100644
--- a/src/Auth0.ManagementApi/Clients/EmailTemplatesClient.cs
+++ b/src/Auth0.ManagementApi/Clients/EmailTemplatesClient.cs
@@ -24,10 +24,10 @@ public EmailTemplatesClient(IApiConnection connection)
         }
 
         /// <summary>
-        /// Creates a new email template
+        /// Creates a new email template.
         /// </summary>
-        /// <param name="request">The <see cref="EmailTemplateCreateRequest"/> containing details of the template to create</param>
-        /// <returns></returns>
+        /// <param name="request">The <see cref="EmailTemplateCreateRequest"/> containing details of the template to create.</param>
+        /// <returns>The newly created <see cref="EmailTemplate"/>.</returns>
         public Task<EmailTemplate> CreateAsync(EmailTemplateCreateRequest request)
         {
             return Connection.PostAsync<EmailTemplate>("email-templates", request, null, null, null, null, null);
@@ -36,8 +36,8 @@ public Task<EmailTemplate> CreateAsync(EmailTemplateCreateRequest request)
         /// <summary>
         /// Gets an email template.
         /// </summary>
-        /// <param name="templateName">The name of template you wish to retrieve</param>
-        /// <returns></returns>
+        /// <param name="templateName">The name of email template you wish to retrieve.</param>
+        /// <returns>The <see cref="EmailTemplate"/> that was requested.</returns>
         public Task<EmailTemplate> GetAsync(EmailTemplateName templateName)
         {
             return Connection.GetAsync<EmailTemplate>("email-templates/{templateName}",
@@ -48,11 +48,11 @@ public Task<EmailTemplate> GetAsync(EmailTemplateName templateName)
         }
 
         /// <summary>
-        /// Updates an email template
+        /// Updates an email template.
         /// </summary>
-        /// <param name="templateName">The name of the template to update</param>
-        /// <param name="request">The <see cref="EmailTemplatePatchRequest"/> containing details of the template to patch</param>
-        /// <returns></returns>
+        /// <param name="templateName">The name of the email template to update.</param>
+        /// <param name="request">The <see cref="EmailTemplatePatchRequest"/> containing details of the template to patch.</param>
+        /// <returns>The newly updated <see cref="EmailTemplate"/>.</returns>
         public Task<EmailTemplate> PatchAsync(EmailTemplateName templateName, EmailTemplatePatchRequest request)
         {
             return Connection.PatchAsync<EmailTemplate>("email-templates/{templateName}", request, new Dictionary<string, string>
@@ -62,11 +62,11 @@ public Task<EmailTemplate> PatchAsync(EmailTemplateName templateName, EmailTempl
         }
 
         /// <summary>
-        /// Updates an email template
+        /// Updates an email template.
         /// </summary>
-        /// <param name="templateName">The name of the template to patch</param>
-        /// <param name="request">The <see cref="EmailTemplateUpdateRequest"/> containing details of the template to update</param>
-        /// <returns></returns>
+        /// <param name="templateName">The name of the email template to patch.</param>
+        /// <param name="request">The <see cref="EmailTemplateUpdateRequest"/> containing details of the template to update.</param>
+        /// <returns>The newly updated <see cref="EmailTemplate"/>.</returns>
         public Task<EmailTemplate> UpdateAsync(EmailTemplateName templateName, EmailTemplateUpdateRequest request)
         {
             return Connection.PutAsync<EmailTemplate>("email-templates/{templateName}", request, null, null, new Dictionary<string, string>
diff --git a/src/Auth0.ManagementApi/Clients/GuardianClient.cs b/src/Auth0.ManagementApi/Clients/GuardianClient.cs
index b37294ab1..0d3bec51d 100644
--- a/src/Auth0.ManagementApi/Clients/GuardianClient.cs
+++ b/src/Auth0.ManagementApi/Clients/GuardianClient.cs
@@ -39,7 +39,7 @@ public Task<CreateGuardianEnrollmentTicketResponse> CreateEnrollmentTicketAsync(
         /// Deletes an enrollment.
         /// </summary>
         /// <param name="id">The ID of the enrollment to delete.</param>
-        /// <returns>A <see cref="Task"/> that completes when the delete is completed.</returns>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteEnrollmentAsync(string id)
         {
             return Connection
diff --git a/src/Auth0.ManagementApi/Clients/JobsClient.cs b/src/Auth0.ManagementApi/Clients/JobsClient.cs
index 74835cdfa..e721a2a62 100644
--- a/src/Auth0.ManagementApi/Clients/JobsClient.cs
+++ b/src/Auth0.ManagementApi/Clients/JobsClient.cs
@@ -6,7 +6,9 @@
 
 namespace Auth0.ManagementApi.Clients
 {
-    /// <inheritdoc />
+    /// <summary>
+    /// Contains all the methods to call the /jobs endpoints.
+    /// </summary>
     public class JobsClient : ClientBase
     {
         /// <summary>
@@ -45,8 +47,8 @@ public Task<Job> GetAsync(string id)
         /// <param name="connectionId">The connection identifier.</param>
         /// <param name="fileName">Name of the file.</param>
         /// <param name="file">The file.</param>
-        /// <param name="upsert">Update the user if already exists</param>
-        /// <param name="externalId">Customer defined id</param>
+        /// <param name="upsert">Whether to update the user if already exists.</param>
+        /// <param name="externalId">Customer defined id.</param>
         /// <returns>A <see cref="Job"/> instance containing the information about the job.</returns>
         public Task<Job> ImportUsersAsync(string connectionId, string fileName, Stream file, bool? upsert = null, string externalId = null)
         {
diff --git a/src/Auth0.ManagementApi/Clients/ResourceServersClient.cs b/src/Auth0.ManagementApi/Clients/ResourceServersClient.cs
index e560ec6b9..9a43adc86 100644
--- a/src/Auth0.ManagementApi/Clients/ResourceServersClient.cs
+++ b/src/Auth0.ManagementApi/Clients/ResourceServersClient.cs
@@ -21,20 +21,20 @@ public ResourceServersClient(IApiConnection connection) : base(connection)
         }
 
         /// <summary>
-        /// Creates a new resource server
+        /// Creates a new resource server.
         /// </summary>
-        /// <param name="request">Contains the information for the resource server to create</param>
-        /// <returns></returns>
+        /// <param name="request">Contains the information for the resource server to create.</param>
+        /// <returns>The newly created <see cref="ResourceServer"/>.</returns>
         public Task<ResourceServer> CreateAsync(ResourceServerCreateRequest request)
         {
             return Connection.PostAsync<ResourceServer>("resource-servers", request, null, null, null, null, null);
         }
 
         /// <summary>
-        /// Deletes a resource server
+        /// Deletes a resource server.
         /// </summary>
-        /// <param name="id">The id of the resource server to delete</param>
-        /// <returns></returns>
+        /// <param name="id">The id of the resource server to delete.</param>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteAsync(string id)
         {
             return Connection.DeleteAsync<object>("resource-servers/{id}", new Dictionary<string, string>
@@ -44,10 +44,10 @@ public Task DeleteAsync(string id)
         }
 
         /// <summary>
-        /// Get a resource server by its id
+        /// Get a resource server by its id.
         /// </summary>
-        /// <param name="id">The id of the resource server</param>
-        /// <returns>A <see cref="ResourceServer"/></returns>
+        /// <param name="id">The id of the resource server.</param>
+        /// <returns>The <see cref="ResourceServer"/> that was requested.</returns>
         public Task<ResourceServer> GetAsync(string id)
         {
             return Connection.GetAsync<ResourceServer>("resource-servers/{id}",
@@ -75,11 +75,11 @@ public Task<IPagedList<ResourceServer>> GetAllAsync(PaginationInfo pagination)
         }
 
         /// <summary>
-        /// Updates a resource server
+        /// Updates a resource server,
         /// </summary>
-        /// <param name="id">The id of the resource server to update</param>
-        /// <param name="request">Contains the information for the resource server to update</param>
-        /// <returns></returns>
+        /// <param name="id">The id of the resource server to update.</param>
+        /// <param name="request">Contains the information for the resource server to update.</param>
+        /// <returns>The newly updated <see cref="ResourceServer"/>.</returns>
         public Task<ResourceServer> UpdateAsync(string id, ResourceServerUpdateRequest request)
         {
             return Connection.PatchAsync<ResourceServer>("resource-servers/{id}", request, new Dictionary<string, string>
diff --git a/src/Auth0.ManagementApi/Clients/RolesClient.cs b/src/Auth0.ManagementApi/Clients/RolesClient.cs
index fd59f7992..af2b8f07e 100644
--- a/src/Auth0.ManagementApi/Clients/RolesClient.cs
+++ b/src/Auth0.ManagementApi/Clients/RolesClient.cs
@@ -16,7 +16,7 @@ public class RolesClient : ClientBase
         /// <summary>
         /// Initializes a new instance of the <see cref="RolesClient"/> class.
         /// </summary>
-        /// <param name="connection">The connection.</param>
+        /// <param name="connection">The <see cref="ApiConnection"/> to use.</param>
         public RolesClient(ApiConnection connection)
             : base(connection)
         {
@@ -25,7 +25,7 @@ public RolesClient(ApiConnection connection)
         /// <summary>
         /// Creates a new role according to the request.
         /// </summary>
-        /// <param name="request">The <see cref="RoleCreateRequest" /> containing the details of the role to create.</param>
+        /// <param name="request">The <see cref="RoleCreateRequest"/> containing the details of the role to create.</param>
         /// <returns>The newly created <see cref="Role" />.</returns>
         public Task<Role> CreateAsync(RoleCreateRequest request)
         {
@@ -36,7 +36,7 @@ public Task<Role> CreateAsync(RoleCreateRequest request)
         /// Deletes a role.
         /// </summary>
         /// <param name="id">The ID of the role to delete.</param>
-        /// <returns>Task.</returns>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteAsync(string id)
         {
             return Connection.DeleteAsync<object>("roles/{id}", new Dictionary<string, string>
@@ -45,7 +45,11 @@ public Task DeleteAsync(string id)
             }, null);
         }
 
-        /// <inheritdoc />
+        /// <summary>
+        /// Retrieves a list of all roles.
+        /// </summary>
+        /// <param name="request">Specifies criteria to use when querying roles.</param>
+        /// <returns>An <see cref="IPagedList{Role}"/> containing the roles</returns>
         public Task<IPagedList<Role>> GetAllAsync(GetRolesRequest request)
         {
             if (request == null)
@@ -58,7 +62,12 @@ public Task<IPagedList<Role>> GetAllAsync(GetRolesRequest request)
                 }, null, new PagedListConverter<Role>("roles"));
         }
 
-        /// <inheritdoc />
+        /// <summary>
+        /// Retrieves a list of all roles.
+        /// </summary>
+        /// <param name="request">Specifies criteria to use when querying roles.</param>
+        /// <param name="pagination">Specifies pagination info to use when requesting paged results.</param>
+        /// <returns>An <see cref="IPagedList{Role}"/> containing the roles requested.</returns>
         public Task<IPagedList<Role>> GetAllAsync(GetRolesRequest request, PaginationInfo pagination)
         {
             if (request == null)
@@ -76,7 +85,11 @@ public Task<IPagedList<Role>> GetAllAsync(GetRolesRequest request, PaginationInf
                 }, null, new PagedListConverter<Role>("roles"));
         }
 
-        /// <inheritdoc />
+        /// <summary>
+        /// Retrieves a role by its ID.
+        /// </summary>
+        /// <param name="id">The ID of the role to retrieve.</param>
+        /// <returns>The <see cref="Role"/> that was requested.</returns>
         public Task<Role> GetAsync(string id)
         {
             return Connection.GetAsync<Role>("roles/{id}",
@@ -86,7 +99,12 @@ public Task<Role> GetAsync(string id)
                 }, null, null, null);
         }
 
-        /// <inheritdoc />
+        /// <summary>
+        /// Updates a role.
+        /// </summary>
+        /// <param name="id">The ID of the role to update.</param>
+        /// <param name="request">A <see cref="RoleUpdateRequest" /> containing the information to update.</param>
+        /// <returns>The newly updated <see cref="Role"/>.</returns>
         public Task<Role> UpdateAsync(string id, RoleUpdateRequest request)
         {
             return Connection.PatchAsync<Role>("roles/{id}", request, new Dictionary<string, string>
@@ -95,7 +113,11 @@ public Task<Role> UpdateAsync(string id, RoleUpdateRequest request)
             });
         }
 
-        /// <inheritdoc />
+        /// <summary>
+        /// Retrieves a list of users associated with a role.
+        /// </summary>
+        /// <param name="id">The ID of the role to query.</param>
+        /// <returns>An <see cref="IPagedList{AssignedUser}"/> containing the assigned users.</returns>
         public Task<IPagedList<AssignedUser>> GetUsersAsync(string id)
         {
             return Connection.GetAsync<IPagedList<AssignedUser>>("roles/{id}/users",
@@ -105,7 +127,12 @@ public Task<IPagedList<AssignedUser>> GetUsersAsync(string id)
                 }, null, null, new PagedListConverter<AssignedUser>("users"));
         }
 
-        /// <inheritdoc />
+        /// <summary>
+        /// Retrieves a list of users associated with a role.
+        /// </summary>
+        /// <param name="id">The ID of the role to query.</param>
+        /// <param name="pagination">Specifies <see cref="PaginationInfo"/> to use in requesting paged results.</param>
+        /// <returns>An <see cref="IPagedList{AssignedUser}"/> containing the assigned user.</returns>
         public Task<IPagedList<AssignedUser>> GetUsersAsync(string id, PaginationInfo pagination)
         {
             return Connection.GetAsync<IPagedList<AssignedUser>>("roles/{id}/users",
@@ -118,7 +145,12 @@ public Task<IPagedList<AssignedUser>> GetUsersAsync(string id, PaginationInfo pa
                 }, null, null, new PagedListConverter<AssignedUser>("users"));
         }
 
-        /// <inheritdoc />
+        /// <summary>
+        /// Assigns Users to a role.
+        /// </summary>
+        /// <param name="id">The ID of the role to assign users to.</param>
+        /// <param name="request">A <see cref="AssignUsersRequest" /> containing the user IDs to assign to the role.</param>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous assign operation.</returns>
         public Task AssignUsersAsync(string id, AssignUsersRequest request)
         {
             return Connection.PostAsync<AssignUsersRequest>("roles/{id}/users", request, null, null,
diff --git a/src/Auth0.ManagementApi/Clients/RulesClient.cs b/src/Auth0.ManagementApi/Clients/RulesClient.cs
index 7a114d59b..c70d99c41 100644
--- a/src/Auth0.ManagementApi/Clients/RulesClient.cs
+++ b/src/Auth0.ManagementApi/Clients/RulesClient.cs
@@ -36,6 +36,7 @@ public Task<Rule> CreateAsync(RuleCreateRequest request)
         /// Deletes a rule.
         /// </summary>
         /// <param name="id">The ID of the rule to delete.</param>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteAsync(string id)
         {
             return Connection.DeleteAsync<object>("rules/{id}",
@@ -50,7 +51,7 @@ public Task DeleteAsync(string id)
         /// </summary>
         /// <param name="request">Specifies criteria to use when querying rules.</param>
         /// <param name="pagination">Specifies pagination info to use when requesting paged results.</param>
-        /// <returns>An <see cref="IPagedList{Rule}"/> containing the rules</returns>
+        /// <returns>An <see cref="IPagedList{Rule}"/> containing the rules requested.</returns>
         public Task<IPagedList<Rule>> GetAllAsync(GetRulesRequest request, PaginationInfo pagination)
         {
             if (request == null)
@@ -83,7 +84,7 @@ public Task<IPagedList<Rule>> GetAllAsync(GetRulesRequest request, PaginationInf
         /// True if the fields specified are to be included in the result, false otherwise (defaults to
         /// true).
         /// </param>
-        /// <returns>The <see cref="Rule" />.</returns>
+        /// <returns>The <see cref="Rule" /> that was requested.</returns>
         public Task<Rule> GetAsync(string id, string fields = null, bool includeFields = true)
         {
             return Connection.GetAsync<Rule>("rules/{id}",
@@ -103,7 +104,7 @@ public Task<Rule> GetAsync(string id, string fields = null, bool includeFields =
         /// </summary>
         /// <param name="id">The ID of the rule to update.</param>
         /// <param name="request">A <see cref="RuleUpdateRequest" /> containing the information to update.</param>
-        /// <returns></returns>
+        /// <returns>The newly updated <see cref="Rule"/>.</returns>
         public Task<Rule> UpdateAsync(string id, RuleUpdateRequest request)
         {
             return Connection.PatchAsync<Rule>("rules/{id}", request, new Dictionary<string, string>
diff --git a/src/Auth0.ManagementApi/Clients/TenantSettingsClient.cs b/src/Auth0.ManagementApi/Clients/TenantSettingsClient.cs
index d3116418a..5d4967aff 100644
--- a/src/Auth0.ManagementApi/Clients/TenantSettingsClient.cs
+++ b/src/Auth0.ManagementApi/Clients/TenantSettingsClient.cs
@@ -23,12 +23,12 @@ public TenantSettingsClient(IApiConnection connection)
         /// Gets the settings for the tenant.
         /// </summary>
         /// <param name="fields">
-        /// A comma separated list of fields to include or exclude (depending on includeFields) from the
-        /// result, empty to retrieve all fields
+        /// A comma-separated list of fields to include or exclude (depending on includeFields) from the
+        /// result, empty to retrieve all fields.
         /// </param>
         /// <param name="includeFields">
         /// <see cref="true"/> if the fields specified are to be included in the result, <see cref="false"/> otherwise (defaults to
-        /// <see cref="true"/>)
+        /// <see cref="true"/>).
         /// </param>
         /// <returns>A <see cref="TenantSettings" /> containing the settings for the tenant.</returns>
         public Task<TenantSettings> GetAsync(string fields = null, bool includeFields = true)
diff --git a/src/Auth0.ManagementApi/Clients/TicketsClient.cs b/src/Auth0.ManagementApi/Clients/TicketsClient.cs
index 00c4a62d7..38d2b44e0 100644
--- a/src/Auth0.ManagementApi/Clients/TicketsClient.cs
+++ b/src/Auth0.ManagementApi/Clients/TicketsClient.cs
@@ -22,7 +22,7 @@ public TicketsClient(IApiConnection connection)
         /// Creates an email verification ticket.
         /// </summary>
         /// <param name="request">The <see cref="EmailVerificationTicketRequest"/> containing the details of the ticket to create.</param>
-        /// <returns>The <see cref="Ticket"/>.</returns>
+        /// <returns>The newly created <see cref="Ticket"/>.</returns>
         public Task<Ticket> CreateEmailVerificationTicketAsync(EmailVerificationTicketRequest request)
         {
             return Connection.PostAsync<Ticket>("tickets/email-verification", request, null, null, null, null, null);
@@ -32,7 +32,7 @@ public Task<Ticket> CreateEmailVerificationTicketAsync(EmailVerificationTicketRe
         /// Creates a password change ticket.
         /// </summary>
         /// <param name="request">The <see cref="PasswordChangeTicketRequest"/> containing the details of the ticket to create.</param>
-        /// <returns>The <see cref="Ticket"/>.</returns>
+        /// <returns>The newly created <see cref="Ticket"/>.</returns>
         public Task<Ticket> CreatePasswordChangeTicketAsync(PasswordChangeTicketRequest request)
         {
             return Connection.PostAsync<Ticket>("tickets/password-change", request, null, null, null, null, null);
diff --git a/src/Auth0.ManagementApi/Clients/UserBlocksClient.cs b/src/Auth0.ManagementApi/Clients/UserBlocksClient.cs
index 951bcc9dc..f5e8cc162 100644
--- a/src/Auth0.ManagementApi/Clients/UserBlocksClient.cs
+++ b/src/Auth0.ManagementApi/Clients/UserBlocksClient.cs
@@ -6,7 +6,7 @@
 namespace Auth0.ManagementApi.Clients
 {
     /// <summary>
-    /// Contains all the methods for the /user-blocks endpoints
+    /// Contains all the methods for the /user-blocks endpoints.
     /// </summary>
     public class UserBlocksClient : ClientBase
     {
@@ -22,8 +22,8 @@ public UserBlocksClient(IApiConnection connection)
         /// <summary>
         /// Get a user's blocks by identifier.
         /// </summary>
-        /// <param name="identifier">The identifier of the user. Can be a user's email address, username or phone number</param>
-        /// <returns></returns>
+        /// <param name="identifier">The identifier of the user. Can be a user's email address, username or phone number.</param>
+        /// <returns>The <see cref="UserBlocks"/> relating to the user requested.</returns>
         public Task<UserBlocks> GetByIdentifierAsync(string identifier)
         {
             return Connection.GetAsync<UserBlocks>("user-blocks",
@@ -37,8 +37,8 @@ public Task<UserBlocks> GetByIdentifierAsync(string identifier)
         /// <summary>
         /// Get a user's blocks by user id.
         /// </summary>
-        /// <param name="id">The id of the user</param>
-        /// <returns></returns>
+        /// <param name="id">The id of the user.</param>
+        /// <returns>The <see cref="UserBlocks"/> relating to the user requested.</returns>
         public Task<UserBlocks> GetByUserIdAsync(string id)
         {
             return Connection.GetAsync<UserBlocks>("user-blocks/{id}",
@@ -52,8 +52,8 @@ public Task<UserBlocks> GetByUserIdAsync(string id)
         /// <summary>
         /// Unblock a user by their identifier.
         /// </summary>
-        /// <param name="identifier">The identifier of the user. Can be a user's email address, username or phone number</param>
-        /// <returns></returns>
+        /// <param name="identifier">The identifier of the user to unblock. Can be a user's email address, username or phone number.</param>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous unblock operation.</returns>
         public Task UnblockByIdentifierAsync(string identifier)
         {
             return Connection.DeleteAsync<object>("user-blocks",
@@ -67,8 +67,8 @@ public Task UnblockByIdentifierAsync(string identifier)
         /// <summary>
         /// Unblock a user by their id.
         /// </summary>
-        /// <param name="id">The id of the user</param>
-        /// <returns></returns>
+        /// <param name="id">The id of the user to unblock.</param>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous unblock operation.</returns>
         public Task UnblockByUserIdAsync(string id)
         {
             return Connection.DeleteAsync<object>("user-blocks/{id}", 
diff --git a/src/Auth0.ManagementApi/Clients/UsersClient.cs b/src/Auth0.ManagementApi/Clients/UsersClient.cs
index dc7a0d69d..3984bc094 100644
--- a/src/Auth0.ManagementApi/Clients/UsersClient.cs
+++ b/src/Auth0.ManagementApi/Clients/UsersClient.cs
@@ -27,7 +27,7 @@ public UsersClient(ApiConnection connection)
         /// </summary>
         /// <param name="id">The ID of the user to assign roles to.</param>
         /// <param name="request">A <see cref="AssignRolesRequest" /> containing the role IDs to assign to the user.</param>
-        /// <returns></returns>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous assign operation.</returns>
         public Task AssignRolesAsync(string id, AssignRolesRequest request)
         {
             return Connection.PostAsync<AssignRolesRequest>("users/{id}/roles", request, null, null,
@@ -41,7 +41,7 @@ public Task AssignRolesAsync(string id, AssignRolesRequest request)
         /// Creates a new user.
         /// </summary>
         /// <param name="request">The <see cref="UserCreateRequest" /> containing the properties of the user to create.</param>
-        /// <returns></returns>
+        /// <returns>The newly created <see cref="User"/>.</returns>
         public Task<User> CreateAsync(UserCreateRequest request)
         {
             return Connection.PostAsync<User>("users", request, null, null, null, null, null);
@@ -51,6 +51,7 @@ public Task<User> CreateAsync(UserCreateRequest request)
         /// Deletes a user.
         /// </summary>
         /// <param name="id">The id of the user to delete.</param>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteAsync(string id)
         {
             if (string.IsNullOrWhiteSpace(id))
@@ -67,8 +68,8 @@ public Task DeleteAsync(string id)
         /// Deletes a user's multifactor provider.
         /// </summary>
         /// <param name="id">The id of the user who multi factor provider to delete.</param>
-        /// <param name="provider">The type of the multifactor provider. Supported values 'duo' or 'google-authenticator'</param>
-        /// <returns></returns>
+        /// <param name="provider">The type of the multifactor provider. Supported values 'duo' or 'google-authenticator'.</param>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous delete operation.</returns>
         public Task DeleteMultifactorProviderAsync(string id, string provider)
         {
             return Connection.DeleteAsync<object>("users/{id}/multifactor/{provider}",
@@ -119,7 +120,7 @@ public Task<IPagedList<User>> GetAllAsync(GetUsersRequest request, PaginationInf
         /// true if the fields specified are to be included in the result, false otherwise (defaults to
         /// true)
         /// </param>
-        /// <returns>The <see cref="User" />.</returns>
+        /// <returns>The <see cref="User"/> that was requested.</returns>
         public Task<User> GetAsync(string id, string fields = null, bool includeFields = true)
         {
             return Connection.GetAsync<User>("users/{id}",
@@ -164,7 +165,7 @@ public Task<IPagedList<LogEntry>> GetLogsAsync(GetUserLogsRequest request, Pagin
         /// <summary>
         /// Retrieve assigned roles for a specific user.
         /// </summary>
-        /// <param name="userId">The user id of the roles to retrieve</param>
+        /// <param name="userId">The user id of the roles to retrieve.</param>
         /// <param name="pagination">Specifies pagination info to use when requesting paged results.</param>
         /// <returns>An <see cref="IPagedList{Role}"/> containing the roles for the user.</returns>
         public Task<IPagedList<Role>> GetRolesAsync(string userId, PaginationInfo pagination)
@@ -188,10 +189,10 @@ public Task<IPagedList<Role>> GetRolesAsync(string userId, PaginationInfo pagina
         /// <summary>
         /// Gets all users by email address.
         /// </summary>
-        /// <param name="email">The email address to search for</param>
-        /// <param name="fields"> A comma separated list of fields to include or exclude (depending on <see cref="includeFields"/>) from the result, null to retrieve all fields</param>
-        /// <param name="includeFields">true if the fields specified are to be included in the result, false otherwise. Defaults to true</param>
-        /// <returns></returns>
+        /// <param name="email">The email address to search for.</param>
+        /// <param name="fields"> A comma separated list of fields to include or exclude (depending on <see cref="includeFields"/>) from the result, null to retrieve all fields.</param>
+        /// <param name="includeFields">true if the fields specified are to be included in the result, false otherwise. Defaults to true.</param>
+        /// <returns>A <see cref="IList{User}"/> containing all users for this email address.</returns>
         public Task<IList<User>> GetUsersByEmailAsync(string email, string fields = null, bool? includeFields = null)
         {
             return Connection.GetAsync<IList<User>>("users-by-email", null,
@@ -208,7 +209,7 @@ public Task<IList<User>> GetUsersByEmailAsync(string email, string fields = null
         /// </summary>
         /// <param name="id">The ID of the primary account.</param>
         /// <param name="request">The <see cref="UserAccountLinkRequest" /> containing details of the secondary account to link.</param>
-        /// <returns></returns>
+        /// <returns>A <see cref="IList{AccountLinkResponse}"/> containing details about this account link.</returns>
         public Task<IList<AccountLinkResponse>> LinkAccountAsync(string id, UserAccountLinkRequest request)
         {
             return Connection.PostAsync<IList<AccountLinkResponse>>("users/{id}/identities", request, null, null, new Dictionary<string, string>
@@ -223,7 +224,7 @@ public Task<IList<AccountLinkResponse>> LinkAccountAsync(string id, UserAccountL
         /// <param name="id">The ID of the primary account.</param>
         /// <param name="primaryJwtToken">The JWT of the primary account.</param>
         /// <param name="secondaryJwtToken">The JWT for the secondary account you wish to link.</param>
-        /// <returns></returns>
+        /// <returns>A <see cref="IList{AccountLinkResponse}"/> containing details about this account link.</returns>
         public Task<IList<AccountLinkResponse>> LinkAccountAsync(string id, string primaryJwtToken, string secondaryJwtToken)
         {
             var request = new UserAccountJwtLinkRequest
@@ -245,7 +246,7 @@ public Task<IList<AccountLinkResponse>> LinkAccountAsync(string id, string prima
         /// </summary>
         /// <param name="id">The ID of the user to remove roles from.</param>
         /// <param name="request">A <see cref="AssignRolesRequest" /> containing the role IDs to remove to the user.</param>
-        /// <returns></returns>
+        /// <returns>A <see cref="Task"/> that represents the asynchronous remove operation.</returns>
         public Task RemoveRolesAsync(string id, AssignRolesRequest request)
         {
             return Connection.DeleteAsync<object>("users/{id}/roles", request, new Dictionary<string, string>
@@ -260,8 +261,8 @@ public Task RemoveRolesAsync(string id, AssignRolesRequest request)
         /// </summary>
         /// <param name="primaryUserId">The ID of the primary account.</param>
         /// <param name="provider">The type of the identity provider.</param>
-        /// <param name="secondaryUserId">The ID for the secondary account</param>
-        /// <returns></returns>
+        /// <param name="secondaryUserId">The ID for the secondary account.</param>
+        /// <returns>A <see cref="IList{AccountLinkResponse}"/> containing details about this account link.</returns>
         public Task<IList<AccountLinkResponse>> UnlinkAccountAsync(string primaryUserId, string provider, string secondaryUserId)
         {
             return Connection.DeleteAsync<IList<AccountLinkResponse>>("users/{id}/identities/{provider}/{secondaryid}", new Dictionary<string, string>
@@ -277,7 +278,7 @@ public Task<IList<AccountLinkResponse>> UnlinkAccountAsync(string primaryUserId,
         /// </summary>
         /// <param name="id">The id of the user to update.</param>
         /// <param name="request">The <see cref="UserUpdateRequest" /> containing the information you wish to update.</param>
-        /// <returns></returns>
+        /// <returns>The newly updated <see cref="User"/>.</returns>
         public Task<User> UpdateAsync(string id, UserUpdateRequest request)
         {
             return Connection.PatchAsync<User>("users/{id}", request, new Dictionary<string, string>
diff --git a/src/Auth0.ManagementApi/ManagementApiClient.cs b/src/Auth0.ManagementApi/ManagementApiClient.cs
index 989c8d4ac..76df085dc 100644
--- a/src/Auth0.ManagementApi/ManagementApiClient.cs
+++ b/src/Auth0.ManagementApi/ManagementApiClient.cs
@@ -144,9 +144,9 @@ private ManagementApiClient(string token, Uri baseUri, ApiConnection apiConnecti
         /// <summary>
         /// Initializes a new instance of the <see cref="ManagementApiClient"/> class.
         /// </summary>
-        /// <param name="token">The token.</param>
-        /// <param name="baseUri">The base URI.</param>
-        /// <param name="handler">The <see cref="HttpMessageHandler"/> which is used for HTTP requests</param>
+        /// <param name="token">A valid Auth0 Management API v2 token.</param>
+        /// <param name="baseUrl">The URL of the tenant to manage.</param>
+        /// <param name="handler">The <see cref="HttpMessageHandler"/> which is used for HTTP requests.</param>
         public ManagementApiClient(string token, Uri baseUri, HttpMessageHandler handler)
             : this(token, baseUri, new ApiConnection(token, baseUri.AbsoluteUri, handler))
         {
@@ -155,9 +155,9 @@ public ManagementApiClient(string token, Uri baseUri, HttpMessageHandler handler
         /// <summary>
         /// Initializes a new instance of the <see cref="ManagementApiClient"/> class.
         /// </summary>
-        /// <param name="token">The token.</param>
-        /// <param name="baseUri">The base URI.</param>
-        /// <param name="httpClient">The <see cref="HttpClient"/> which is used for HTTP requests</param>
+        /// <param name="token">A valid Auth0 Management API v2 token.</param>
+        /// <param name="baseUrl">The URL of the tenant to manage.</param>
+        /// <param name="httpClient">The <see cref="HttpClient"/> which is used for HTTP requests.</param>
         public ManagementApiClient(string token, Uri baseUri, HttpClient httpClient)
             : this(token, baseUri, new ApiConnection(token, baseUri.AbsoluteUri, httpClient))
         {
@@ -166,8 +166,8 @@ public ManagementApiClient(string token, Uri baseUri, HttpClient httpClient)
         /// <summary>
         /// Initializes a new instance of the <see cref="ManagementApiClient"/> class.
         /// </summary>
-        /// <param name="token">The token.</param>
-        /// <param name="baseUri">The base URI.</param>
+        /// <param name="token">A valid Auth0 Management API v2 token.</param>
+        /// <param name="baseUrl">The URL of the tenant to manage.</param>
         public ManagementApiClient(string token, Uri baseUri)
             : this(token, baseUri, (HttpMessageHandler)null)
         {
@@ -176,9 +176,9 @@ public ManagementApiClient(string token, Uri baseUri)
         /// <summary>
         /// Initializes a new instance of the <see cref="ManagementApiClient"/> class.
         /// </summary>
-        /// <param name="token">The token.</param>
-        /// <param name="domain">Your Auth0 domain, e.g. tenant.auth0.com.</param>
-        /// <param name="handler">The <see cref="HttpMessageHandler"/> which is used for HTTP requests</param>
+        /// <param name="token">A valid Auth0 Management API v2 token.</param>
+        /// <param name="domain">Your Auth0 domain. <example>tenant.auth0.com</example></param>
+        /// <param name="handler">The <see cref="HttpMessageHandler"/> which is used for HTTP requests.</param>
         public ManagementApiClient(string token, string domain, HttpMessageHandler handler)
             : this(token, new Uri($"https://{domain}/api/v2"), handler)
         {
@@ -187,9 +187,9 @@ public ManagementApiClient(string token, string domain, HttpMessageHandler handl
         /// <summary>
         /// Initializes a new instance of the <see cref="ManagementApiClient"/> class.
         /// </summary>
-        /// <param name="token">The token.</param>
-        /// <param name="domain">Your Auth0 domain, e.g. tenant.auth0.com.</param>
-        /// <param name="httpClient">The <see cref="HttpClient"/> which is used for HTTP requests</param>
+        /// <param name="token">A valid Auth0 Management API v2 token.</param>
+        /// <param name="domain">Your Auth0 domain. <example>tenant.auth0.com</example></param>
+        /// <param name="httpClient">The <see cref="HttpClient"/> which is used for HTTP requests.</param>
         public ManagementApiClient(string token, string domain, HttpClient httpClient)
             : this(token, new Uri($"https://{domain}/api/v2"), httpClient)
         {