Rewrite README and remove em dashes

Author: cmaureir

README.md

@@ -1,73 +1,92 @@
-# hablemospython.dev 🐍
+# hablemospython.dev
 
-Sitio web de introducción a la comunidad "Python en Español".  Encontrarás
-consejos y recursos de nuestras comunidades en Telegram, y Discord.
+Este es el código del sitio web de la comunidad "Python en Español". Ahí
+encontrarás consejos para quienes empiezan, cursos y libros recomendados,
+preguntas frecuentes, las normas de la comunidad y enlaces a nuestros grupos en
+Discord y Telegram, entre otras cosas.
 
-## Implementación
+## Cómo está hecho
 
-El sitio está construido con [Astro](https://astro.build/) y
-[Tailwind CSS](https://tailwindcss.com/), a partir de la plantilla
-[Astroplate](https://github.com/zeon-studio/astroplate). Es un sitio
-estático: no hay backend, todo el contenido vive como archivos Markdown/MDX
-dentro de `src/content/`.
+El sitio usa [Astro](https://astro.build/) y [Tailwind CSS](https://tailwindcss.com/),
+y parte de la plantilla [Astroplate](https://github.com/zeon-studio/astroplate).
+Es un sitio estático: no hay backend ni base de datos. Todo el contenido son
+archivos Markdown o MDX dentro de `src/content/`.
 
-### Estructura principal
+### Dónde está cada cosa
 
-- `src/content/pages/` — las páginas del sitio (Principiantes, FAQ, Código de
-  conducta, etc.), servidas en `/<slug>` mediante `src/pages/[regular].astro`.
-- `src/content/blog/` — el blog y los episodios del podcast *Bit a bit*
-  (diferenciados por la categoría `podcast`), servidos en `/blog/<slug>`.
-- `src/content/authors/`, `src/content/homepage/` — autores y el contenido
+- `src/content/pages/`: las páginas del sitio (Principiantes, FAQ, Código de
+  conducta y demás). Cada archivo se publica en `/<nombre>/` gracias a
+  `src/pages/[regular].astro`.
+- `src/content/blog/`: el blog y los episodios del podcast *Bit a bit*. Los
+  episodios se distinguen por la categoría `podcast` y se publican en
+  `/blog/<nombre>/`.
+- `src/content/authors/` y `src/content/homepage/`: los autores y el contenido
   de la portada.
-- `src/pages/` — rutas de Astro que no son puramente Markdown (portada,
-  `/otras-comunidades`, listados de blog/categorías/tags/autores, etc.).
-- `src/config/` — configuración del sitio: `config.json` (metadatos, SEO),
-  `menu.json` (navegación), `social.json` (redes sociales), y estilos/tema en
-  `src/styles/theme.css`.
-- `src/lib/data/communities.ts` — el listado de comunidades (Discord,
-  Telegram, WhatsApp) que se muestra en `/otras-comunidades`.
-
-### ¿Cómo contribuir?
-
-- Los cambios a las páginas existentes van directamente en los archivos de
+- `src/pages/`: las rutas que no son solo Markdown, como la portada,
+  `/otras-comunidades/`, los listados del blog, las categorías, los tags y los
+  autores. Aquí también está `search.json.ts`, que genera el índice del
+  buscador.
+- `src/config/`: la configuración del sitio. `config.json` tiene los datos
+  generales, `menu.json` el menú y `social.json` las redes sociales. Los
+  colores y las fuentes están en `src/styles/theme.css`.
+- `src/lib/data/communities.ts`: la lista de comunidades de Discord, Telegram y
+  WhatsApp que se muestra en `/otras-comunidades/`.
+- `astro.config.mjs`: además de la configuración de Astro, aquí están las
+  redirecciones desde las direcciones antiguas del sitio (`/faq.html`,
+  `/cursosylibros.html`, etc.).
+
+## Cómo contribuir
+
+No hace falta saber programar para aportar. Estas son las formas más comunes:
+
+- **Corregir o mejorar una página:** edita el archivo correspondiente en
   `src/content/pages/`.
-- Para agregar una nueva página, crea un nuevo archivo Markdown en
-  `src/content/pages/` con el frontmatter `title`/`description`/`draft`, y
-  agrégala a `src/config/menu.json` si debe aparecer en el menú superior o en
-  el pie de página.
-- Para un nuevo artículo del blog o episodio del podcast, agrega un archivo en
-  `src/content/blog/` (usa `categories: ["podcast"]` para episodios del
-  podcast).
-- Para agregar o modificar comunidades, edita
-  `src/lib/data/communities.ts`.
+- **Agregar una página nueva:** crea un archivo Markdown en
+  `src/content/pages/` con los campos `title`, `description` y `draft` al
+  inicio. Si quieres que aparezca en el menú o en el pie de página, agrégala
+  también a `src/config/menu.json`.
+- **Publicar un artículo o un episodio del podcast:** agrega un archivo en
+  `src/content/blog/`. Para un episodio usa `categories: ["podcast"]`.
+- **Agregar o actualizar una comunidad:** edita `src/lib/data/communities.ts`.
 
-## Configuración
+Algunos detalles útiles al escribir contenido:
 
-### Dependencias
+- Las preguntas de la FAQ usan el componente `<Accordion>`. Cada una tiene un
+  enlace propio a partir de su título (por ejemplo `/faq/#cómo-instalo-python`),
+  así que puedes compartir una pregunta ya abierta. Si quieres una dirección más
+  corta, agrega un `id`: `<Accordion id="uv" title="...">`.
+- Para insertar un video de YouTube usa `<Youtube id="..." title="..." />`.
+- Los enlaces internos terminan en `/` (por ejemplo `/faq/`), igual que las
+  direcciones del sitio publicado.
 
-Este proyecto usa [pnpm](https://pnpm.io/). Instala las dependencias con:
+## Trabajar en local
 
-```bash
-pnpm install
-```
-
-### Desarrollo
+Necesitas [Node.js](https://nodejs.org/) y [pnpm](https://pnpm.io/). Instala las
+dependencias con:
 
 ```bash
-pnpm dev
+pnpm install
 ```
 
-### Generar el sitio
+Estos son los comandos que más vas a usar:
 
 ```bash
-pnpm build
+pnpm dev       # servidor local con recarga automática
+pnpm build     # genera el sitio en dist/
+pnpm preview   # sirve lo que quedó en dist/ para revisarlo antes de publicar
+pnpm check     # revisa los tipos de Astro y TypeScript
+pnpm format    # da formato al código con Prettier
 ```
 
-El resultado queda en `dist/`. `pnpm preview` sirve ese resultado
-localmente para revisarlo antes de publicar.
+## Publicación
 
-## Despliegue
+El sitio se publica en GitHub Pages con el workflow
+`.github/workflows/deploy-to-github-pages.yml`. Se ejecuta solo cada vez que se
+hace push o se fusiona un cambio en `main`, así que no hay que hacer nada más
+para ver tus cambios en línea.
 
-El sitio se publica en GitHub Pages mediante el workflow
-`.github/workflows/deploy-to-github-pages.yml`, que se ejecuta
-automáticamente en cada push a `main`.
+El dominio es `hablemospython.dev`. Para que funcione, en la configuración de
+GitHub Pages el dominio personalizado está puesto en `hablemospython.dev`, el
+registro `www` apunta a GitHub y el apex tiene los cuatro registros A de
+GitHub Pages. GitHub se encarga de redirigir `www` al dominio sin `www` y de
+renovar el certificado HTTPS.

src/layouts/shortcodes/Youtube.astro

@@ -1,6 +1,6 @@
 ---
 // Thin wrapper around the framework-agnostic <lite-youtube> web component
-// (no React needed — the previous version only used React to lazy-load it).
+// (no React needed; the previous version only used React to lazy-load it).
 export interface Props {
   id: string;
   title: string;

src/styles/theme.css

@@ -1,6 +1,6 @@
 /**
  * Design tokens for Python en Español, as plain Tailwind v4 `@theme` custom
- * properties. Hand-maintained — edit the values below directly (no build
+ * properties. Hand-maintained: edit the values below directly (no build
  * step, unlike the old theme.json -> themeGenerator.js -> this-file pipeline).
  */
 @theme {