Update v14 api docs with info from umbraco docs (#15977)

* update api docs

* small update

Author: alina-tincas

src/Umbraco.Core/Notifications/AssignedMemberRolesNotification.cs

@@ -1,7 +1,18 @@
 namespace Umbraco.Cms.Core.Notifications;
-
+/// <summary>
+///  A notification that is used to trigger the IMemberService when the AssignRoles and ReplaceRoles methods are called in the API.
+/// </summary>
 public class AssignedMemberRolesNotification : MemberRolesNotification
 {
+    /// <summary>
+    /// Initializes a new instance of the <see cref="AssignedMemberRolesNotification"/>.
+    /// </summary>
+    /// <param name="memberIds">
+    /// Collection of Ids of the members the roles are being assigned to.
+    /// </param>
+    /// <param name="roles">
+    /// Collection of role names being assigned.
+    /// </param>
     public AssignedMemberRolesNotification(int[] memberIds, string[] roles)
         : base(memberIds, roles)
     {

src/Umbraco.Core/Notifications/ContentCacheRefresherNotification.cs

@@ -2,8 +2,20 @@
 
 namespace Umbraco.Cms.Core.Notifications;
 
+/// <summary>
+///  A notification that is used to trigger the Content Cache Refresher.
+/// </summary>
 public class ContentCacheRefresherNotification : CacheRefresherNotification
 {
+    /// <summary>
+    ///  Initializes a new instance of the  <see cref="ContentCacheRefresherNotification"/>
+    /// </summary>
+    /// <param name="messageObject">
+    /// The refresher payload.
+    /// </param>
+    /// <param name="messageType">
+    /// Type of the cache refresher message, <see cref="MessageType"/>
+    /// </param>
     public ContentCacheRefresherNotification(object messageObject, MessageType messageType)
         : base(
         messageObject,

src/Umbraco.Core/Notifications/ContentCopiedNotification.cs

@@ -5,14 +5,35 @@
 using Umbraco.Cms.Core.Models;
 
 namespace Umbraco.Cms.Core.Notifications;
-
+/// <summary>
+/// A notification that is used to trigger the IContentService when the Copy method is called in the API.
+/// The notification is published after the content object has been copied.
+/// </summary>
 public sealed class ContentCopiedNotification : CopiedNotification<IContent>
 {
     public ContentCopiedNotification(IContent original, IContent copy, int parentId, Guid? parentKey, bool relateToOriginal, EventMessages messages)
         : base(original, copy, parentId, parentKey, relateToOriginal, messages)
     {
     }
 
+    /// <summary>
+    ///  Initializes a new instance of the <see cref="ContentCopiedNotification"/>.
+    /// </summary>
+    /// <param name="original">
+    /// Gets the original <see cref="IContent"/> object.
+    /// </param>
+    /// <param name="copy">
+    /// Gets the <see cref="IContent"/> object being copied.
+    /// </param>
+    /// <param name="parentId">
+    /// Gets the ID of the parent of the <see cref="IContent"/> being copied.
+    /// </param>
+    /// <param name="relateToOriginal">
+    /// Boolean indicating whether the copy was related to the orginal.
+    /// </param>
+    /// <param name="messages">
+    /// Initializes a new instance of the <see cref="EventMessages"/>.
+    /// </param>
     [Obsolete("Please use constructor that takes a parent key as well, scheduled for removal in v15")]
     public ContentCopiedNotification(IContent original, IContent copy, int parentId, bool relateToOriginal, EventMessages messages)
         : this(original, copy, parentId, null, relateToOriginal, messages)

src/Umbraco.Core/Notifications/ContentCopyingNotification.cs

@@ -5,14 +5,32 @@
 using Umbraco.Cms.Core.Models;
 
 namespace Umbraco.Cms.Core.Notifications;
-
+/// <summary>
+/// A notification that is used to trigger the IContentService when the Copy method is called in the API.
+/// The notification is published after a copy object has been created and had its parentId updated and its state has been set to unpublished.
+/// </summary>
 public sealed class ContentCopyingNotification : CopyingNotification<IContent>
 {
     public ContentCopyingNotification(IContent original, IContent copy, int parentId, Guid? parentKey, EventMessages messages)
         : base(original, copy, parentId, parentKey, messages)
     {
     }
 
+    /// <summary>
+    ///  Initializes a new instance of the <see cref="ContentCopyingNotification"/>.
+    /// </summary>
+    /// <param name="original">
+    /// Gets the original <see cref="IContent"/> object.
+    /// </param>
+    /// <param name="copy">
+    /// Gets the <see cref="IContent"/> object being copied.
+    /// </param>
+    /// <param name="parentId">
+    /// Gets the ID of the parent of the <see cref="IContent"/> being copied.
+    /// </param>
+    /// <param name="messages">
+    /// Initializes a new instance of the <see cref="EventMessages"/>.
+    /// </param>
     [Obsolete("Please use constructor that takes a parent key as well, scheduled for removal in v15")]
     public ContentCopyingNotification(IContent original, IContent copy, int parentId, EventMessages messages)
         : this(original, copy, parentId, null, messages)

src/Umbraco.Core/Notifications/ContentDeletedBlueprintNotification.cs

@@ -5,7 +5,9 @@
 using Umbraco.Cms.Core.Models;
 
 namespace Umbraco.Cms.Core.Notifications;
-
+/// <summary>
+/// A notification that is used to trigger the IContentService when the DeletedBlueprint method is called in the API.
+/// </summary>
 public sealed class ContentDeletedBlueprintNotification : EnumerableObjectNotification<IContent>
 {
     public ContentDeletedBlueprintNotification(IContent target, EventMessages messages)
@@ -19,6 +21,8 @@ public ContentDeletedBlueprintNotification(IEnumerable<IContent> target, EventMe
         messages)
     {
     }
-
+    /// <summary>
+    /// The collection of deleted blueprint IContent.
+    /// </summary>
     public IEnumerable<IContent> DeletedBlueprints => Target;
 }

src/Umbraco.Core/Notifications/ContentDeletedNotification.cs

@@ -5,7 +5,9 @@
 using Umbraco.Cms.Core.Models;
 
 namespace Umbraco.Cms.Core.Notifications;
-
+/// <summary>
+/// A notification that is used to trigger the IContentService when the Delete and EmptyRecycleBin methods are called in the API.
+/// </summary>
 public sealed class ContentDeletedNotification : DeletedNotification<IContent>
 {
     public ContentDeletedNotification(IContent target, EventMessages messages)

src/Umbraco.Core/Notifications/ContentDeletedVersionsNotification.cs

@@ -5,9 +5,29 @@
 using Umbraco.Cms.Core.Models;
 
 namespace Umbraco.Cms.Core.Notifications;
-
+/// <summary>
+/// A notification that is used to trigger the IContentService when the DeleteVersion and DeleteVersions methods are called in the API, and the version has been deleted.
+/// </summary>
 public sealed class ContentDeletedVersionsNotification : DeletedVersionsNotification<IContent>
 {
+    /// <summary>
+    ///  Initializes a new instance of the <see cref="ContentDeletedVersionsNotification"/>.
+    /// </summary>
+    /// <param name="id">
+    /// Gets the ID of the <see cref="IContent"/> object being deleted.
+    /// </param>
+    /// <param name="messages">
+    /// Initializes a new instance of the <see cref="EventMessages"/>.
+    /// </param>
+    /// <param name="specificVersion">
+    ///  Gets the id of the IContent object version being deleted.
+    /// </param>
+    /// <param name="deletePriorVersions">
+    ///  False by default.
+    /// </param>
+    /// <param name="dateToRetain">
+    /// Gets the latest version date.
+    /// </param>
     public ContentDeletedVersionsNotification(
         int id,
         EventMessages messages,

src/Umbraco.Core/Notifications/ContentDeletingNotification.cs

@@ -5,7 +5,9 @@
 using Umbraco.Cms.Core.Models;
 
 namespace Umbraco.Cms.Core.Notifications;
-
+/// <summary>
+/// A notification that is used to trigger the IContentService when the DeleteContentOfType, Delete and EmptyRecycleBin methods are called in the API.
+/// </summary>
 public sealed class ContentDeletingNotification : DeletingNotification<IContent>
 {
     public ContentDeletingNotification(IContent target, EventMessages messages)

src/Umbraco.Core/Notifications/ContentDeletingVersionsNotification.cs

@@ -5,9 +5,29 @@
 using Umbraco.Cms.Core.Models;
 
 namespace Umbraco.Cms.Core.Notifications;
-
+/// <summary>
+/// A notification that is used to trigger the IContentService when the DeleteVersion and DeleteVersions methods are called in the API.
+/// </summary>
 public sealed class ContentDeletingVersionsNotification : DeletingVersionsNotification<IContent>
 {
+    /// <summary>
+    ///  Initializes a new instance of the <see cref="ContentDeletingVersionsNotification"/>.
+    /// </summary>
+    /// <param name="id">
+    /// Gets the ID of the <see cref="IContent"/> object being deleted.
+    /// </param>
+    /// <param name="messages">
+    /// Initializes a new instance of the <see cref="EventMessages"/>.
+    /// </param>
+    /// <param name="specificVersion">
+    ///  Gets the id of the IContent object version being deleted.
+    /// </param>
+    /// <param name="deletePriorVersions">
+    ///  False by default.
+    /// </param>
+    /// <param name="dateToRetain">
+    /// Gets the latest version date.
+    /// </param>
     public ContentDeletingVersionsNotification(int id, EventMessages messages, int specificVersion = default, bool deletePriorVersions = false, DateTime dateToRetain = default)
         : base(id, messages, specificVersion, deletePriorVersions, dateToRetain)
     {

src/Umbraco.Core/Notifications/ContentEmptiedRecycleBinNotification.cs

@@ -5,9 +5,20 @@
 using Umbraco.Cms.Core.Models;
 
 namespace Umbraco.Cms.Core.Notifications;
-
+/// <summary>
+/// A notification that is used to trigger the IContentService when the EmptyRecycleBin method is called in the API, after the RecycleBin has been deleted.
+/// </summary>
 public sealed class ContentEmptiedRecycleBinNotification : EmptiedRecycleBinNotification<IContent>
 {
+    /// <summary>
+    ///  Initializes a new instance of the  <see cref="ContentEmptyingRecycleBinNotification"/>
+    /// </summary>
+    /// <param name="deletedEntities">
+    ///  The collection of deleted IContent object.
+    /// </param>
+    /// <param name="messages">
+    /// Initializes a new instance of the <see cref="EventMessages"/>.
+    /// </param>
     public ContentEmptiedRecycleBinNotification(IEnumerable<IContent> deletedEntities, EventMessages messages)
         : base(
         deletedEntities, messages)