Add xml document comments

Author: KoditkarVedant

Src/Notion.Client/Api/Databases/IDatabasesClient.cs

@@ -4,22 +4,36 @@ namespace Notion.Client
 {
     public interface IDatabasesClient
     {
+        /// <summary>
+        /// Retrieves a Database object using the ID specified.
+        /// </summary>
+        /// <param name="databaseId">Identifier for a Notion database</param>
+        /// <returns><see cref="Database"/></returns>
         Task<Database> RetrieveAsync(string databaseId);
+
+        /// <summary>
+        /// Gets a list of Pages contained in the database, filtered and ordered according to the 
+        /// filter conditions and sort criteria provided in the request. The response may contain 
+        /// fewer than <c>page_size</c> of results.
+        /// </summary>
+        /// <param name="databaseId"></param>
+        /// <param name="databasesQueryParameters"></param>
+        /// <returns><see cref="PaginatedList{T}"/></returns>
         Task<PaginatedList<Page>> QueryAsync(string databaseId, DatabasesQueryParameters databasesQueryParameters);
 
         /// <summary>
         /// Creates a database as a subpage in the specified parent page, with the specified properties schema.
         /// </summary>
         /// <param name="databasesCreateParameters"></param>
-        /// <returns>Database</returns>
+        /// <returns><see cref="Database"/></returns>
         Task<Database> CreateAsync(DatabasesCreateParameters databasesCreateParameters);
 
         /// <summary>
         /// Updates an existing database as specified by the parameters.
         /// </summary>
         /// <param name="databaseId"></param>
         /// <param name="databasesUpdateParameters"></param>
-        /// <returns>Database</returns>
+        /// <returns><see cref="Database"/></returns>
         Task<Database> UpdateAsync(string databaseId, DatabasesUpdateParameters databasesUpdateParameters);
     }
 }

Src/Notion.Client/Api/Pages/IPagesClient.cs

@@ -13,11 +13,23 @@ public interface IPagesClient
         /// If the parent is a page, the only valid property is <strong>title</strong>.
         /// </summary>
         /// <param name="pagesCreateParameters">Create page parameters</param>
-        /// <returns>Created page.</returns>
+        /// <returns>Created <see cref="Page"/> object.</returns>
         Task<Page> CreateAsync(PagesCreateParameters pagesCreateParameters);
 
+        /// <summary>
+        /// Retrieves a Page object using the ID specified.
+        /// </summary>
+        /// <param name="pageId">Identifier for a Notion page</param>
+        /// <returns><see cref="Page"/></returns>
         Task<Page> RetrieveAsync(string pageId);
 
+        /// <summary>
+        /// Updates page property values for the specified page. 
+        /// Note: Properties that are not set via the properties parameter will remain unchanged.
+        /// </summary>
+        /// <param name="pageId">Identifier for a Notion page</param>
+        /// <param name="updatedProperties">Property values to update for this page. The keys are the names or IDs of the property and the values are property values.</param>
+        /// <returns>Updated <see cref="Page"/> object</returns>
         Task<Page> UpdatePropertiesAsync(
             string pageId,
             IDictionary<string, PropertyValue> updatedProperties
@@ -27,15 +39,15 @@ IDictionary<string, PropertyValue> updatedProperties
         /// Updates page property values for the specified page. 
         /// Properties that are not set via the properties parameter will remain unchanged.
         /// </summary>
-        /// <param name="pageId"></param>
-        /// <param name="pagesUpdateParameters"></param>
-        /// <returns>Updated page.</returns>
+        /// <param name="pageId">Identifier for a Notion page</param>
+        /// <param name="pagesUpdateParameters">Update property parameters</param>
+        /// <returns>Updated <see cref="Page"/> object</returns>
         Task<Page> UpdateAsync(string pageId, PagesUpdateParameters pagesUpdateParameters);
 
         /// <summary>
         /// Retrieves a property_item object for a given pageId and propertyId. Depending on the property type, the object returned will either be a value or a paginated list of property item values.
         /// </summary>
-        /// <param name="retrievePropertyItemParameters">sdf sd</param>
+        /// <param name="retrievePropertyItemParameters">Property body and query parameters</param>
         /// <returns><see cref="IPropertyItemObject"/></returns>
         Task<IPropertyItemObject> RetrievePagePropertyItem(RetrievePropertyItemParameters retrievePropertyItemParameters);
     }

Src/Notion.Client/Api/Search/ISearchClient.cs

@@ -4,6 +4,13 @@ namespace Notion.Client
 {
     public interface ISearchClient
     {
+        /// <summary>
+        /// Searches all original pages, databases, and child pages/databases that are shared with the integration. 
+        /// 
+        /// It will not return linked databases, since these duplicate their source databases.
+        /// </summary>
+        /// <param name="parameters">Search filters and body parameters</param>
+        /// <returns><see cref="PaginatedList{IObject}"/></returns>
         Task<PaginatedList<IObject>> SearchAsync(SearchParameters parameters);
     }
 }

Src/Notion.Client/Api/Users/IUsersClient.cs

@@ -4,13 +4,25 @@ namespace Notion.Client
 {
     public interface IUsersClient
     {
+        /// <summary>
+        /// Retrieves a User using the ID specified.
+        /// </summary>
+        /// <param name="userId">Identifier for a Notion user</param>
+        /// <returns><see cref="User"/></returns>
         Task<User> RetrieveAsync(string userId);
+
+        /// <summary>
+        /// Returns a paginated list of Users for the workspace. 
+        /// 
+        /// The response may contain fewer than page_size of results.
+        /// </summary>
+        /// <returns><see cref="PaginatedList{User}"/></returns>
         Task<PaginatedList<User>> ListAsync();
 
         /// <summary>
         /// Retrieves the bot User associated with the API token provided in the authorization header.
         /// </summary>
-        /// <returns>User object of type bot having an owner field with information about the person who authorized the integration.</returns>
+        /// <returns><see cref="User"/> object of type bot having an owner field with information about the person who authorized the integration.</returns>
         Task<User> MeAsync();
     }
 }

Src/Notion.Client/Notion.Client.csproj

@@ -3,7 +3,7 @@
   <PropertyGroup>
     <VersionPrefix>4.0.0-preview</VersionPrefix>
     <TargetFramework>netstandard2.0</TargetFramework>
-    <LangVersion>7.3</LangVersion>
+    <LangVersion>9.0</LangVersion>
 
     <PackageId>Notion.Net</PackageId>
     <Authors>Vedant Koditkar</Authors>