feat: Ajoutez des commentaires de documentation XML à divers modèles et contrôleurs pour une meilleure clarté

Webzine.WebApplication/Areas/Administration/Controllers/CommentairesController.cs

@@ -13,7 +13,9 @@ namespace Webzine.WebApplication.Areas.Administration.Controllers
     {
         private readonly ILogger<CommentaireController> _logger;
         private readonly List<Commentaire> _commentaires;
+
         /// <summary>
+        /// Initializes a new instance of the <see cref="CommentaireController"/> class.
         /// Initialise une nouvelle instance du <see cref="CommentaireController"/>.
         /// Les données sont générées dynamiquement via <see cref="DataFactory"/>.
         /// </summary>
@@ -35,7 +37,10 @@ namespace Webzine.WebApplication.Areas.Administration.Controllers
             _logger.LogInformation("Données fictives générées avec succès.");
         }
 
-        // GET: Administration/Commentaires
+        /// <summary>
+        /// Affiche la liste des commentaires dans la vue Index.
+        /// </summary>
+        /// <returns>>La vue Index avec le ViewModel contenant la liste des commentaires.</returns>
         public ActionResult Index()
         {
             // Création de données "bouchon" (mock) pour tester l'affichage
@@ -78,7 +83,11 @@ namespace Webzine.WebApplication.Areas.Administration.Controllers
         }
 
 
-        // GET: Administration/Commentaires/Delete/5
+        /// <summary>
+        /// Affiche la vue de confirmation de suppression d'un commentaire, en récupérant les détails du commentaire à supprimer à partir de l'identifiant fourni.
+        /// </summary>
+        /// <param name="id">L'identifiant du commentaire à supprimer.</param>
+        /// <returns>La vue de confirmation de suppression avec le ViewModel contenant les détails du commentaire à supprimer, ou une réponse NotFound si le commentaire n'existe pas.</returns>
         public ActionResult Delete(int id)
         {
             var commentaire = _commentaires
@@ -99,7 +108,12 @@ namespace Webzine.WebApplication.Areas.Administration.Controllers
             return View(vm);
         }
 
-        // POST: Administration/Commentaires/Delete/5
+        /// <summary>
+        /// Traite la confirmation de suppression d'un commentaire. En cas de succès, redirige vers la liste des commentaires. En cas d'erreur, affiche à nouveau la vue de confirmation avec le message d'erreur.
+        /// </summary>
+        /// <param name="id">L'identifiant du commentaire à supprimer.</param>
+        /// <param name="model">Le ViewModel contenant les détails du commentaire à supprimer, utilisé pour afficher les informations en cas d'erreur.</param>
+        /// <returns>Redirection vers la liste des commentaires en cas de succès, ou la vue de confirmation avec le message d'erreur en cas d'échec.</returns>
         [HttpPost]
         [ValidateAntiForgeryToken]
         public ActionResult Delete(int id, CommentaireDeleteViewModel model)