Commit inicial. Creados tres archivos con diferentes pautas

This commit is contained in:
2025-09-02 11:48:12 -06:00
commit 6d3222a93c
3 changed files with 192 additions and 0 deletions

90
flujo_editorial_blog.md Normal file
View File

@@ -0,0 +1,90 @@
# 📘 Guía para contribuir al blog de la comunidad
Bienvenido/a al repositorio de contenido del blog de nuestra comunidad tech. Este documento describe el flujo editorial ligero que seguimos para publicar artículos.
---
## 🧭 Objetivo
Organizar la publicación de contenido técnico o inspirador que motive a más personas a unirse a nuestra comunidad y al servidor de Discord.
---
## 👥 Roles
- **Autor/a**: Escribe el artículo en formato Markdown (`.md` o `.mdx`).
- **Revisor/a**: Revisa ortografía, claridad, formato y consistencia.
- **Publicador/a**: Aprueba el contenido final y hace *merge* del PR.
> Un mismo colaborador puede tener más de un rol según su disponibilidad.
---
## 🧩 Estructura del contenido
Todos los posts deben:
- Estar en la carpeta `content/blog/`
- Usar el siguiente *frontmatter*:
```md
---
title: "Título del post"
author: "Tu nombre o alias"
date: "YYYY-MM-DD"
tags: ["tema1", "tema2"]
---
```
- Terminar con un llamado a la acción estándar:
```md
---
¿Tienes dudas o quieres compartir tu experiencia?
👉 Únete a nuestro servidor de Discord.
```
---
## 🔄 Flujo de publicación
1. Crea un fork o rama nueva con tu post.
2. Abre un Pull Request (PR) hacia la rama principal.
3. Al menos un revisor comentará sugerencias o aprobará el contenido.
4. Una vez aprobado, alguien del equipo publicador hace merge.
5. El sitio se actualiza automáticamente.
---
## 🛠 Herramientas opcionales
- **Labels**: `post: nuevo`, `revisión necesaria`, `aprobado`.
- **GitHub Projects**: Seguimiento visual del estado de cada post.
- **GitHub Actions**: Validaciones opcionales de formato.
---
## 📅 Ritmo sugerido
- Publicar 1 post al mes (mínimo).
- Revisar y rotar autores/as según disponibilidad.
---
## 💡 Ideas para nuevos artículos
- Historias personales (cómo entraste al mundo tech)
- Tutoriales simples o consejos prácticos
- Resumen de actividades de la comunidad (ej. Lightning Talks)
- Opinión sobre herramientas o tecnologías
---
## 🙌 ¡Anímate a escribir!
Si tienes una idea, no necesitas tenerla completamente escrita para empezar. Comparte tu propuesta en Discord y alguien del equipo editorial puede ayudarte a pulirla.
---
*Gracias por aportar a construir una comunidad más abierta y valiosa para todos.*

54
pull_request_template.md Normal file
View File

@@ -0,0 +1,54 @@
# ✍️ Nuevo post para el blog de la comunidad
Gracias por contribuir con un nuevo artículo. Por favor completa la siguiente información para facilitar la revisión.
---
## 📄 Título del post
_Título completo del artículo en el archivo Markdown:_
> Ejemplo: “Cómo empecé en QA sin saber programar”
---
## 🧠 Resumen del contenido
_Describe brevemente de qué trata tu artículo, a quién está dirigido y por qué puede ser útil._
---
## 🧩 ¿Qué incluye este PR?
- [ ] Nuevo archivo Markdown (`.md` o `.mdx`) en `content/blog/`
- [ ] Frontmatter completo (título, autor, fecha, tags)
- [ ] Llamado a unirse a Discord al final del artículo
- [ ] Ortografía y formato revisado por el autor
---
## 🧪 ¿Necesita revisión editorial?
- [ ] Sí, me gustaría recibir sugerencias
- [ ] No, ya fue revisado por otro miembro
- [ ] Es un borrador abierto a discusión
---
## 📸 ¿Incluye imágenes o enlaces externos?
- [ ] Sí (verifica que tengan buena resolución y no rompan el diseño)
- [ ] No
---
## 📝 Notas adicionales (opcional)
_Agrega cualquier comentario o contexto adicional para los revisores._
---
👉 _Una vez revisado, al menos un miembro del equipo puede aprobar el contenido y hacer merge._
¡Gracias por tu contribución! 🙌

48
readme_content_blog.md Normal file
View File

@@ -0,0 +1,48 @@
# 🗂️ Carpeta: content/blog/
Aquí se encuentran los artículos escritos para el blog de la comunidad en formato Markdown (`.md` o `.mdx`). Cada archivo representa una entrada individual publicada en el sitio web.
---
## 📄 ¿Cómo agregar un nuevo post?
1. Crea un archivo nuevo en esta carpeta con el nombre de tu post:
- Ejemplo: `como-empece-en-qa.md`
2. Usa este *frontmatter* al inicio del archivo:
```md
---
title: "Título del post"
author: "Tu nombre o alias"
date: "YYYY-MM-DD"
tags: ["tema1", "tema2"]
---
```
3. Escribe el contenido utilizando Markdown. Puedes usar subtítulos, listas, enlaces, etc.
4. Al final, agrega este llamado a la acción:
```md
---
¿Tienes dudas o quieres compartir tu experiencia?
👉 Únete a nuestro servidor de Discord.
```
5. Abre un Pull Request incluyendo el nuevo archivo.
- Puedes usar el [template de PR](../PULL_REQUEST_TEMPLATE.md) para facilitar la revisión.
---
## 📘 Guías útiles
- [Guía para contribuir al blog](../Flujo%20Editorial%20Blog.md)
- [Ejemplo de post completo](../Ejemplo%20Post%20Blog.md)
- [Pull Request de ejemplo](../Pr%20Ejemplo%20Post%20Blog.md)
---
¿Tienes dudas? Comparte tu idea en el canal de Discord de la comunidad. Siempre hay alguien dispuesto a ayudarte 🙌