📝 Retoques menores en documentación

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

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
+/// Las extensiones de autenticación registran handlers de esta acción para implementar su modelo de
-/// de permisos. Los *handlers* son aditivos: si cualquiera de ellos asigna `granted = true`, el
+/// permisos. Los handlers son aditivos: si cualquiera de ellos asigna `granted = true`, el permiso
-/// permiso se concede.
+/// se concede.
 ///
 /// # Ejemplo
 ///

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.
     ///

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*,
+/// puede generarse en cualquier punto del procesamiento de una petición web (handlers, renderizado,
-/// renderizado, lógica de negocio, etc.).
+/// 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.

src/core/extension/definition.rs

@@ -143,12 +143,12 @@ pub trait Extension: AnyInfo + Send + Sync {
     ///
     /// # Operaciones disponibles
     ///
-    /// | Operación                          | Llamada sobre `router`                             |
+    /// | Operación                        | Llamada sobre `router`                             |
-    /// |------------------------------------|----------------------------------------------------|
+    /// |----------------------------------|----------------------------------------------------|
-    /// | Ruta HTTP                          | `.route("/path", web::get(handler))`               |
+    /// | Ruta HTTP                        | `.route("/path", web::get(handler))`               |
-    /// | Rutas bajo prefijo común           | `.nest("/prefix", sub_router)`                     |
+    /// | Rutas bajo prefijo común         | `.nest("/prefix", sub_router)`                     |
-    /// | Archivos estáticos                 | `serve_static_files!(router, [assets] => "/path")` |
+    /// | Archivos estáticos               | `serve_static_files!(router, [assets] => "/path")` |
-    /// | Estado compartido entre *handlers* | `.with_state(my_state)`                            |
+    /// | Estado compartido entre handlers | `.with_state(my_state)`                            |
     ///
     /// # Ejemplos
     ///