From 89f037eedbfa1963f1d991d1d04c1bba3f83709b Mon Sep 17 00:00:00 2001
From: Manuel Cillero <manuel@cillero.es>
Date: Sat, 29 Nov 2025 14:42:05 +0100
Subject: [PATCH] =?UTF-8?q?=F0=9F=9A=A7=20Retoques=20menores=20en=20los=20?=
 =?UTF-8?q?comentarios=20del=20c=C3=B3digo?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 extensions/pagetop-bootsier/src/theme/navbar/component.rs | 2 +-
 src/base/component/html.rs                                | 2 +-
 src/base/component/intro.rs                               | 2 +-
 src/base/component/poweredby.rs                           | 4 ++--
 src/html/unit.rs                                          | 8 ++++----
 5 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/extensions/pagetop-bootsier/src/theme/navbar/component.rs b/extensions/pagetop-bootsier/src/theme/navbar/component.rs
index b40d06c2..225c2af5 100644
--- a/extensions/pagetop-bootsier/src/theme/navbar/component.rs
+++ b/extensions/pagetop-bootsier/src/theme/navbar/component.rs
@@ -73,7 +73,7 @@ impl Component for Navbar {
             return PrepareMarkup::None;
         }
 
-        // Asegura que la barra tiene un id estable para poder asociarlo al colapso/offcanvas.
+        // Asegura que la barra tiene un `id` para poder asociarlo al colapso/offcanvas.
         let id = cx.required_id::<Self>(self.id());
 
         PrepareMarkup::With(html! {
diff --git a/src/base/component/html.rs b/src/base/component/html.rs
index a60d30f9..1cca9899 100644
--- a/src/base/component/html.rs
+++ b/src/base/component/html.rs
@@ -1,6 +1,6 @@
 use crate::prelude::*;
 
-/// Componente básico para renderizar dinámicamente código HTML recibiendo el contexto.
+/// Componente básico que renderiza dinámicamente código HTML según el contexto.
 ///
 /// Este componente permite generar contenido HTML arbitrario, usando la macro `html!` y accediendo
 /// opcionalmente al contexto de renderizado.
diff --git a/src/base/component/intro.rs b/src/base/component/intro.rs
index ea01ccc8..7a3b2812 100644
--- a/src/base/component/intro.rs
+++ b/src/base/component/intro.rs
@@ -29,7 +29,7 @@ pub enum IntroOpening {
 ///   opta por [`IntroOpening::PageTop`]) y bloques ([`Block`](crate::base::component::Block)) de
 ///   contenido libre para crear párrafos vistosos de texto. Aunque admite todo tipo de componentes.
 ///
-/// ### Ejemplos
+/// # Ejemplos
 ///
 /// **Intro mínima por defecto**
 ///
diff --git a/src/base/component/poweredby.rs b/src/base/component/poweredby.rs
index 797253dc..5a2dc5b2 100644
--- a/src/base/component/poweredby.rs
+++ b/src/base/component/poweredby.rs
@@ -3,7 +3,7 @@ use crate::prelude::*;
 // Enlace a la página oficial de PageTop.
 const LINK: &str = "<a href=\"https://pagetop.cillero.es\" rel=\"noopener noreferrer\">PageTop</a>";
 
-/// Componente que informa del 'Powered by' (*Funciona con*) típica del pie de página.
+/// Componente que muestra el típico mensaje *Powered by* (*Funciona con*) en el pie de página.
 ///
 /// Por defecto, usando [`default()`](Self::default) sólo se muestra un reconocimiento a PageTop.
 /// Sin embargo, se puede usar [`new()`](Self::new) para crear una instancia con un texto de
@@ -17,7 +17,7 @@ impl Component for PoweredBy {
     /// Crea una nueva instancia de `PoweredBy`.
     ///
     /// El copyright se genera automáticamente con el año actual y el nombre de la aplicación
-    /// configurada en [`global::SETTINGS`].
+    /// configurada en [`global::SETTINGS`], en el formato `YYYY © Nombre de la aplicación`.
     fn new() -> Self {
         let year = Utc::now().format("%Y").to_string();
         let c = join!(year, " © ", global::SETTINGS.app.name);
diff --git a/src/html/unit.rs b/src/html/unit.rs
index 4a99de16..aec40372 100644
--- a/src/html/unit.rs
+++ b/src/html/unit.rs
@@ -167,7 +167,7 @@ impl fmt::Display for UnitValue {
 
 /// Convierte una cadena a [`UnitValue`] siguiendo una gramática CSS acotada.
 ///
-/// ## Acepta
+/// # Acepta
 ///
 /// - `""` para `UnitValue::None`
 /// - `"auto"`
@@ -178,7 +178,7 @@ impl fmt::Display for UnitValue {
 ///
 /// (Se toleran espacios entre número y unidad: `"12 px"`, `"1.5  rem"`).
 ///
-/// ## Ejemplo
+/// # Ejemplo
 ///
 /// ```rust
 /// # use pagetop::prelude::*;
@@ -188,7 +188,7 @@ impl fmt::Display for UnitValue {
 /// assert!(UnitValue::from_str("12").is_err());
 /// ```
 ///
-/// ## Errores de interpretación
+/// # Errores de interpretación
 ///
 /// - Falta la unidad cuando es necesaria (p. ej., `"12"`, excepto para el valor cero).
 /// - Decimales en valores que deben ser absolutos (p. ej. `"1.5px"`).
@@ -262,7 +262,7 @@ impl FromStr for UnitValue {
 
 /// Deserializa desde una cadena usando la misma gramática que [`FromStr`].
 ///
-/// ### Ejemplo con `serde_json`
+/// # Ejemplo con `serde_json`
 /// ```rust
 /// # use pagetop::prelude::*;
 /// use serde::Deserialize;