Add comments to methods in IWebHookService

src/Umbraco.Core/Services/IWebHookService.cs

@@ -1,18 +1,40 @@
-using Umbraco.Cms.Core.Models;
+using Umbraco.Cms.Core.Models;
 
 namespace Umbraco.Cms.Core.Services;
 
 public interface IWebHookService
 {
+    /// <summary>
+    ///     Creates a webhook.
+    /// </summary>
+    /// <param name="webhook"><see cref="Webhook" /> to create.</param>
     Task<Webhook> CreateAsync(Webhook webhook);
 
+    /// <summary>
+    ///     Updates a webhook.
+    /// </summary>
+    /// <param name="webhook"><see cref="Webhook" /> to update.</param>
     Task UpdateAsync(Webhook webhook);
 
+    /// <summary>
+    ///     Deletes a webhook.
+    /// </summary>
+    /// <param name="key">The unique key of the webhook.</param>
     Task DeleteAsync(Guid key);
 
+    /// <summary>
+    ///     Gets a webhook by its key.
+    /// </summary>
+    /// <param name="key">The unique key of the webhook.</param>
     Task<Webhook?> GetAsync(Guid key);
 
+    /// <summary>
+    ///     Gets all webhooks.
+    /// </summary>
     Task<PagedModel<Webhook>> GetAllAsync(int skip, int take);
 
+    /// <summary>
+    ///     Gets webhooks by event name.
+    /// </summary>
     Task<IEnumerable<Webhook>> GetByEventNameAsync(string eventName);
 }

src/Umbraco.Core/Services/WebhookService.cs

@@ -1,4 +1,4 @@
-using Umbraco.Cms.Core.Models;
+using Umbraco.Cms.Core.Models;
 using Umbraco.Cms.Core.Persistence.Repositories;
 using Umbraco.Cms.Core.Scoping;
 
@@ -15,6 +15,7 @@ public WebhookService(ICoreScopeProvider provider, IWebhookRepository webhookRep
         _webhookRepository = webhookRepository;
     }
 
+    /// <inheritdoc />
     public async Task<Webhook> CreateAsync(Webhook webhook)
     {
         using ICoreScope scope = _provider.CreateCoreScope();
@@ -24,6 +25,7 @@ public async Task<Webhook> CreateAsync(Webhook webhook)
         return created;
     }
 
+    /// <inheritdoc />
     public async Task UpdateAsync(Webhook webhook)
     {
         using ICoreScope scope = _provider.CreateCoreScope();
@@ -45,6 +47,7 @@ public async Task UpdateAsync(Webhook webhook)
         scope.Complete();
     }
 
+    /// <inheritdoc />
     public async Task DeleteAsync(Guid key)
     {
         using ICoreScope scope = _provider.CreateCoreScope();
@@ -57,6 +60,7 @@ public async Task DeleteAsync(Guid key)
         scope.Complete();
     }
 
+    /// <inheritdoc />
     public async Task<Webhook?> GetAsync(Guid key)
     {
         using ICoreScope scope = _provider.CreateCoreScope();
@@ -65,6 +69,7 @@ public async Task DeleteAsync(Guid key)
         return webhook;
     }
 
+    /// <inheritdoc />
     public async Task<PagedModel<Webhook>> GetAllAsync(int skip, int take)
     {
         using ICoreScope scope = _provider.CreateCoreScope();
@@ -74,6 +79,7 @@ public async Task<PagedModel<Webhook>> GetAllAsync(int skip, int take)
         return webhooks;
     }
 
+    /// <inheritdoc />
     public async Task<IEnumerable<Webhook>> GetByEventNameAsync(string eventName)
     {
         using ICoreScope scope = _provider.CreateCoreScope();