commit 6d3222a93c35275161d06d1c0aae5afbc10c9947 Author: Ignacio Date: Tue Sep 2 11:48:12 2025 -0600 Commit inicial. Creados tres archivos con diferentes pautas diff --git a/flujo_editorial_blog.md b/flujo_editorial_blog.md new file mode 100644 index 0000000..5c051ce --- /dev/null +++ b/flujo_editorial_blog.md @@ -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.* + diff --git a/pull_request_template.md b/pull_request_template.md new file mode 100644 index 0000000..b56d946 --- /dev/null +++ b/pull_request_template.md @@ -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! 🙌 + diff --git a/readme_content_blog.md b/readme_content_blog.md new file mode 100644 index 0000000..0691a64 --- /dev/null +++ b/readme_content_blog.md @@ -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 🙌 +