📝 (seaorm): Documenta selección del motor de BD

Diferencia el patrón para aplicaciones (activan el motor via *feature*
en su `Cargo.toml`) y extensiones (sin *features*; la selección es
responsabilidad de la aplicación).

extensions/pagetop-seaorm/README.md

@@ -19,14 +19,34 @@ configurables, basadas en HTML, CSS y JavaScript.
 
 ## Guía rápida
 
-**Añade la dependencia** a tu `Cargo.toml` activando el motor de base de datos que necesites:
+**Añade la dependencia** a tu `Cargo.toml`:
+
+- Si estás desarrollando una **aplicación**, activa el motor de base de datos que necesites:
+
+  ```toml
+  [features]
+  default  = ["postgres"]
+  mysql    = ["pagetop-seaorm/mysql"]
+  postgres = ["pagetop-seaorm/postgres"]
+  sqlite   = ["pagetop-seaorm/sqlite"]
+
+  [dependencies]
+  pagetop-seaorm = { version = "..." }
+  ```
+
+  Las *features* disponibles son `mysql`, `postgres` y `sqlite`. Gracias a la unificación de
+  *features* de Cargo, activar el motor aquí lo propaga a todos los *crates* del árbol de
+  dependencias que usen `pagetop-seaorm`; no es necesario que cada extensión lo reexporte.
+
+- Si estás escribiendo una **extensión**, declara la dependencia sin *features*:
 
   ```toml
   [dependencies]
-pagetop-seaorm = { version = "...", features = ["sqlite"] }
+  pagetop-seaorm = { version = "..." }
   ```
 
-Las *features* disponibles son `mysql`, `postgres` y `sqlite`.
+  La selección del motor es responsabilidad de la aplicación que use la extensión, no de la
+  extensión misma.
 
 **Configura la conexión** en el archivo de configuración de la aplicación:
 

extensions/pagetop-seaorm/src/lib.rs

@@ -20,14 +20,34 @@ configurables, basadas en HTML, CSS y JavaScript.
 
 ## Guía rápida
 
-**Añade la dependencia** a tu `Cargo.toml` activando el motor de base de datos que necesites:
+**Añade la dependencia** a tu `Cargo.toml`:
+
+- Si estás desarrollando una **aplicación**, activa el motor de base de datos que necesites:
+
+  ```toml
+  [features]
+  default  = ["postgres"]
+  mysql    = ["pagetop-seaorm/mysql"]
+  postgres = ["pagetop-seaorm/postgres"]
+  sqlite   = ["pagetop-seaorm/sqlite"]
+
+  [dependencies]
+  pagetop-seaorm = { version = "..." }
+  ```
+
+  Las *features* disponibles son `mysql`, `postgres` y `sqlite`. Gracias a la unificación de
+  *features* de Cargo, activar el motor aquí lo propaga a todos los *crates* del árbol de
+  dependencias que usen `pagetop-seaorm`; no es necesario que cada extensión lo reexporte.
+
+- Si estás escribiendo una **extensión**, declara la dependencia sin *features*:
 
   ```toml
   [dependencies]
-pagetop-seaorm = { version = "...", features = ["sqlite"] }
+  pagetop-seaorm = { version = "..." }
   ```
 
-Las *features* disponibles son `mysql`, `postgres` y `sqlite`.
+  La selección del motor es responsabilidad de la aplicación que use la extensión, no de la
+  extensión misma.
 
 **Configura la conexión** en el archivo de configuración de la aplicación: