Saltar al contenido principal

Guía para contribuir al sitio de Cloud & Code CR

¡Bienvenid@ a la guía oficial para contribuir al sitio web de nuestra comunidad!

El sitio de Cloud & Code CR está construido con Docusaurus, una herramienta poderosa para documentar, construir blogs y crear contenido técnico de manera colaborativa. Este espacio es totalmente abierto para que puedas aportar.

¿Cómo puedes contribuir?​

Puedes colaborar de distintas maneras:

  • Proponiendo o escribiendo artículos de blog.
  • Mejorando la documentación interna o pública.
  • Corrigiendo errores o mejorando el diseño.
  • Sugiriendo nuevas secciones o funcionalidades.
  • Traduciendo contenido.

¡Tu aporte, por pequeño que sea, suma mucho a nuestra comunidad!

Requisitos previos​

Asegúrate de tener instalado lo siguiente:

  • Node.js versión 16.14 o superior.
  • Git para clonar y colaborar en el repositorio.

Clonar el proyecto​

Primero, clona el repositorio oficial:

git clone git@github.com:jonmatum/cloudandcode.git
cd cloudandcode

Instalar dependencias​

Instala las dependencias necesarias para correr el proyecto localmente:

npm install

Levantar el servidor de desarrollo​

Para ver los cambios en tu máquina:

npm run start

Luego visita http://localhost:3000/ para ver el sitio en vivo.

Docusaurus recarga automáticamente cada vez que guardes cambios.

Estructura básica del proyecto​

• /docs → Documentación interna y pública.
• /blog → Artículos del blog (posts).
• /src → Componentes y código fuente personalizado.
• /static → Imágenes y recursos estáticos.

¿Cómo agregar un nuevo post al blog?​

  1. Crea un archivo .md o .mdx dentro de /blog/.
  2. Sigue esta plantilla básica:
---
slug: mi-primer-post
title: Mi primer post
authors: [tu_usuario_github]
tags: [comunidad, ejemplo]
---

Aquí va el contenido de tu post.
  1. ¡Guarda y revisa tu post en http://localhost:3000/blog!

Proceso de colaboración​

  1. Crea una rama nueva:
git checkout -b mi-contribucion
  1. Realiza tus cambios y haz commit:
git add .
git commit -m "feat: agrego nuevo post"
  1. Envía tu rama al repositorio:
git push origin mi-contribucion
  1. Abre un Pull Request (PR) desde GitHub.

¿Dudas o sugerencias?​

  • Escríbenos en nuestro Meetup oficial o en el canal de comunicación que usemos.
  • También puedes abrir un issue directamente en el repositorio.

Gracias por sumarte y construir comunidad ¡Pura Vida!