🚧 Retoques menores en los comentarios del código

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! {

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.

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

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);

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;