From eb3157c4a4e0bc97325b9ce41bad9a7f6a74086f Mon Sep 17 00:00:00 2001
From: Manuel Cillero <manuel@cillero.es>
Date: Tue, 14 Jul 2026 07:27:51 +0200
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9D=20Retoques=20menores=20en=20docume?=
 =?UTF-8?q?ntaci=C3=B3n?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 extensions/pagetop-htmx/src/hx.rs |  2 +-
 src/auth.rs                       | 10 ++++++----
 src/core/component/context.rs     |  2 +-
 src/core/component/message.rs     |  4 ++--
 src/core/extension/definition.rs  | 12 ++++++------
 5 files changed, 16 insertions(+), 14 deletions(-)

diff --git a/extensions/pagetop-htmx/src/hx.rs b/extensions/pagetop-htmx/src/hx.rs
index 744965e4..e30c4651 100644
--- a/extensions/pagetop-htmx/src/hx.rs
+++ b/extensions/pagetop-htmx/src/hx.rs
@@ -332,7 +332,7 @@ pub const DISABLE: &str = "hx-disable";
 
 /// Genera `hx-on:{event}` para escuchar eventos nativos del DOM en línea.
 ///
-/// Es la alternativa de HTMX a los *handlers* `on*` de HTML (`onclick`, `onmouseenter`, ...). La
+/// Es la alternativa de HTMX a los handlers `on*` de HTML (`onclick`, `onmouseenter`, ...). La
 /// diferencia clave está en cómo los trata el navegador bajo una política CSP (*Content Security
 /// Policy*): los atributos `on*` son JavaScript en línea y quedan bloqueados si la CSP no incluye
 /// `'unsafe-inline'`; en cambio, `hx-on:*` es un atributo de datos que HTMX lee e interpreta desde
diff --git a/src/auth.rs b/src/auth.rs
index e9f96410..39a36fbc 100644
--- a/src/auth.rs
+++ b/src/auth.rs
@@ -5,7 +5,9 @@
 //! propios modelos de permisos, y la función auxiliar [`has_permission()`].
 //!
 //! La resolución concreta del usuario (sesión en BD, LDAP, OAuth, ...) y la lógica de permisos
-//! (RBAC, grupos LDAP, ...) son responsabilidad de las extensiones de autenticación.
+//! (RBAC, grupos LDAP, ...) son responsabilidad de las extensiones de autenticación. Un concepto
+//! como "administrador" que tiene todos los permisos no es responsabilidad del core: cada extensión
+//! decide si existe y, si es así, lo aplica dentro de su propio handler [`CheckPermission`].
 
 use crate::core::action::{ActionDispatcher, ActionKey, try_dispatch_actions};
 use crate::core::component::Context;
@@ -79,9 +81,9 @@ pub type FnCheckPermission = fn(cx: &Context, key: &str, granted: &mut bool);
 
 /// Acción para comprobar si el usuario actual tiene un permiso concreto.
 ///
-/// Las extensiones de autenticación registran *handlers* de esta acción para implementar su modelo
-/// de permisos. Los *handlers* son aditivos: si cualquiera de ellos asigna `granted = true`, el
-/// permiso se concede.
+/// Las extensiones de autenticación registran handlers de esta acción para implementar su modelo de
+/// permisos. Los handlers son aditivos: si cualquiera de ellos asigna `granted = true`, el permiso
+/// se concede.
 ///
 /// # Ejemplo
 ///
diff --git a/src/core/component/context.rs b/src/core/component/context.rs
index 4dd7a1dc..4edc8ea3 100644
--- a/src/core/component/context.rs
+++ b/src/core/component/context.rs
@@ -496,7 +496,7 @@ impl Context {
 
     /// Acumula un [`StatusMessage`] en el contexto para notificar al usuario.
     ///
-    /// Pueden generarse en cualquier punto del ciclo de una petición web (*handlers*, renderizado,
+    /// Pueden generarse en cualquier punto del ciclo de una petición web (handlers, renderizado,
     /// lógica de negocio, etc.) que tengan acceso al contexto, y mostrarlos luego, por ejemplo, en
     /// la página final devuelta al usuario.
     ///
diff --git a/src/core/component/message.rs b/src/core/component/message.rs
index b3990df6..f5cf66b1 100644
--- a/src/core/component/message.rs
+++ b/src/core/component/message.rs
@@ -17,8 +17,8 @@ pub enum MessageLevel {
 ///
 /// Representa un mensaje con carácter informativo, una advertencia o un error. A diferencia de
 /// [`ComponentError`](super::ComponentError), no está ligado a un fallo interno de renderizado,
-/// puede generarse en cualquier punto del procesamiento de una petición web (*handlers*,
-/// renderizado, lógica de negocio, etc.).
+/// puede generarse en cualquier punto del procesamiento de una petición web (handlers, renderizado,
+/// lógica de negocio, etc.).
 ///
 /// El texto se almacena como [`L10n`] para resolverse con el idioma del contexto en el momento de
 /// la visualización.
diff --git a/src/core/extension/definition.rs b/src/core/extension/definition.rs
index ad4aaf75..48e0efe8 100644
--- a/src/core/extension/definition.rs
+++ b/src/core/extension/definition.rs
@@ -143,12 +143,12 @@ pub trait Extension: AnyInfo + Send + Sync {
     ///
     /// # Operaciones disponibles
     ///
-    /// | Operación                          | Llamada sobre `router`                             |
-    /// |------------------------------------|----------------------------------------------------|
-    /// | Ruta HTTP                          | `.route("/path", web::get(handler))`               |
-    /// | Rutas bajo prefijo común           | `.nest("/prefix", sub_router)`                     |
-    /// | Archivos estáticos                 | `serve_static_files!(router, [assets] => "/path")` |
-    /// | Estado compartido entre *handlers* | `.with_state(my_state)`                            |
+    /// | Operación                        | Llamada sobre `router`                             |
+    /// |----------------------------------|----------------------------------------------------|
+    /// | Ruta HTTP                        | `.route("/path", web::get(handler))`               |
+    /// | Rutas bajo prefijo común         | `.nest("/prefix", sub_router)`                     |
+    /// | Archivos estáticos               | `serve_static_files!(router, [assets] => "/path")` |
+    /// | Estado compartido entre handlers | `.with_state(my_state)`                            |
     ///
     /// # Ejemplos
     ///