diff --git a/docs/intro-to-oss/README.md b/docs/intro-to-oss/README.md index 645a12bd..28386373 100644 --- a/docs/intro-to-oss/README.md +++ b/docs/intro-to-oss/README.md @@ -12,6 +12,7 @@ Welcome to the Intro to Open Source Course with OpenSauced! This course is desig Like pizza, open source is meant to be shared with everyone. We provide and maintain translations in languages below as our official translations: - [French](./translations/fr/README.md) +- [Spanish](./translations/es/README.md) For translations in other languages that are maintained by our community, please go to the [Community Translations](../community-translations.md) section. diff --git a/docs/intro-to-oss/_navbar.md b/docs/intro-to-oss/_navbar.md index f2926a21..6f8d8539 100644 --- a/docs/intro-to-oss/_navbar.md +++ b/docs/intro-to-oss/_navbar.md @@ -4,5 +4,6 @@ - [Becoming a Maintainer](/becoming-a-maintainer/README.md) - [⭐ Star The Repo](https://github.com/open-sauced/intro) - Languages - - [:us: English](/intro-to-oss/) - - [:fr: French](/intro-to-oss/translations/fr/) + - [:us: English](../intro-to-oss/) + - [:fr: French](../intro-to-oss/translations/fr/) + - [:es: Spanish ](../intro-to-oss/translations/es/) \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/CONTRIBUTING.md b/docs/intro-to-oss/translations/es/CONTRIBUTING.md new file mode 100644 index 00000000..55aac372 --- /dev/null +++ b/docs/intro-to-oss/translations/es/CONTRIBUTING.md @@ -0,0 +1,281 @@ +# Contribuyendo a introducción con OpenSauced + +Las contribuciones siempre son bienvenidas, sin importar cuán grandes o pequeñas sean. Antes de contribuir, lea el [Código de conducta](https://docs.opensauced.pizza/contributing/code-of-conduct/) y siga las instrucciones de esta guía. + +## Estilo de comunicación recomendado + +1. Deje siempre capturas de pantalla para los cambios visuales. +2. Deje siempre una descripción detallada en la solicitud de extracción. No deje nada ambiguo para los revisores. +3. Siempre revise su código primero. Asegúrese de ejecutar el proyecto localmente y probarlo antes de solicitar una revisión. +4. Comuníquese siempre en el repositorio de GitHub. Ya sea en el problema o en la solicitud de extracción, mantener las líneas de comunicación abiertas y visibles para todos los miembros del equipo ayuda a todos los que lo rodean. + +## Problemas + +- Cuando contribuyas al proyecto por primera vez, considera revisar las etiquetas [error](https://github.com/open-sauced/intro/issues?q=is%3Aissue+is%3Aopen+label%3A%22%F0%9F%90%9B+bug%22) o [buen primer problema](https://github.com/open-sauced/intro/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) + +- Si desea trabajar en un problema abierto, comente con `.take` y se le asignará. Si un problema no está asignado, se supone que está disponible para que cualquiera pueda trabajar en él. Por lo tanto, asígnate un problema antes de comenzar a trabajar para evitar conflictos. + +- ¿Tienes una idea y quieres agregar una sección o un capítulo a un curso? ¿O detecta un error o tiene una idea para mejorar alguno de nuestros cursos? Puede crear un problema para solucionarlo. Pero nuestros encargados de mantenimiento deben clasificar el problema antes de que usted pueda trabajar en él. Si desea trabajar en el problema, etiquete al equipo `@open-sauced/docs` en el comentario para notificarles. + +Siempre puedes pedir ayuda en el canal `🍕opensauced-contributors-chat` en nuestra comunidad de [Discord](https://discord.com/invite/U2peSNf23P) o [GitHub Discussions](https://github.com/open-sauced/intro/discussions) si te quedas atascado mientras trabajas en tus cambios o necesitas una aclaración. + +## Empezando + +### Configurar el proyecto localmente + +1. [Bifurca](https://docs.github.com/en/get-started/quickstart/fork-a-repo) el [repositorio de introducción](github.com/open-sauced/intro) a tu propia cuenta de GitHub. +2. [Clona](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository) el repositorio bifurcado a su máquina local. + + ```bash + git clone https://github.com/YOUR-USERNAME/intro.git + ``` + +3. Navegue y abra el proyecto en su editor de código. + + ```bash + cd intro + ``` + +4. Cree una nueva rama para trabajar en sus cambios. + + ```bash + git checkout -b YOUR-BRANCH-NAME + ``` + + Reemplace "YOUR-BRANCH-NAME" con un nombre descriptivo para su rama — Por ejemplo, `feat/add-submit-button`. + +5. Ejecute el proyecto. + +### Ejecutar el proyecto localmente + +Ejecutar el proyecto localmente es esencial para ver los cambios en tiempo real y probarlos minuciosamente cuando contribuya. + +Recomendamos uno de estos dos métodos para ejecutar el proyecto en su máquina local: + +1. Usando la [CLI de Docsify](https://docsify.js.org/#/) +2. Aprovechando la extensión [Live Server](https://marketplace.visualstudio.com/items?itemName=ritwickdey.LiveServer) de Visual Studio Code. + +#### Método 1: Usando la CLI de Docsify + +1. **Instala Node.js**. + + Puede descargarlo desde el [sitio web oficial](https://nodejs.org/) de Node.js. + +2. **Instala docsify globalmente**. + + Se recomienda encarecidamente instalar docsify globalmente. En tu terminal, ejecuta el siguiente comando: + + ```bash + npm install -g docsify-cli + ``` + +3. **Ejecute el proyectot**. + + ```bash + docsify serve docs + ``` + + Este comando iniciará un servidor de desarrollo local y podrá acceder al proyecto en su navegador web en `http://localhost:3000`. + +4. **Realizar y probar cambios.** + + Con el servidor local en ejecución, puede realizar cambios en los archivos y ver inmediatamente los resultados en su navegador. Pruebe sus cambios a fondo. + +5. **Detenga el servidor.** + + Después de completar y probar los cambios, puede detener el servidor local presionando `Ctrl + C` en la terminal. + +#### Método 2: Aprovechando la extensión Live Server de Visual Studio Code. + +La extensión Live Server le permite iniciar un servidor de desarrollo local y obtener una vista previa de sus cambios en tiempo real en su navegador. + +1. **Instalar Visual Studio Code**. + + Descargar [Visual Studio Code](https://code.visualstudio.com/) e instálalo si no lo has hecho + +2. **Abrir el proyecto en VS Code**. + + Inicie VS Code, abra la carpeta del proyecto seleccionando "Archivo" > "Abrir carpeta" y elija el directorio del proyecto. + +3. **Instale la extensión Live Server**. + + - Haga clic en "Ver" en la barra superior del VS Code. + - Haga clic en "Extensiones". + + Alternativamente, presione el atajo `Ctrl + Shift + X `para abrir el menú "Extensiones". + + - Busque "Live Server" de Ritwick Dey e instálelo. + + +4. **Inicie Live Server**. + + Haga clic en el botón "Go Live" en la esquina inferior derecha de la ventana de VS Code. Se abrirá una nueva pestaña en su navegador en una dirección local. Luego, haga clic en la carpeta "docs" para ver el proyecto en modo en vivo. + +5. **Realizar y probar cambios**. + + Con Live Server en ejecución, puede realizar cambios en los archivos usando VS Code y los cambios se reflejarán automáticamente en su navegador. Pruebe sus cambios a fondo. + +6. **Detenga Live Server**. + + Cuando haya terminado de probar o realizar cambios, puede detener Live Server haciendo clic en el botón "Puerto: 5500" en la barra de estado de VS Code en la esquina inferior derecha. + +## Trabajando con el contenido + +Los contenidos de nuestros cursos están escritos en [Markdown](https://www.markdownguide.org/), un lenguaje de marcado liviano y fácil de usar que le permite formatear el texto de una manera legible y visualmente atractiva. + +Lea la sección ["Uso de Markdown para este proyecto"]() para obtener detalles sobre cómo usarlo en este proyecto. + +### Agregando definiciones al glosario + +Si agrega definiciones al capítulo "Glosario" en el [curso Introducción al Open Source](./glosario.md) o [Cómo convertirse en mantenedor](../../../becoming-a-maintainer/glossary.md), asegúrese de que las definiciones se agreguen **alfabéticamente**. + + +### Agregando una nueva sección a un capítulo + +Si su contenido puede pertenecer a la categoría de uno de los capítulos del curso, considere agregarlo como una nueva sección del capítulo. Crea un título de `heading 2` y escribe tu contenido. + +Puede agregar un nuevo capítulo si es más adecuado para una sección independiente. + +### Agregando un nuevo capítulo y agregarlo a la barra lateral + +En esta sección, lo guiaremos para agregar un nuevo capítulo a cualquiera de nuestros cursos y agregarlo a la barra lateral. + +#### Agregando un nuevo capítulo + +Siga estos pasos para agregar un nuevo capítulo a nuestro curso: + +1. **Crear un nuevo archivo Markdown** + + Cree un nuevo archivo Markdown (`.md`) en el directorio del curso y asigne un nombre al archivo que refleje el contenido del capítulo — por ejemplo, `como-contribuir-al-open-source.md` para un capítulo sobre cómo contribuir al Open Source. + + > **NOTE**: Asegúrese de seguir las convenciones de nomenclatura. Observe que los nombres de los archivos no están en mayúscula y que hay guiones en lugar de espacios entre las palabras. + +2. **Escribir contenido** + + Abra el archivo Markdown recién creado en un editor de texto y escriba el contenido de su capítulo usando la sintaxis de Markdown. Puede incluir encabezados, texto, imágenes, enlaces, listas y otros elementos para presentar su información de manera efectiva. + + > **NOTE**: Sólo debe haber un `heading 1` en cada archivo. + +3. **Probar los cambios**. + + Antes de finalizar su nuevo capítulo, debe probar sus cambios localmente. Puede crear o renderizar el proyecto para asegurarse de que su nuevo capítulo aparezca como se esperaba dentro de la estructura del curso. + +4. **Actualizar la barra lateral**. + + Después de agregar un nuevo capítulo, también debe agregarlo a la barra lateral para que los usuarios descubran el contenido. + +#### Agregando nuevos capítulos a la barra lateral + +La barra lateral de nuestro curso sirve como menú de navegación. Por lo tanto, cuando agrega un nuevo capítulo al curso, es importante actualizar la barra lateral incluyendo el enlace al capítulo. De esa manera, los usuarios pueden navegar hasta el contenido sin problemas. + +Siga estos pasos para agregar nuevos capítulos a la barra lateral: + +1. Abre el archivo `_sidebar.md` en el directorio del curso. +2. **Agregue el enlace del nuevo capítulo**. + + - Inserte su nuevo capítulo en la lista. Si no estás seguro de dónde es mejor colocarlo, puedes comentar sobre el problema y etiquetar a los mantenedores `@open-sauced/docs` para pedir ayuda. + - Utilice el siguiente formato para agregar el enlace al nuevo capítulo: + + ```markdown + - [Intro](intro.md) + ``` + + - Reemplace `Intro` con el título de su nuevo capítulo. Asegúrese de escribir el título en mayúscula inicial. + - Reemplace `intro.md` con el nombre del archivo Markdown de su nuevo capítulo + +3. **Crea una solicitud de extracción**. + + Una vez que haya creado el nuevo capítulo y haya verificado que cumple con los requisitos de nuestro proyecto, puede enviar su contribución creando una solicitud de extracción. + +4. **Revisión y retroalimentación**. + + Espere a que los mantenedores revisen su solicitud de extracción y prepárese para recibir comentarios de ellos o de sus colaboradores. Realice cambios si es necesario para refinar su contribución. + +Una vez que se acepte su contribución, su nuevo capítulo pasará a formar parte de nuestro curso, mejorando su contenido para usuarios y contribuyentes. + +## Usando Markdown para este proyecto + +Al contribuir a este proyecto, debe seguir nuestra convención de Markdown a continuación: + +### 1. Encabezados + +Utilice el símbolo almohadilla (`#`) para crear encabezados (títulos y subtítulos). Hay seis niveles de títulos de sección y el número de símbolos indica el nivel del título. + +```markdown +# Heading 1 + +## Heading 2 +``` + +### 2. Formato de texto + +- Ponga el texto en negrita encerrándolo con asteriscos dobles (`**`). +- Ponga el texto en cursiva encerrándolo con guiones bajos simples (`_`). +- Cree código en línea ajustando el texto con comillas invertidas (`` ` ``). + +```markdown +**This is a bold text.** + +_This is an italic text._ + +This is an `inline code`. +``` + +### 3. Listas + +- Crea listas ordenadas usando números seguidos de un punto (`1.`, `2.`, etc.). +- Cree listas desordenadas usando guiones (`-`). + +```markdown +1. Item 1 +2. Item 2 + +- Unordered Item 1 +- Unordered Item 2 +``` + +### 4. Enlaces + +Cree enlaces utilizando corchetes (`[]`) para el texto del enlace y paréntesis (`()`) para la URL. + +```markdown +[Open Source Education Path with OpenSauced](https://intro.opensauced.pizza/#/) +``` + +### 5. Imágenes + +Incruste imágenes usando un signo de exclamación (`!`), seguido de corchetes (`[]`) para el texto alternativo y paréntesis (`()`) para la URL de la imagen. + +```markdown +![Create new repository on GitHub](../_assets/images/new-repo.png) +``` + +### 6. Citas en bloque + +Cree citas en bloque usando el símbolo mayor que (`>`). + +```markdown +> This is a blockquote. +``` + +### 7. Bloques de código + +Cree bloques de código utilizando comillas invertidas triples (` ``` `) para bloques de código delimitados y especifique un idioma junto a los acentos graves antes del bloque de código delimitado para resaltar la sintaxis. + +```` +```bash +git pull +``` +```` + +### Consejos de Markdown + +- Obtenga una vista previa de su Markdown localmente para garantizar el formato adecuado antes de enviar su contribución. +- Mantenga organizado su contenido de Markdown y utilice títulos para estructurar sus secciones. +- Sólo puede haber un `heading 1` en cada capítulo. +- Utilice bloques de código para resaltar fragmentos de código o ejemplos de configuración. +- Consulte el sitio web oficial de [Markdown Guide](https://www.markdownguide.org/basic-syntax/) para obtener más información sobre el uso de Markdown. + +## Traduciendo los cursos + +Traducir nuestros cursos Introducción al Open Source abierto y Cómo convertirse en mantenedor ayuda a hacerlos más accesibles para una audiencia más amplia. Si desea traducir uno de estos cursos, lea nuestra página [🌐 Directrices i18n](../../../i18n-guidelines.md). \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/README.md b/docs/intro-to-oss/translations/es/README.md new file mode 100644 index 00000000..7a9a1e0d --- /dev/null +++ b/docs/intro-to-oss/translations/es/README.md @@ -0,0 +1,86 @@ +
+
+

Introducción al Open Source con OpenSauced +

+
+
+ +¡Bienvenido al curso de Introducción al Open Source con OpenSauced! Este curso está diseñado para brindarle una introducción al Open Source y guiarlo a través del proceso de contribución a proyectos Open Source. + +## Soporte de idiomas + +Al igual que la pizza, el Open Source debe compartirse con todos. Proporcionamos y mantenemos traducciones en los siguientes idiomas como nuestras traducciones oficiales:. + +- [Inglés](../../README.md) +- [Francés](../../translations/fr/README.md) + +Para traducciones en otros idiomas mantenidas por nuestra comunidad, vaya a la sección [Traducciones de la comunidad](../../../community-translations.md). + +## Resumen del curso + +El curso está dividido en capítulos, cada uno de los cuales cubre un aspecto diferente del Open Source: + +### [Introducción](introduccion.md) + +Este capítulo prepara el escenario para su viaje hacia el Open Source y analiza los requisitos previos, los objetivos y las expectativas. + +### [¿Qué es Open Source?](que-es-open-source.md) + +Este capítulo proporciona una introducción al Open Source, su historia y su importancia en el panorama actual del desarrollo de software. + +### [¿Por qué Open Source?](por-que-open-source.md) + +En este capítulo, aprenderá sobre los beneficios del Open Source Software, como una mayor colaboración, un desarrollo más rápido y una calidad mejorada. + +### [Herramientas para tener éxito](herramientas-para-tener-exito.md) + +Descubra las herramientas y plataformas clave necesarias para un viaje exitoso en el desarrollo Open Source. Desde Git y GitHub para control de versiones y colaboración y VS Code como editor de código, este capítulo proporciona una descripción general de cómo aprovechar estas herramientas esenciales. + +### [Cómo contribuir al Open Source](como-contribuir-al-open-source.md) + +Este capítulo cubre la búsqueda de proyectos en los que trabajar, el envío de contribuciones, la incorporación de contribuyentes a nuevos proyectos y los resultados después de enviar las contribuciones. Los consejos para encontrar proyectos incluyen navegar por GitHub y GitLab, seguir intereses personales, unirse a comunidades Open Source y utilizar plataformas como OpenSauced. + +### [La Salsa Secreta](la-salsa-secreta.md) + +Este capítulo se centra en proporcionar estrategias y consejos menos conocidos para lograr un impacto duradero en la comunidad Open Source. Este capítulo proporciona estrategias para encontrar problemas, ganar impulso en su recorrido por el Open Source y aprovechar OpenSauced para crear su currículum de Open Source. + +### [Tipos de contribuciones al Open Source](tipos-de-contribuciones.md) + +Este capítulo explica los tipos de contribuciones de codificación y no codificación involucradas en proyectos Open Source. + +### Informaciones complementarias + +Este es el comienzo de su viaje hacia el Open Source, por lo que le brindamos algunos recursos adicionales para ayudarlo a comenzar: + +- [Glosario](glosario.md): Un glosario de términos y definiciones comúnmente utilizados en el campo del Open Source. +- [Recursos adicionales](recursos-adicionales.md): una lista de recursos adicionales para aprender más sobre el Open Source, incluidas publicaciones de blog, tutoriales y guías. + +## Para comenzar + +Para comenzar el curso, simplemente navegue hasta el [`archivo introducción`](introduccion.md) en el repositorio o visite [Introducción al Open Source con el sitio web OpenSauced](https://intro.opensauced.pizza/) y comience a leer. + +?> **Consejo:** Cada capítulo se basa en el anterior, por lo que recomendamos leerlos en orden. + +A lo largo del curso, lo alentamos a experimentar con las herramientas y conceptos cubiertos en cada capítulo. La mejor manera de aprender es practicar, así que intenta contribuir a un proyecto real Open Source o crear tu propio proyecto desde cero. + +## Construyendo su currículum de Open Source + +Una de las características únicas de este curso es que proporciona orientación sobre cómo crear su CV de Open Source utilizando OpenSauced. OpenSauced es una plataforma que le ayuda a realizar un seguimiento y mostrar sus contribuciones al Open Source, lo que facilita que los posibles empleadores y colaboradores se destaquen. + +Para obtener más información sobre el uso de OpenSauced para crear su currículum de Open Source, consulte la sección [Construyendo su currículum de Open Source](la-salsa-secreta.md#construyendo-su-currículum-de-open-source) en el capítulo [La salsa secreta](la-salsa-secreta.md). + +--- + +¡Esperamos que encuentre este curso informativo y útil! Si tiene alguna pregunta o comentario, no dude en abrir un problema o comunicarse con nosotros en la [Comunidad OpenSauced Discord](https://discord.com/invite/U2peSNf23P). + +¡Feliz aprendizaje y buen aporte! + +--- + +## 🤝 Contribuyendo a este repositorio + +¡Te animamos a contribuir con OpenSauced! Todos los contribuyentes deben cumplir con nuestro [Código de conducta](https://github.com/open-sauced/.github/blob/main/CODE_OF_CONDUCT.md). Consulte las [Pautas de contribución](CONTRIBUTING.md) para obtener información sobre cómo contribuir. + +Si desea traducir nuestro curso de Introducción al Open Source, consulte nuestras 🌐 [Directrices i18n](../../../i18n-guidelines.md). + +[![Licencia Creative Commons](https://i.creativecommons.org/l/by/4.0/88x31.png)](https://creativecommons.org/licenses/by/4.0/) \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/_navbar.md b/docs/intro-to-oss/translations/es/_navbar.md new file mode 100644 index 00000000..130ec55b --- /dev/null +++ b/docs/intro-to-oss/translations/es/_navbar.md @@ -0,0 +1,10 @@ +- [Página de inicio](../../../README.md) +- [Empezar](../../../intro-to-oss/translations/es/) +- Cursos + - [Intro to Open Source](/intro-to-oss/README.md) + - [Becoming a Maintainer](/becoming-a-maintainer/README.md) +- [⭐ Repositorio Estrella](https://github.com/open-sauced/intro) +- Idiomas + - [:us: Inglés ](../../../intro-to-oss/) + - [:fr: Francés ](../../../intro-to-oss/translations/fr/) + - [:es: Español ](../../../intro-to-oss/translations/es/) \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/_sidebar.md b/docs/intro-to-oss/translations/es/_sidebar.md new file mode 100644 index 00000000..c2c7d7ff --- /dev/null +++ b/docs/intro-to-oss/translations/es/_sidebar.md @@ -0,0 +1,13 @@ +[![OpenSauced Logo](../../../_assets/images/logo-on-dark.png)](https://opensauced.pizza/) + +- Páginas + - [Introducción](introduccion.md) + - [¿Qué es Open Source?](que-es-open-source.md) + - [¿Por qué Open Source?](por-que-open-source.md) + - [Herramientas para tener éxito](herramientas-para-tener-exito.md) + - [Cómo contribuir al Open Source](como-contribuir-al-open-source.md) + - [La Salsa Secreta](la-salsa-secreta.md) + - [Tipos de contribuciones al Open Source](tipos-de-contribuciones.md) + - [Conclusión](conclusion.md) + - [Recursos adicionales](recursos-adicionales.md) + - [Glosario](glosario.md) \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/como-contribuir-al-open-source.md b/docs/intro-to-oss/translations/es/como-contribuir-al-open-source.md new file mode 100644 index 00000000..9a8317d9 --- /dev/null +++ b/docs/intro-to-oss/translations/es/como-contribuir-al-open-source.md @@ -0,0 +1,501 @@ +# Cómo contribuir al Open Source + +En este capítulo, lo guiaremos a través del proceso de contribución a proyectos Open Source. + +## Encontrar proyectos en los que trabajar + +Uno de los primeros desafíos que puede enfrentar al comenzar con el Open Source es encontrar un proyecto en el que contribuir. A continuación se ofrecen algunos consejos que le ayudarán a descubrir proyectos que se alineen con sus intereses y habilidades: + +1. **Explore GitHub y GitLab**: Tanto GitHub como GitLab albergan una gran cantidad de proyectos Open Source. Puede utilizar su función de búsqueda para encontrar proyectos basados ​​en palabras clave, lenguajes de programación o temas específicos. + +2. **Siga sus intereses**: piense en las herramientas, marcos de trabajo y bibliotecas que utilizas o sobre las que te interesa aprender un poco más. Muchos de estos proyectos son Open Source y agradecen las contribuciones de la comunidad. + +3. **Únase a comunidades Open Source**: existen numerosas comunidades, foros y plataformas de chat en línea dedicados al desarrollo Open Source. Al unirte a estas comunidades, puedes conectarte con otros desarrolladores, descubrir nuevos proyectos y encontrar oportunidades de colaboración. En el [Discord de OpenSauced ](https://discord.com/invite/U2peSNf23P), por ejemplo, compartimos "buenos primeros problemas", proyectos interesantes de GitHub y problemas que tenemos abiertos en nuestros repositorios. + +4. **Aproveche OpenSauced**: [OpenSauced](https://opensauced.pizza/) es una plataforma que ayuda a los desarrolladores a descubrir y contribuir a proyectos Open Source. Al utilizar OpenSauced, puede encontrar proyectos que se alineen con sus intereses, habilidades y objetivos. + +### Descubriendo el Open Source con OpenSauced + +OpenSauced es una poderosa herramienta para encontrar proyectos Open Source en los que contribuir. Para comenzar con OpenSauced, siga estos pasos: + +1. **Regístrese para obtener una cuenta**: visite https://www.opensauced.pizza/ y regístrese para obtener una cuenta utilizando sus credenciales de GitHub. + + ![Registro en OpenSauced](../../../_assets/images/opensauced-signup.png) + + Durante el proceso de registro, se le pedirá que elija algunos intereses y establezca su zona horaria. Esto ayudará a OpenSauced a recomendar proyectos que se ajusten a sus intereses y cronograma. + +2. **Explore el panel**: una vez que se haya registrado, accederá a su panel, donde podrá ver sus proyectos, objetivos y contribuciones actuales. Al hacer clic en "Explorar" en el encabezado, podrá buscar proyectos según sus intereses y habilidades. + +3. **Buscar proyectos**: en Explorar, puede ver una lista de repositorios y sus niveles de actividad relevantes y niveles de participación que son tendencia actualmente. También puedes buscar proyectos escribiendo en la barra de búsqueda. Puede buscar proyectos por nombre, descripción o tema y utilizar esta herramienta para encontrar algo que le interese. + + ![Explorar el panel](../../../_assets/images/opensauced-explore.png) + +4. **Guarde proyectos en sus páginas de Insights**: cuando encuentre proyectos que le interesen, puede agregarlos a las páginas de "Insights" que le brindan más detalles sobre la actividad de los proyectos. O, si prefieres simplemente sumergirte y contribuir, puedes pasar al siguiente paso. + +5. **Empieza a contribuir**: cuando haces clic en el nombre de un repositorio, accederás a su página de GitHub, donde podrás explorar temas que están abiertos y listos para contribuir, sabiendo que la comunidad que rodea este proyecto está activo y sus contribuciones serán bienvenidas. + +Al utilizar OpenSauced, puede agilizar el proceso de búsqueda de proyectos Open Source en los que trabajar y concentrarse en contribuir a los proyectos que se alinean con sus intereses y objetivos. + +## Incorporación en un nuevo proyecto + +Cuando esté interesado en contribuir a un nuevo proyecto Open Source, es importante familiarizarse con las pautas, convenciones y flujo de trabajo del proyecto y tomar la iniciativa de incorporarse. + +A continuación se ofrecen algunos consejos que le ayudarán a incorporarse con éxito: + +1. **Lea la documentación del proyecto**: lea el archivo README, las pautas de contribución y el código de conducta para familiarizarse con el proyecto. Le ayudarán a comprender los objetivos, requisitos y expectativas del proyecto para los contribuyentes. + +2. **Empiece poco a poco**: cuando es nuevo en un proyecto, es una buena idea comenzar con tareas pequeñas y manejables, como corregir errores, agregar pruebas o actualizar documentación. Esto le ayudará a familiarizarse con la base del código y el flujo de trabajo de desarrollo sin sentirse abrumado. + +3. **Únase a la comunidad**: muchos proyectos Open Source tienen comunidades, foros o plataformas de chat en línea donde los desarrolladores pueden hacer preguntas, compartir conocimientos y colaborar. Al unirse a estas comunidades, puede conectarse con otros contribuyentes, aprender de sus experiencias y obtener ayuda con cualquier problema que encuentre. + +4. **Pide ayuda**: Si necesitas una aclaración o encuentras algún problema, no dudes en pedir ayuda. Las comunidades Open Source generalmente son solidarias y acogedoras; Otros contribuyentes estarán encantados de ayudarle. + +5. **Sea paciente y persistente**: incorporarse a un nuevo proyecto puede ser un desafío, especialmente si es nuevo en el desarrollo Open Source. Sea paciente y no se desanime ante los obstáculos o errores. Te sentirás más cómodo y seguro en tus contribuciones con perseverancia y práctica. + +## Comenzando a contribuir + +Entonces, te has incorporado al proyecto. Ahora puedes prepararte para contribuir siguiendo estos pasos: + +### 1. Lea la documentación + +Tocamos esto brevemente en la sección anterior. Pero vale la pena volver a visitarlo porque es importante leer detenidamente la documentación del proyecto antes de comenzar a contribuir. + +Comience leyendo el README y familiarizándose con el proyecto. Un README contiene una introducción al proyecto, como cómo funciona, su propósito, el stack tecnologíco que utiliza y cómo configurar y ejecutar el entorno local. + +Una vez que esté familiarizado con el proyecto y esté interesado en contribuir, no se lance sin leer las pautas de contribución. Estas pautas se encuentran en el archivo CONTRIBUTING en la raíz del proyecto. Si el archivo no está disponible, puede encontrarlo en el archivo README. + +Cada proyecto tiene diferentes reglas de contribución. Estas reglas están escritas en las pautas de contribución, que contienen información sobre cómo reclamar y trabajar con problemas, crear solicitudes de extracción y métodos de comunicación preferibles. Por ejemplo, puede consultar las [Pautas de contribución de OpenSauced](https://docs.opensauced.pizza/contributing/introduction-to-contributing/). + +Algunos proyectos también tienen convenciones, como código y estilo Markdown, cómo escribir mensajes de confirmación, solicitudes de extracción y títulos de problemas, etc. Puede encontrarlos en su guía de estilo o en sus pautas de contribución. + +?> Lea atentamente las pautas de contribución para comprender cómo el proyecto recibe contribuciones. Seguir estas pautas hará que su proceso de contribución sea más sencillo. + +### 2. Buscar o crear un problema + +Después de leer la documentación, puede comenzar a buscar problemas etiquetados como "buen primer problema" o "apto para principiantes" que sean adecuados para su nivel de habilidad. Al elegir en qué problema trabajar, considere sus intereses, nivel de habilidad y tiempo disponible. + +Los problemas pueden verse como propuestas de cambios. Supongamos que desea informar un error o tiene ideas para una característica o mejora del proyecto o su documentación y desea proponerlas. En ese caso, puedes crear un problema para proponer tu intención. Lea [esta publicación de blog](https://dev.to/opensauced/streamline-your-contributions-mastering-issue-forms-and-pr-templates-36j5) para aprender cómo completar formularios de incidencias. + +En open source, es crucial acompañar una solicitud de extracción con un problema por varias razones: + +- **Contexto y discusión**: Dar contexto a su propuesta y discutirla con los mantenedores puede ayudar a garantizar que el cambio propuesto esté alineado con los objetivos, la arquitectura y la hoja de ruta del proyecto. Esta discusión ayuda a establecer expectativas claras y aumenta las posibilidades de que se acepte su solicitud de extracción. + +- **Documentación y Seguimiento**: Los problemas actúan como una forma de documentación, proporcionando un registro histórico del problema identificado, la solución propuesta y el proceso de toma de decisiones detrás del cambio. Ayudan a los mantenedores a seguir el progreso del proyecto y priorizar las tareas. Al mismo tiempo, también permiten que otros contribuyentes comprendan el contexto y las razones detrás de los cambios introducidos en la solicitud de extracción. + +- **Disminuir la comunicación bidireccional**: Discutir y acordar los cambios propuestos con anticipación a través del problema puede reducir la comunicación bidireccional durante el proceso de revisión de la solicitud de extracción. Esto puede ahorrarle tiempo a usted y a los mantenedores. + +- **Evitar el trabajo innecesario**: La creación de un problema permite a los mantenedores brindar comentarios tempranos sobre el cambio propuesto. Pueden avisarte si existe un problema similar, si el cambio propuesto se alinea con los objetivos del proyecto o si existen métodos alternativos que sean más convenientes. Esto le ayuda a evitar perder tiempo y esfuerzo trabajando en algo que tal vez no sea aceptado porque entra en conflicto con los planes existentes. + +- **Evitar solicitudes de extracción de spam**: Las solicitudes de extracción no solicitadas (solicitudes de extracción sin problemas) y no deseadas pueden marcarse como spam porque se considera que introducen cambios irrelevantes, de baja calidad o dañinos en el código base del proyecto. Marcar su solicitud de extracción como spam puede provocar rechazo, pérdida de oportunidades de contribución y potencialmente dañar su reputación. + +### 3. Solicitar que se te asigne un problema + +Ciertos proyectos pueden tener reglas específicas con respecto a la asignación de problemas. Es posible que algunos proyectos requieran que solicites permiso antes de trabajar en un problema, mientras que otros te permiten asignarte un problema. Es por eso que revisar las pautas de contribución del proyecto es esencial para saber cómo reclamar problemas. + +Si las pautas de contribución no indican cómo reclamar un problema, puede pedirles a los mantenedores que se lo asignen. Esto asegurará que no haya duplicaciones y que su contribución esté alineada con los objetivos y requisitos del proyecto. + +Puede dejar un comentario sobre el problema, como "¿Me pueden asignar este problema?" Cuando el mantenedor te lo haya asignado, notarás que tu nombre de usuario ahora se encuentra en la sección "Asignados". + +![Sección de asignatarios de problemas en GitHub](../../../_assets/images/issue-assign.png) + +## Flujo de trabajo de contribución + +Una vez que un mantenedor le haya asignado un problema, el siguiente paso es trabajar en los cambios. Aquí hay un flujo de trabajo general del proceso: + +### 1. Bifurcar el repositorio + +[Bifurcar un repositorio](https://docs.github.com/en/get-started/quickstart/fork-a-repo#forking-a-repository) significa crear una copia del repositorio en su cuenta de GitHub. Le permite enviar cambios al código base remoto sin afectar el proyecto original. + +### 2. Clonar el repositorio bifurcado + +[Clonar su repositorio bifurcado](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository#cloning-a-repository) significa hacer una copia de su repositorio bifurcado en su máquina local. Ejecute el siguiente comando en su terminal: + + ``` + git clone https://github.com/TU-USUARIO/NOMBRE-DEL-REPOSITORIO.git + ``` + + Reemplace "TU-USUARIO" con su nombre de usuario de GitHub y "NOMBRE-DEL-REPOSITORIO" con el nombre del repositorio. + +### 3. Crea una nueva rama + +Antes de realizar cualquier cambio, cree una nueva rama en su repositorio local para trabajar en su contribución. Crear una nueva rama es la mejor práctica en Open Source porque mantiene los cambios separados de la rama `main`. + + Puede crear una nueva rama usando el siguiente comando: + + ``` + git checkout -b NOMBRE-DE-SU-RAMA + ``` + + Reemplace "NOMBRE-DE-SU-RAMA" con un nombre descriptivo para su rama, como "fix-bug-123" o "agregar-nueva-función". + +### 4. Haga sus cambios + +Ahora que tiene una nueva rama, puede realizar cambios en el código base. Siga siempre las pautas y convenciones de codificación del proyecto. + +### 5. Ejecute los cambios localmente + +Siempre debes ejecutar y verificar tus cambios en tu entorno local, sin importar cuán pequeños sean. Esto es importante para garantizar que funcionen como se espera y no rompan producción. + +Puedes encontrar las instrucciones sobre cómo ejecutar un proyecto localmente en el archivo README o en las pautas de contribución. + +### 6. Agregue y confirme los cambios + +Una vez que haya realizado los cambios, agréguelos al área de preparación y confírmelos con estos comandos: + + ``` + git add . + git commit -m "Tu mensaje de confirmación" + ``` + + Reemplace `"Tu mensaje de confirmación"` con una breve descripción de sus cambios. + +### 7. Envíe sus cambios + +Envíe sus cambios a su repositorio bifurcado en GitHub ejecutando el siguiente comando: + + ``` + git push origin NOMBRE-DE-SU-RAMA + ``` + + Reemplace `"NOMBRE-DE-SU-RAMA"` con el nombre de su rama. + +### 8. Trabajando con una solicitud de extracción + +#### Cree una solicitud de extracción + +Una vez que haya enviado sus cambios, ahora puede crear una [solicitud de extracción](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork). Para crear una solicitud de extracción: + +1. Navegue hasta el repositorio del proyecto original en GitHub. +2. Haga clic en el botón "Comparar y solicitar extracción". +3. Complete toda la información requerida en la plantilla. +4. Haga clic en el botón "Crear solicitud de extracción". + +#### Complete una plantilla de solicitud de extracción + +Puede resultar complicado leer y completar una plantilla de solicitud de extracción. A continuación se ofrecen algunos consejos sobre cómo llenar uno: + +1. **Modo de vista previa** + + Haga clic en la pestaña "Vista previa" para ver las secciones que debe completar antes de hacerlo. Le resultará más fácil notarlos en este modo, pero tenga en cuenta que no puede editarlos en el modo de vista previa. + + A continuación se muestra un ejemplo de una plantilla de solicitud de extracción en OpenSauced en modo de vista previa: + + ![plantilla de vista previa para solicitud de extracción](../../../_assets/images/pr-template-preview.png) + +2. **Encabezados** + + Vuelva al modo de escritura haciendo clic en la pestaña "Escribir". Preste atención a los títulos con el símbolo #. Debe proporcionar información justo debajo de estos títulos. + +3. **Comentarios** + + Las instrucciones sobre qué información debe proporcionar generalmente están escritas en los comentarios debajo de cada encabezado. Debe leer y seguir todas las instrucciones minuciosamente. + + ?> **Consejo:** Al completar la información, escríbela debajo del comentario para que aún puedas ver y seguir las instrucciones. + + Aquí está la plantilla en Markdown. Ahora, preste atención a los títulos y comentarios que comentamos: + + ```markdown + ## Description + + + + ## Related Tickets & Documents + + + + ## Mobile & Desktop Screenshots/Recordings + + + + ## Steps to QA + + + + ## Tier (staff will fill in) + + - [ ] Tier 1 + - [ ] Tier 2 + - [ ] Tier 3 + - [ ] Tier 4 + + ## [optional] What gif best describes this PR or how it makes you feel? + + + + + ``` + +4. **No omita ni elimine nada en la plantilla.** + + Lo importante es que debe completar cada sección de la plantilla que no diga "opcional" o que no deba completarla el equipo central o el personal. Además, nunca debe eliminar ni modificar la plantilla, incluso si Piensa que una sección no se aplica a tu contribución. + + Si una sección es irrelevante para sus cambios, deje un comentario explicando por qué es irrelevante o proporcione una breve respuesta "N/A". Si aún necesita ayuda con qué completar, mire las solicitudes de extracción anteriores y vea cómo otros contribuyentes lo han hecho. + +##### Información requerida para proporcionar en la mayoría de las plantillas de solicitud de extracción + +Cada proyecto es único. Cada uno tiene su propia estructura de plantilla de solicitud de extracción y requiere que se proporcione información específica. Sin embargo, todos los proyectos normalmente requieren lo siguiente: + +- **Título** + + Agregue un título breve y claro que describa el cambio que realiza. Por ejemplo, "Fix: Color contrast in the landing page". + +- **Descripción** + + Explique sus cambios con el mayor detalle posible. ¿Qué arreglaste? ¿Cómo lo arreglaste? ¿Agregaste una nueva función o modificaste una función? Si hay varios cambios, considere utilizar viñetas y proporcionar enlaces a los recursos que utiliza para realizar copias de seguridad de sus cambios. + + Aquí hay un ejemplo: + + ```markdown + ## Description + + + + This PR fixes the long repos' names that are partially stacked at the back of another name in the search input of the Explore tab. + + The changes made here: + + - Add Tailwind className: + + - [`truncate`](https://tailwindcss.com/docs/text-overflow#truncate) to truncate overflowing text. + - [`tracking-tighter`](https://tailwindcss.com/docs/letter-spacing) to reduce letter spacing for better space. + - `inline-block` to the `` . + + - Remove Tailwind classNames: + + - `overflow-hidden` as it's [included in the `truncate`](https://tailwindcss.com/docs/text-overflow). + - `break-all` as we don't want to add line breaks. + ``` + +- **Problema(s) relacionados** + + La mayoría de los proyectos no reciben solicitudes de extracción no solicitadas (solicitudes de extracción que no van acompañadas de un problema). Una razón es evitar solicitudes de extracción no deseadas que podrían introducir cambios irrelevantes, de baja calidad o dañinos en el código base del proyecto. + + Entonces, cuando crea una solicitud de extracción, desea incluir el número de problema relacionado. Añade la palabra clave "Closes," "Fixes," o "Resolves" delante del número del problema, por ejemplo, "Closes #123". + + [Vincular una solicitud de extracción a un problema](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue) cerrará automáticamente el problema una vez que la solicitud de extracción se fusione. + + Puedes encontrar el número del problema justo después del título, como se muestra a continuación. + + ![Número del problema](../../../_assets/images/issue-number.png) + + !> Agregue aquí solo la [palabra clave admitida](https://docs.github.com/en/free-pro-team@latest/github/managing-your-work-on-github/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword) y el número de problema. Agregar más palabras evitará que el problema se cierre automáticamente. + +- **Capturas de pantalla y grabaciones de pantalla** + + Si sus cambios se relacionan con la mejora de la interfaz de usuario, considere agregar capturas de pantalla o grabaciones de pantalla para mostrar los cambios antes y después. + +### 9. Responder a la retroalimentación + +Después de enviar su solicitud de extracción, los mantenedores del proyecto pueden proporcionar comentarios o solicitar cambios. Asegúrese de responder con prontitud y abordar cualquier inquietud o sugerencia que puedan tener. + +Si sigue estos pasos, podrá enviar sus contribuciones a proyectos Open Source y colaborar con otros desarrolladores para mejorar el código base. + +## ¿Qué pasa después? + +Una vez enviada y revisada su contribución, puede ocurrir uno de los siguientes resultados: + +1. **Se acepta su contribución**: si los mantenedores del proyecto aprueban su contribución, se fusionará en la rama principal del código base.
+ ¡Felicidades! Su trabajo ahora es parte del proyecto y ha realizado una valiosa contribución a la comunidad Open Source. + +2. **Su contribución requiere cambios**: A veces, los mantenedores del proyecto pueden solicitar cambios en su contribución antes de que pueda ser aceptada. Esto podría deberse a problemas de codificación, conflictos con otros cambios o la necesidad de documentación adicional. En este caso, realice los cambios solicitados y vuelva a enviar su solicitud de extracción. + +3. **Su contribución es rechazada**: En algunos casos, su contribución puede no alinearse con los objetivos o requisitos del proyecto, o puede no ser la mejor solución a un problema. Si tu contribución es rechazada, no te desanimes. Tome los comentarios que recibió como una oportunidad para aprender y mejorar. Siempre puedes intentar contribuir a otro proyecto o enviar una contribución diferente al mismo proyecto. + +## Seamos prácticos + +Ahora que sabes cómo encontrar y contribuir a proyectos Open Source, es hora de poner tus habilidades en práctica. Hagámoslo contribuyendo al [repositorio de libros de visitas de OpenSauced](https://github.com/open-sauced/guestbook). + +### Requisito previo + +Necesitará tener estas herramientas descargadas e instaladas en su máquina local: + +- [Node.js](https://nodejs.org) +- [Visual Studio Code (VS Code)](https://code.visualstudio.com/) + +### Empezando + +1. Cree un problema siguiendo estas instrucciones: + + - Haga clic en la pestaña "Problemas" en la barra superior. + - Haga clic en el botón verde "Nuevo problema" en la parte superior derecha. + - Haga clic en el botón "Comenzar" para agregar contribuyentes. + - Agregue un título, por ejemplo, `Feature: Add @GITHUB-USERNAME as a contributor`.
Cambie "@GITHUB-USERNAME" por su nombre de usuario de GitHub. + - Completa el formulario. Puede consultar el ejemplo en cada área de texto para completarlos, como se muestra en la captura de pantalla a continuación con la línea roja. + + ![Formulario de problemas del libro de visitas](../../../_assets/images/guestbook-issue-form.png) + + - Haga clic en el botón "Enviar nuevo problema". + +2. Bifurque el [repositorio de libros de visitas](https://github.com/open-sauced/guestbook). +3. Clona tu repositorio bifurcado en tu computadora. +4. Ejecute `npm install` para instalar las dependencias. +5. Cree una nueva rama y use un nombre descriptivo relacionado con su contribución, por ejemplo, `feat/add-alice`. +6. Ejecute `npm run contributors:add` en su terminal + + Siga las instrucciones para agregarse al libro de visitas. Después de terminar y hacer clic en Intro, debe hacer clic en Intro nuevamente para confirmar sus elecciones. + + ![Agregar colaborador con CLI en una terminal](../../../_assets/gifs/cli-tool.gif) + +7. Ejecute `npm run contributors:generate` en su terminal para generar el libro de visitas en el archivo README. +8. Copie y pegue el Markdown del archivo README en [Markdown Live Preview](https://markdownlivepreview.com/) y tome una captura de pantalla de su perfil generado. Lo necesitarás más adelante cuando crees una solicitud de extracción. + + ![Perfil generado en README](../../../_assets/images/profile-generated.png) + + > **Consejo**: Si no ves tu perfil en la sección "Colaboradores", aleja la pantalla hasta que puedas verlo antes de tomar una captura de pantalla. + +9. Ejecute `git log` para verificar si ha confirmado sus cambios. Presione `Q` para cerrar el registro. + + Esto es lo que debería esperar ver como mensaje de confirmación: + + ```bash + docs: add @your_username as a contributor + ``` + +10. Envía la confirmación a tu repositorio bifurcado con este comando: + + ```bash + git push -u origin branch-name + ``` + +11. Vaya a su repositorio bifurcado en GitHub. Crea una solicitud de extracción con el título `feat: Add <@github-username> as a contributor` y complete todas las áreas en la plantilla de la solicitud de extracción. Lea la sección [complete una plantilla de solicitud de extracción](#complete-una-plantilla-de-solicitud-de-extracción) para ayudarle a completar la plantilla. + + !> Su solicitud de extracción se marcará como no válida y podrá cerrarse si la plantilla está incompleto. + +¡Felicitaciones por tu primera contribución! 🎉 + +?> Si está listo para su próxima contribución, consulte el [repositorio de pizza-verso](https://github.com/open-sauced/pizza-verse) y siga las pautas de contribución. + +## Mantener las ramas actualizadas + +Se recomienda encarecidamente que actualice sus ramas locales y remotas habitualmente. De esa manera, su rama tendrá la última actualización cuando se fusione con la rama `main` del repositorio original (`upstream`). + +Los mejores momentos para actualizar sus ramas son antes de enviar sus cambios al repositorio remoto y mientras espera que se revise su solicitud de extracción. + +### Actualizando ramas + +Primero, debes actualizar tu repositorio bifurcado (`origin`): + +1. Vaya a su repositorio bifurcado en GitHub. +2. Haga clic en el botón "Sincronizar bifurcación". +3. Haga clic en el botón verde "Actualizar rama". + +Luego, extraiga los últimos cambios en la rama `main` en el repositorio `origin` para actualizar su rama de trabajo local siguiendo estos pasos en su terminal: + +1. Dirígete a tu rama de trabajo. + + ```bash + git checkout NOMBRE-DE-TU-RAMA + ``` + +2. Obtenga los últimos cambios con este comando: + + ```bash + git pull origin main + ``` + +## Fusionar conflictos + +Los conflictos de fusión son algo que encontrarás comúnmente al contribuir a un proyecto Open Source. Cuando dos ramas han realizado cambios diferentes en las mismas líneas en los mismos archivos, Git no puede determinar automáticamente qué cambio conservar, lo que genera un conflicto. + +Cuando ocurre un conflicto de fusión, Git agrega marcadores de conflicto (`<<<<<<<`, `=======` y `>>>>>>`) para indicar las líneas en conflicto de diferentes ramas. Todo lo que está entre `<<<<<<<` y `=======` son los cambios en los que trabajó (cambios actuales). Y todo entre `=======` a `>>>>>>>` son los cambios entrantes de la rama remota `main`. + +Debes prestar atención a los conflictos y decidir cómo quieres resolverlos. Puede conservar solo su cambio, el cambio entrante o ambos cambios. + +### Consejos para evitar resolver conflictos de fusión repetidamente + +Algunos repositorios Open Source, como los repositorios [libro de visitas](https://github.com/open-sauced/guestbook) y [pizza-verso](https://github.com/open-sauced/pizza-verse) de OpenSauced, tienen actividades de alta contribución en los mismos archivos que pueden causar conflictos de fusión. + +A continuación se ofrecen algunos consejos para evitar que resuelva conflictos de fusión repetidamente cuando contribuya a proyectos Open Source: + +#### 1. Seguir instrucciones + +Asegúrese de seguir las instrucciones del archivo README o Guía de contribución del proyecto y no se pierda ningún paso. + +#### 2. Formulario de solicitud de extracción + +Complete el formulario de plantilla y complete todas las áreas al crear una solicitud de extracción. + +Si un repositorio no le proporciona una plantilla de solicitud de extracción, debe tenerla en su formulario de solicitud de extracción: + +- **Un título descriptivo**: Un título descriptivo ayudaría a los mantenedores y otros contribuyentes a tener una idea de cuál es su contribución.
+ Considere utilizar el siguiente método para escribir su título: `tipo: breve descripción de su contribución`. Por ejemplo, `solucionar: problema de contraste de color en la barra de navegación`, `característica: crear un botón de advertencia`, etc. + +- **Una descripción clara de tu solicitud de extracción**: describe claramente tu solicitud de extracción. Considere explicar sus cambios, ideas detrás de la solución, etc. Una descripción clara brinda a los mantenedores y otros contribuyentes información sobre los detalles de sus cambios. Aquí hay [un ejemplo de una descripción clara en una solicitud de extracción](https://github.com/open-sauced/intro/pull/10). + +- **El [enlace al problema relacionado](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue)**: Vincular una solicitud de extracción al problema abordado cerrará el problema vinculado automáticamente cuando la solicitud de extracción se fusione. Esto facilita que los mantenedores mantengan sus proyectos organizados. + +- **Una captura de pantalla o grabación de pantalla cuando realiza un cambio en la interfaz de usuario**: proporcionar capturas de pantalla o grabaciones de pantalla facilitará que el mantenimiento visualice sus cambios y revise su solicitud de extracción. + +#### 3. Resolver conflictos de fusión inmediatamente + +Si una rama tiene conflictos de fusión que deben resolverse, el botón de fusión se desactiva automáticamente. Por lo tanto, los mantenedores no pueden fusionar la solicitud de extracción. + +Cuando observe conflictos de fusión en su solicitud de extracción o si un responsable de mantenimiento le pide que resuelva los conflictos de fusión, corríjalos de inmediato. Cuanto antes resuelva los conflictos, antes los mantenedores podrán revisar y fusionar su solicitud de extracción. + +### Fusionar conflictos en el repositorio del libro de visitas + +Dado que el propósito principal del libro de visitas es agregar su nombre a los archivos `.all-contributorsrc` y `README.md`, existe una alta probabilidad de que encuentre conflictos de fusión. + +Los conflictos ocurren cuando los mantenedores han fusionado solicitudes de extracción antes que la suya mientras usted trabaja en sus cambios o espera que se revise su solicitud de extracción. Y debe resolverlos antes de que se pueda fusionar su solicitud de extracción. + +#### Resolución de conflictos de fusión + +Antes de resolver conflictos de fusión, primero debe [actualizar sus ramas](#actualizando-ramas). Luego, sigue estos pasos: + +1. En el archivo `.all-contributorsrc`: + + - Haga clic en la opción "Aceptar ambos cambios" en la parte superior de su espacio de trabajo en VS Code. + - Mueva los detalles de su perfil al final de la lista de contribuyentes y corrija todo lo necesario. + +2. En el archivo `README.md`: + + - Haga clic en la opción "Aceptar cambios entrantes" en la parte superior de su espacio de trabajo en VS Code para cada conflicto en este archivo. + +3. Ejecute `npm run contributors:generate`. + + Ahora verá que la insignia de todos los contribuyentes se ha incrementado y su perfil se genera al final de la lista de contribuyentes en el archivo `README.md`. + +4. Agregue y confirme sus cambios. + + ```bash + git commit -am "Resolver conflictos de fusión" + ``` + +5. Envíe sus confirmaciones a su rama remota. + + ```bash + git push + ``` + +
+ +A medida que continúe contribuyendo a proyectos Open Source, obtendrá experiencia valiosa, desarrollará nuevas habilidades y creará un sólido portafolio de trabajo. En el [próximo capítulo](la-salsa-secreta.md), analizaremos algunas estrategias para comenzar con las contribuciones en Open Source, ganar terreno en sus contribuciones y desarrollar su currículum de Open Source utilizando OpenSauced. diff --git a/docs/intro-to-oss/translations/es/conclusion.md b/docs/intro-to-oss/translations/es/conclusion.md new file mode 100644 index 00000000..e506ba0a --- /dev/null +++ b/docs/intro-to-oss/translations/es/conclusion.md @@ -0,0 +1,41 @@ +# Conclusión + +Mientras concluimos este curso sobre cómo comenzar con el Open Source, recapitulemos los puntos clave y analicemos lo que sigue en su viaje hacia el Open Source. + +## Conclusiones clave + +A lo largo de este curso, cubrimos una variedad de temas diseñados para ayudarlo a comprender y navegar por el mundo del Open Source: + +- **[¿Qué es Open Source?](que-es-open-source.md)**: Discutimos la definición de Open Source, su historia y los principios básicos que guían el movimiento del Open Source. + +- **[¿Por qué Open Source?](por-que-open-source.md)**: Exploramos los beneficios de participar en proyectos Open Source, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. + +- **[Herramientas para tener éxito](herramientas-para-tener-exito.md)**: presentamos herramientas y plataformas esenciales para contribuyentes del Open Source, como GitHub, Git, Visual Studio Code y Discord. + +- **[Cómo contribuir al Open Source](como-contribuir-al-open-source)**: Discutimos el proceso de encontrar proyectos en los que trabajar, enviar contribuciones, incorporarse a nuevos proyectos y qué sucede después de enviar su contribución. + +- **[La salsa secreta](la-salsa-secreta.md)**: compartimos estrategias para comenzar con las contribuciones en Open Source, ganar terreno en sus contribuciones y desarrollar su currículum de Open Source utilizando OpenSauced. + +- **[Tipos de contribuciones al Open Source](tipos-de-contribuciones.md)**: Compartimos los tipos de contribuciones de codificación y no codificación en Open Source, junto con ejemplos. + +Al comprender estos conceptos y aplicar las estrategias que hemos analizado, estará bien equipado para embarcarse en un viaje exitoso hacia el Open Source. + +## ¿Que sigue? + +Con el conocimiento y las herramientas que obtuvo en este curso, está listo para sumergirse en el mundo del Open Source y comenzar a realizar contribuciones significativas. Estos son algunos de los próximos pasos que le ayudarán a continuar su viaje hacia el Open Source: + +1. **Identifica tus intereses y objetivos**: antes de comenzar a contribuir en proyectos Open Source, tómate un tiempo para pensar en tus intereses, pasiones y objetivos. Esto le ayudará a identificar proyectos que se alineen con sus valores y objetivos. + +2. **Encuentre proyectos en los que contribuir**: utilice plataformas como GitHub, OpenSauced y CodeTriage para descubrir proyectos Open Source que se alineen con sus intereses y habilidades. Busque proyectos con comunidades activas, documentación clara y pautas de contribución bien definidas. + +3. **Empiece a contribuir**: una vez que haya identificado un proyecto en el que contribuir, comience abordando tareas pequeñas y manejables para desarrollar su confianza y ganar experiencia. A medida que se sienta más cómodo, asuma tareas y desafíos más complejos. + +4. **Conéctese con la comunidad Open Source**: únase a foros en línea, plataformas de chat y grupos de redes sociales relacionados con los proyectos que le interesan. Interactúe con otros contribuyentes, haga preguntas y comparta sus conocimientos. + +5. **Asista a eventos y conferencias**: participe en eventos, conferencias y reuniones de Open Source para aprender de otros, establecer contactos con otros desarrolladores y mantenerse actualizado sobre las últimas tendencias y mejores prácticas en el mundo del Open Source. . + +6. **Comparta sus experiencias**: documente su viaje hacia el Open Source escribiendo publicaciones de blog, creando tutoriales o realizando presentaciones. Esto no sólo ayudará a que otros aprendan de sus experiencias, sino que también lo establecerá como un líder intelectual en la comunidad Open Source. + +7. **Continuar aprendiendo**: El Open Source es un campo dinámico y en constante evolución. Manténgase actualizado con las últimas herramientas, técnicas y mejores prácticas asistiendo a talleres, tomando cursos en línea y leyendo artículos y libros sobre desarrollo Open Source. Hemos incluido una [sección de recursos adicionales](recursos-adicionales.md) para obtener más información. + +En conclusión, embarcarse en un viaje hacia el Open Source es una experiencia gratificante y enriquecedora que puede ayudarle a desarrollar nuevas habilidades, conectarse con personas con ideas afines y generar un impacto duradero en los proyectos en los que trabaja. Con el conocimiento y las herramientas que ha adquirido en este curso, estará bien preparado para afrontar los emocionantes desafíos y oportunidades que le esperan en el mundo del Open Source. Así que adelante y comienza a contribuir: ¡la comunidad Open Source espera ansiosamente tu participación! \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/glosario.md b/docs/intro-to-oss/translations/es/glosario.md new file mode 100644 index 00000000..491ec933 --- /dev/null +++ b/docs/intro-to-oss/translations/es/glosario.md @@ -0,0 +1,72 @@ +## Aseguramiento de la calidad + +El aseguramiento de la calidad en proyectos Open Source implica probar, revisar y garantizar que el software cumpla con los estándares deseados. Los miembros de la comunidad a menudo contribuyen a probar e informar problemas para mejorar la calidad del software. + +## Bifurcación + +Una bifurcación es una copia de un repositorio. Cuando bifurcas un repositorio, creas una nueva copia del código base que puedes modificar y experimentar sin afectar el código base original. + +## Bug + +Un bug se refiere a un error, falla o defecto en el código que afecta negativamente el funcionamiento adecuado del software. Los proyectos Open Source a menudo dependen de las contribuciones de la comunidad para identificar y rectificar estos errores. + +## Clonar + +La clonación es el proceso utilizado para copiar un repositorio Git existente en un nuevo directorio local. El comando `git clone` creará un nuevo directorio local para el repositorio, copiará todo el contenido del repositorio especificado, creará las ramas remotas rastreadas y verificará una rama inicial localmente. De forma predeterminada, Git clone creará una referencia al repositorio remoto llamado origen. + +## Colaborador + +Un colaborador es cualquier persona que realiza cambios, adiciones o sugerencias a un proyecto Open Source. Los contribuyentes pueden ser desarrolladores, diseñadores, escritores, evaluadores o cualquier otra persona que ayude a mejorar el proyecto. + +## Docs + +Esta es una abreviatura de la palabra documentación. Su uso principal es explicar cómo implementar y utilizar el producto. La documentación también proporciona a las personas información sobre cómo contribuir a proyectos de OSS y las expectativas de los contribuyentes. Markdown, un lenguaje de codificación basado en texto, se utiliza a menudo para crear estas formas de contenido. ¿Quieres ver uno en acción? ¡Consulta la [Guía de estilo en nuestro repositorio de Pizza Verse](https://github.com/open-sauced/pizza-verse/blob/main/style-guide.md)! + +## Incorporación + +La documentación de incorporación ayuda a los nuevos miembros o colaboradores del equipo a familiarizarse rápidamente con la estructura, los objetivos y los procesos de un proyecto. + +## Fusionar + +La fusión es el proceso de combinar cambios de una rama en otra. Cuando se acepta y fusiona una solicitud de extracción, los cambios realizados en la solicitud de extracción pasan a formar parte del código base principal. + +## Guía de estilo + +Una guía de estilo es un conjunto de reglas y convenciones que definen el formato preferido, el estilo de escritura y los elementos visuales utilizados en la documentación y otro contenido. Esto ayuda a mantener la coherencia y la claridad en todos los documentos, haciéndolos más fáciles de leer y comprender. + + +## Mantenedor + +Un mantenedor es una persona o un grupo de personas responsables de mantener un proyecto Open Source específico. Los mantenedores suelen ser responsables de revisar y aceptar o rechazar las contribuciones de otros contribuyentes. También tienen la autoridad para tomar decisiones finales sobre la dirección y el alcance del proyecto. + +## Markdown + +Markdown es un lenguaje de marcado ligero que se utiliza habitualmente para crear documentos de texto formateados. Es ampliamente utilizado para crear documentación y archivos README en el desarrollo de software debido a su simplicidad y legibilidad. + +## Miembro principal + +Un miembro principal es un colaborador al que se le han otorgado privilegios o responsabilidades adicionales dentro de un proyecto Open Source. Los miembros principales suelen ser colaboradores confiables que han demostrado un profundo conocimiento del proyecto y han realizado contribuciones significativas a su desarrollo. + +## Notas de la versión + +Las notas de la versión son documentos que detallan cambios, mejoras, correcciones de errores y nuevas funciones en cada versión del software. Informan a los usuarios y a las partes interesadas sobre qué esperar de una nueva versión del software. + +## Problema + +Un problema es un problema o error que debe abordarse en el código. Cualquiera puede crear problemas y, a menudo, se utilizan para realizar un seguimiento de errores, solicitudes de funciones y otras tareas que deben realizarse. + +## Proyectos OSS + +Proyectos OSS significa proyectos de " Open Source Software". Se trata de proyectos de software en los que el código fuente se pone a disposición del público, lo que permite a cualquiera ver, utilizar y modificar el software. + +## Rama + +Una rama es una versión independiente del código que se crea con fines de desarrollo. Las ramas permiten a los contribuyentes experimentar con cambios sin afectar el código base principal. Cuando los cambios están listos para fusionarse en el código base principal, normalmente se envían como una solicitud de extracción. + +## Repositorio + +Un repositorio es una ubicación central donde se almacena y administra el código. En el Open Source, los repositorios suelen estar alojados en plataformas como GitHub, GitLab o Bitbucket. Cada repositorio puede contener uno o más proyectos y los contribuyentes pueden enviar cambios al código mediante solicitudes de extracción. + +## Solicitud de extracción + +Una solicitud de extracción es una solicitud de un colaborador a un mantenedor para que los cambios realizados en el código se introduzcan en una base de código. \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/herramientas-para-tener-exito.md b/docs/intro-to-oss/translations/es/herramientas-para-tener-exito.md new file mode 100644 index 00000000..a9372001 --- /dev/null +++ b/docs/intro-to-oss/translations/es/herramientas-para-tener-exito.md @@ -0,0 +1,124 @@ +# Herramientas para tener éxito + +Para tener éxito en su viaje hacia el Open Source, es esencial familiarizarse con las herramientas y plataformas comúnmente utilizadas por la comunidad. Estas herramientas lo ayudarán a colaborar de manera efectiva, administrar sus proyectos y contribuir a proyectos Open Source. En este capítulo, analizaremos las siguientes herramientas esenciales para la colaboración en Open Source: + +- GitHub y Git +- VS Code (El editor) +- Discord + +## Requisitos previos +Antes de completar el siguiente tutorial, complete lo siguiente: +- Cree una [cuenta de GitHub](https://github.com/) +- Descargar [VS Code](https://code.visualstudio.com/) + +## GitHub y Git + +### Introducción a Git + +Git es un sistema de control de versiones distribuido diseñado para manejar todo, desde proyectos pequeños hasta proyectos muy grandes con velocidad y eficiencia. Fue creado por Linus Torvalds, el creador del kernel de Linux, para gestionar el desarrollo del propio kernel de Linux. + +Git permite a los desarrolladores realizar un seguimiento de los cambios en su código, colaborar con otros desarrolladores y gestionar múltiples versiones de sus proyectos. Algunas de las características clave de Git incluyen: + +- **Ramificar**: Git permite a los desarrolladores crear ramas, que son copias separadas de su código base. Esto les permite trabajar en nuevas funciones o correcciones de errores sin afectar el código base principal. Una vez que se completen los cambios, pueden fusionar la rama nuevamente con el código base principal. +- **Área de preparación**: Git proporciona un área de preparación donde los desarrolladores pueden preparar sus cambios antes de enviarlos al repositorio. Esto les permite revisar y organizar sus cambios antes de hacerlos permanentes. +- **Control de versiones distribuido**: a diferencia de los sistemas de control de versiones centralizados, Git es un sistema de control de versiones distribuido. Esto significa que cada desarrollador tiene una copia completa del repositorio en su máquina local, lo que les permite trabajar sin conexión e independientemente de un servidor central. + +### Introducción a GitHub + +GitHub es una plataforma basada en web para control de versiones y colaboración que utiliza Git como tecnología subyacente. Proporciona una interfaz sencilla y fácil de usar para gestionar repositorios Git, así como una serie de funciones y herramientas para colaborar con otros desarrolladores. + +Algunas de las características clave de GitHub incluyen: + +- **Seguimiento de problemas**: GitHub proporciona un sistema de seguimiento de problemas integrado que permite a los desarrolladores crear, asignar y gestionar problemas relacionados con sus proyectos. Los problemas se pueden clasificar mediante etiquetas, hitos y personas asignadas, lo que facilita realizar un seguimiento del progreso del proyecto y priorizar las tareas. +- **Solicitudes de extracción**: GitHub introduce el concepto de solicitudes de extracción, que permiten a los desarrolladores proponer cambios en el código base de un proyecto. Las solicitudes de extracción permiten la revisión, discusión y colaboración del código antes de que los cambios se fusionen en la base de código principal. +- **Bifurcación**: GitHub permite a los usuarios crear una copia de un repositorio, conocida como bifurcación. Esto les permite realizar cambios en el código base sin afectar el proyecto original. Una vez que se completen los cambios, pueden enviar una solicitud de extracción para que sus cambios se revisen y potencialmente se fusionen en el código base principal. +- **GitHub Actions**: GitHub Actions es una potente herramienta de automatización que te permite crear flujos de trabajo personalizados para automatizar tareas como crear, probar e implementar tu código. + +### Primeros pasos con Git y GitHub + +Para comenzar con Git y GitHub, siga estos pasos: + +1. **Instala Git**: descarga e instala Git en tu computadora visitando el [sitio web oficial de Git](https://git-scm.com/) y siguiendo las instrucciones de instalación para tu sistema operativo. + +2. **Configurar Git**: Después de instalar Git, abra una terminal o símbolo del sistema y configure su información de usuario de Git ejecutando los siguientes comandos: + +``` +git config --global user.name "Tu nombre" +git config --global user.email "Tu.correo electrónico@ejemplo.com" +``` + +Reemplace `Tu nombre` con su nombre completo y `Tu.correo electrónico@ejemplo.com` con la dirección de correo electrónico que utilizó para registrarse en GitHub. + +#### Practicando la contribución con VS Code +Para practicar el uso de GitHub, veremos cómo crear un repositorio, clonarlo, realizar cambios y empujar esos cambios. + +1. **Cree un nuevo repositorio**: Inicie sesión en su cuenta de GitHub y haga clic en el botón verde "Nuevo" en la barra lateral. Alternativamente, haga clic en el icono "+" en la esquina superior derecha y seleccione "Nuevo repositorio" en el menú desplegable. + +Elija usted mismo como propietario del repositorio e ingrese un nombre para su repositorio. Para este ejemplo, usaremos `practice-repository`. + +![nueva captura de pantalla del repositorio](../../../_assets/images/new-repo.png) + +Elige si quieres que sea público o privado. También puede optar por inicializar el repositorio con un archivo README, un archivo `.gitignore` y/o una licencia. + +Para este ejemplo, inicialice el repositorio con un archivo README. + +2. **Clonar el repositorio**: una vez que haya creado un nuevo repositorio, puede clonarlo en su máquina local ejecutando el siguiente comando en su terminal o símbolo del sistema: + +``` +git clone https://github.com/nombre-de-usuario/nombre-repositorio.git +``` + +Reemplace "nombre-de-usuario" con su nombre de usuario de GitHub y "nombre-repositorio" con `practice-repository`. + +3. **Acceda a su repositorio en su editor de código**: para este ejemplo, estamos usando VS Code. Abra VS Code, navegue hasta la pestaña del archivo y luego abra su `practice-repository`. + +4. **Realizar cambios y confirmar**: Debería haber un archivo en su repositorio: `README.md`. Dentro de ese archivo, debajo de `#practice-repository`, escribe '¡hola mundo!' Una vez que haya realizado cambios, puede prepararlos y confirmarlos. + +Abra su terminal y asegúrese de estar en el directorio correcto. Por ejemplo, mis proyectos de codificación están dentro de mi carpeta `proyectos`. Usando mi terminal, accedería a este repositorio ejecutando este comando: + +``` +cd proyectos/practice-repository +``` + +Una vez que esté en el repositorio correcto, use los siguientes comandos para agregar los cambios que realizó y escriba un mensaje de confirmación con una descripción de los cambios: + +``` +git add . +git commit -m "Tu mensaje de confirmación" +``` + +Reemplace "Tu mensaje de confirmación" con una breve descripción de los cambios que realizó. + +5. **Empuje sus cambios**: después de confirmar sus cambios, puede enviarlos a su repositorio remoto de GitHub ejecutando el siguiente comando: + +``` +git push origin main +``` + +Esto enviará sus cambios a la rama `principal` de su repositorio remoto. Si desea comprobar su trabajo, navegue hasta su repositorio de GitHub. Ahora deberías ver '¡hola mundo!' en su archivo README.md. + +¡Ahora ha configurado con éxito Git y GitHub en su máquina local y está listo para colaborar en proyectos Open Source! + +## VS Code + +Visual Studio Code (VS Code) es un editor de código popular, gratuito y Open Source desarrollado por Microsoft. Admite una amplia gama de lenguajes de programación y ofrece muchas características que lo convierten en una excelente opción para el desarrollo Open Source, que incluyen: + +- **Soporte Git integrado**: VS Code proporciona soporte integrado para Git, lo que le permite administrar sus repositorios Git, preparar y confirmar cambios y resolver conflictos de fusión directamente desde el editor. +- **Extensibilidad**: VS Code ofrece un rico ecosistema de extensiones que pueden mejorar su experiencia de desarrollo y agregar soporte para lenguajes, herramientas y marcos adicionales. +- **Terminal integrada**: VS Code incluye una terminal integrada que le permite ejecutar comandos, scripts y crear tareas directamente desde el editor. +- **Personalizable**: VS Code es altamente personalizable, lo que le permite adaptar el editor a sus preferencias y flujo de trabajo. Puede personalizar el tema, las combinaciones de teclas y la configuración para crear un entorno de desarrollo personalizado. + +Para descargar e instalar VS Code, visite el [sitio web oficial](https://code.visualstudio.com/) y siga las instrucciones de su sistema operativo. + +## Discord + +Discord es una popular plataforma de mensajería y chat de voz ampliamente utilizada por comunidades Open Source para comunicación y colaboración. Al unirte a servidores de Discord relacionados con tus intereses y proyectos, podrás: + +- **Conéctate con otros desarrolladores**: Discord te permite chatear con otros desarrolladores, hacer preguntas y compartir tus conocimientos con la comunidad. +- **Manténgase actualizado**: muchos proyectos Open Source utilizan Discord para compartir actualizaciones, anuncios y otra información importante. Al unirte a sus servidores, podrás mantenerte informado sobre los últimos desarrollos y contribuir de manera más efectiva. +- **Participe en debates**: los servidores de Discord suelen albergar debates sobre diversos temas relacionados con el desarrollo Open Source. Al participar en estas discusiones, puede aprender de otros, compartir sus ideas y contribuir al conocimiento colectivo de la comunidad. +- **Encuentra oportunidades de colaboración**: los servidores de Discord pueden ser un excelente lugar para encontrar otras personas que comparten tus intereses y buscan oportunidades de colaboración. Al establecer contactos con otros desarrolladores, puede descubrir nuevos proyectos en los que trabajar y formar asociaciones valiosas. + +Para comenzar con Discord, visite el [sitio web oficial](https://discord.com/) y regístrese para obtener una cuenta. Una vez que tenga una cuenta, puede buscar comunidades y proyectos Open Source en plataformas como GitHub, GitLab u OpenSauced para encontrar sus servidores Discord y unirse a la conversación. + +Al familiarizarse con estas herramientas y plataformas, estará equipado para colaborar de manera efectiva, administrar sus proyectos y contribuir a proyectos Open Source. En el [próximo capítulo](como-contribuir-al-open-source.md), analizaremos cómo contribuir a proyectos Open Source, incluida la búsqueda de proyectos en los que trabajar, el envío de contribuciones y lo que sucede después de que se acepta su contribución. \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/introduccion.md b/docs/intro-to-oss/translations/es/introduccion.md new file mode 100644 index 00000000..2ab36765 --- /dev/null +++ b/docs/intro-to-oss/translations/es/introduccion.md @@ -0,0 +1,55 @@ +# Introducción + +¡Bienvenido al curso "Introducción al Open Source"! Este curso integral lo guiará a través del fascinante mundo del Open Source y lo ayudará a convertirse en un colaborador activo. Al final de este curso, debería tener una comprensión sólida de cómo encontrar, unirse y contribuir a proyectos Open Source, así como también cómo desarrollar su currículum de Open Source. Pero primero, preparemos el escenario analizando los requisitos previos, los objetivos y las expectativas de este curso. + +## Requisitos previos + +Antes de sumergirse en el mundo del Open Source, es fundamental tener un conocimiento básico de los conceptos de programación y algo de experiencia trabajando con código. Si bien el curso proporcionará ejemplos y demostraciones, aprovechará al máximo el material si tiene algún conocimiento previo. + +Además, este curso supone que está familiarizado con Git y GitHub. Git es un sistema de control de versiones ampliamente utilizado y GitHub es una plataforma popular para alojar y colaborar en repositorios de Git. Si aún no está familiarizado con Git y GitHub, le recomendamos que se tome un tiempo para aprender los conceptos básicos antes de comenzar este curso. + +## Objetivos + +A lo largo de este curso, nuestros objetivos principales son ayudarlo a: + +1. **Comprender el Open Source y sus beneficios**: exploraremos el concepto de Open Source, su historia y las numerosas ventajas de contribuir a proyectos Open Source. +2. **Aprenda a encontrar proyectos Open Source**: Descubrir proyectos que se alineen con sus intereses y habilidades es crucial para una experiencia gratificante de Open Source. Le presentaremos herramientas y técnicas para encontrar proyectos en los que contribuir. +3. **Domine las herramientas y los procesos para contribuir**: brindaremos una descripción general de las herramientas y procesos esenciales necesarios para una colaboración exitosa de Open Source, como control de versiones, revisión de código y plataformas de comunicación. +4. **Obtenga experiencia práctica**: al seguir ejemplos y demostraciones, tendrá la oportunidad de practicar sus habilidades y ganar confianza en su capacidad para contribuir a proyectos Open Source. +5. **Desarrolla tu currículum de Open Source**: mostrar tus contribuciones Open Source es vital para construir tu reputación en la comunidad y demostrar tu experiencia a posibles empleadores o clientes. Discutiremos estrategias para desarrollar y mantener su currículum de Open Source. + +## Expectativas + +Este curso está diseñado para brindarle una base sólida en la colaboración Open Source. Si bien cubriremos una variedad de temas y brindaremos ejemplos, demostraciones y oportunidades para la práctica, es esencial tener expectativas realistas sobre lo que puede lograr durante el curso. + +1. **La práctica es crucial**: aprender sobre el Open Source es sólo el comienzo; Para desarrollar verdaderamente sus habilidades y convertirse en un colaborador competente, deberá practicar de manera constante. Tenga en cuenta que cuanto más contribuya a proyectos Open Source, más aprenderá y crecerá como desarrollador. + +2. **La paciencia es clave**: dominar la colaboración en Open Source requiere tiempo y esfuerzo. No se desanime si encuentra desafíos en el camino; Recuerda que cada aportación, por pequeña que sea, es valiosa y ayuda a mejorar el proyecto. + +3. **Compromiso con la comunidad**: El Open Source es más que sólo código; se trata de las personas que colaboran y contribuyen a los proyectos. Interactúe con la comunidad haciendo preguntas, compartiendo sus conocimientos y apoyando a otros. Establecer relaciones con otros contribuyentes mejorará su experiencia en Open Source y lo ayudará a crecer como desarrollador. + +4. **Aprendizaje continuo**: el Open Source es un campo que evoluciona rápidamente, con nuevos proyectos, herramientas y tecnologías que surgen todo el tiempo. Mantenga la curiosidad y la apertura al aprendizaje, y aproveche recursos como documentación, tutoriales y foros comunitarios para ampliar sus conocimientos y mantenerse actualizado con los últimos desarrollos. + +5. **Desarrollar una mentalidad de crecimiento**: acepte los desafíos y oportunidades que conlleva la colaboración en Open Source. Adopte una mentalidad de crecimiento, que se centre en el aprendizaje, la mejora y la resiliencia. Al considerar los obstáculos como oportunidades de crecimiento, estará mejor equipado para navegar por el complejo mundo del Open Source y lograr el éxito en sus contribuciones. + +## Estructura del curso + +Este curso está dividido en varios capítulos, cada uno diseñado para cubrir un aspecto específico de la colaboración en Open Source: + +- **[¿Qué es Open Source?](que-es-open-source.md):** En este capítulo, exploraremos la definición de Open Source y su historia, brindándole una base sólida para comprender el contexto de la colaboración en Open Source. +- **[¿Por qué Open Source?](por-que-open-source.md):** Profundizaremos en los beneficios del Open Source, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. +- **[Herramientas para tener éxito](herramientas-para-tener-exito.md):** Este capítulo le presentará las herramientas esenciales para una colaboración exitosa en Open Source, incluidos GitHub, Git, VS Code y Discord. +- **[Cómo contribuir al Open Source](como-contribuir-al-open-source.md):** En este capítulo, analizaremos el proceso de encontrar proyectos en los que trabajar, enviar contribuciones, incorporarse a un nuevo proyecto y qué esperar después de enviar su contribución. +- **[La salsa secreta](la-salsa-secreta.md):** Este capítulo revelará las estrategias y técnicas para comenzar, ganar terreno en sus contribuciones y desarrollar su currículum de Open Source. +- **[Tipos de contribuciones](tipos-de-contribuciones.md):** Este capítulo discutirá los tipos de contribuciones en Open Source. +- **[Conclusión](conclusion.md):** Concluiremos el curso con conclusiones clave y discutiremos los próximos pasos en su viaje hacia el Open Source. + +A lo largo de este curso, proporcionaremos ejemplos y demostraciones para ayudar a ilustrar conceptos clave y brindar oportunidades prácticas para la práctica. Cuando sea posible, presentaremos proyectos y herramientas Open Source del mundo real, como [OpenSauced](https://opensauced.pizza/), para demostrar cómo aplicar las habilidades que ha aprendido. + +Tenga en cuenta que, si bien estos ejemplos y demostraciones están diseñados para brindar orientación e inspiración, su propio viaje hacia el Open Source puede diferir según sus intereses, habilidades y proyectos elegidos. + +Utilice los ejemplos y demostraciones como punto de partida, pero no tema explorar otros proyectos, herramientas y recursos a medida que continúa aprendiendo y creciendo. + +## Comencemos 🚀 + +Ahora que hemos preparado el escenario, ¡es hora de embarcarse en su viaje hacia el Open Source! En el [próximo capítulo](que-es-open-source.md), profundizaremos en la definición de Open Source y exploraremos su historia, sentando las bases para una comprensión más profunda de la colaboración en Open Source. ¡Empecemos! \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/la-salsa-secreta.md b/docs/intro-to-oss/translations/es/la-salsa-secreta.md new file mode 100644 index 00000000..e2cbf1da --- /dev/null +++ b/docs/intro-to-oss/translations/es/la-salsa-secreta.md @@ -0,0 +1,79 @@ +# La Salsa Secreta + +En este capítulo, compartiremos algunas estrategias y consejos menos conocidos para lograr un impacto duradero en la comunidad Open Source. Discutiremos cómo centrarse en problemas abiertos, obtener tracción en sus contribuciones y desarrollar su currículum de Open Source utilizando OpenSauced. + +## Problemas abiertos: más que solicitudes de extracción que solucionan errores tipográficos + +Si bien corregir errores tipográficos y mejorar la documentación son contribuciones valiosas a los proyectos Open Source, es esencial mirar más allá de estas frutas al alcance de la mano y centrarse en abordar los problemas abiertos. Abordar los problemas abiertos no solo ayuda a que el proyecto avance, sino que también le permite desarrollar una comprensión más profunda del código base y demostrar sus habilidades para resolver problemas. + +A continuación se ofrecen algunos consejos para encontrar y abordar problemas abiertos: + +1. **Examine el rastreador de problemas**: la mayoría de los proyectos Open Source utilizan un rastreador de problemas para administrar errores, solicitudes de funciones y otras tareas. Explore el rastreador de problemas para encontrar problemas que se ajusten a sus intereses y habilidades. + +2. **Busque problemas aptos para principiantes**: muchos proyectos utilizan etiquetas como "buen primer problema" o "se necesita ayuda" para indicar problemas que son adecuados para principiantes. Comience con estos temas para desarrollar su confianza y ganar experiencia antes de abordar tareas más complejas. + +3. **Comprenda el problema**: antes de profundizar en un problema, asegúrese de comprender el problema y el resultado deseado. Si no está seguro de algo, haga preguntas o solicite aclaraciones a los mantenedores del proyecto u otros contribuyentes. + +4. **Comunique sus intenciones**: antes de comenzar a trabajar en un problema, informe a los encargados del proyecto y a otros contribuyentes que está interesado en abordarlo. Esto puede ayudar a evitar esfuerzos duplicados y garantizar que todos estén en sintonía. + +5. **Pruebe sus cambios**: una vez que haya solucionado un problema, pruebe los cambios minuciosamente para asegurarse de que funcionen como se esperaba y no introduzcan nuevos problemas. + +Al centrarse en problemas abiertos en lugar de simplemente corregir errores tipográficos, tendrá un impacto más significativo en los proyectos en los que contribuye y demostrará su compromiso con la comunidad Open Source. + +## Obteniendo tracción en las contribuciones + +A medida que adquiera más experiencia en contribuciones Open Source, es posible que desee aumentar su impacto en los proyectos en los que trabaja y obtener reconocimiento por sus esfuerzos. A continuación se presentan algunas estrategias para ganar tracción en sus contribuciones: + +1. **Conviértete en un colaborador habitual**: Contribuye constantemente a los mismos proyectos a lo largo del tiempo. Esto le ayudará a desarrollar una comprensión más profunda del código base, establecer relaciones con otros contribuyentes y establecerse como un miembro valioso de la comunidad. + +2. **Acepta tareas desafiantes**: a medida que adquieras experiencia, aborda problemas y funciones más complejos. Esto no solo lo ayudará a crecer como desarrollador, sino que también demostrará su capacidad para manejar tareas desafiantes y contribuir de manera significativa al proyecto. + +3. **Colaborar con otros**: el Open Source tiene que ver con la colaboración. Trabaje con otros contribuyentes para abordar problemas, desarrollar funciones y compartir conocimientos. Al colaborar de manera efectiva, no solo mejorará el proyecto sino que también construirá una sólida red de conexiones en la comunidad Open Source. + +4. **Comparta su experiencia**: comparta sus conocimientos y opiniones escribiendo publicaciones de blog, creando tutoriales o haciendo presentaciones sobre los proyectos en los que trabaja. Esto no sólo ayudará a que otros aprendan de sus experiencias, sino que también lo establecerá como un líder intelectual en la comunidad Open Source. + +5. **Orientar a nuevos contribuyentes**: a medida que adquiera más experiencia en contribuciones Open Source, considere asesorar a nuevos contribuyentes que recién estén comenzando su recorrido por el Open Source. Esto puede ayudarle a contribuir a la comunidad, desarrollar sus habilidades de liderazgo y construir una reputación positiva. + +## Construyendo su currículum de Open Source + +Crear un currículum sólido de Open Source puede ayudarlo a mostrar sus habilidades, experiencia y contribuciones a posibles empleadores, colaboradores y la comunidad de desarrolladores en general. OpenSauced es una excelente herramienta para realizar un seguimiento de sus contribuciones en Open Source y desarrollar su currículum de Open Source. Veamos cómo puede utilizar OpenSauced para respaldar su viaje hacia el Open Source. + +1. **Regístrese para obtener una cuenta de OpenSauced**: si aún no ha creado una cuenta, visite [opensauced.pizza](https://opensauced.pizza/) y regístrese para obtener una cuenta utilizando sus credenciales de GitHub. + +2. **Visite su página de perfil público**: después de registrarse, se creará una página de perfil público para usted. Esta página mostrará la información de su perfil de GitHub y una lista de sus contribuciones en Open Source. Puede navegar hasta él haciendo clic en su nombre de usuario en la esquina superior derecha de la página. + +![Navegando a su página de perfil público en OpenSauced](../../../_assets/images/opensauced-profile.png) + +3. **Cree su currículum de Open Source**: desde aquí, podrá agregar aspectos destacados a las solicitudes de extracción y los problemas en los que haya contribuido. También puede agregar una descripción y enlaces a su currículum de Open Source. Estos se agregarán en una sola página que podrá compartir con otros, así como un resumen de sus contribuciones que se mostrará en su página de perfil público. + +¡Muestremos nuestra contribución al libro de visitas del capítulo anterior! En su perfil, verá una sección "Destacados" con entrada de texto. Al hacer clic aquí, podrá agregar un título, algunas ideas y un enlace a su PR. Esto se mostrará en su página de perfil público. Agreguemos un punto destacado a nuestra contribución al libro de visitas. + +### Resalte eficazmente sus contribuciones + +Información importante que debe incluir cuando destaque sus contribuciones: + +- Nuevo material que has creado, +- Detalles del proyecto (herramientas, bibliotecas, tamaño y complejidad), +- El tipo de contribuciones: corrección de errores, características, rendimiento, documentación, etc. +- Los detalles de su contribución, incluidas las mejoras y los impactos realizados en el proyecto y en la comunidad, +- Detalles de colaboración y trabajo en equipo. + +### Formatear tu destacado + +Para ser más eficaz a la hora de destacar sus contribuciones, le recomendamos utilizar el siguiente formato: + +- **Descripción**: Al resaltar tu contribución, recomendamos mencionar el impacto que tuvo en el proyecto general. Esto sería útil para resaltar sus calificaciones para puestos laborales, especialmente si tiene brechas laborales. Considere utilizar el siguiente modelo para ayudarle a convertir este momento destacado en una historia: + - Verbo de éxito + sustantivo + métrica + resultado. + - Ejemplo: Mientras revisaba algunas solicitudes de extracción para GirlScript Summer of Code de este año, noté que la mayoría de ellas no se fusionarían a pesar de que el propietario y yo dimos nuestras aprobaciones. Entonces, **creé una GitHub Action donde las solicitudes de extracción se fusionan automáticamente una vez que han pasado los pasos de implementación (verbo + sustantivo sucesivos)**, lo que **aumentó las tasas de productividad en un 80 % (métrica + resultado).** +- **Agregar un repositorio**: Proporcione el nombre completo del repositorio al que está realizando contribuciones. +- **URL**: pegue la URL en su solicitud de extracción, problema o publicación de blog. + +![Agregar un punto destacado a un perfil en OpenSauced](../../../_assets/images/opensauced-highlights.png) + +**¡Compártelo!**: Una vez que hayas creado un currículum de contribuciones en Open Source, puedes compartir tu currículum de OpenSauced con otras personas haciendo clic en el botón compartir en el encabezado de tu página de perfil. Esto puede resultar especialmente útil al solicitar empleo, establecer contactos con otros desarrolladores o promocionar su trabajo en la comunidad Open Source. + +Al aprovechar OpenSauced para realizar un seguimiento de sus contribuciones en Open Source y desarrollar su currículum, estará mejor equipado para mostrar sus habilidades, experiencia e impacto en la comunidad Open Source. Además, puede consultar la [Guía para solicitantes de empleo](https://docs.opensauced.pizza/opensauced-guides/job-seekers-guide/job-seekers-guide-introduction/) en nuestros documentos para aprender a utilizar OpenSauced para conseguir un trabajo en la industria tecnológica. + +En conclusión, comenzar con contribuciones al Open Source y lograr un impacto duradero en los proyectos en los que trabaja requiere una combinación de habilidades técnicas, colaboración y perseverancia. Al centrarse en temas abiertos, ganar impulso en sus contribuciones y aprovechar herramientas como OpenSauced, estará bien encaminado hacia un viaje exitoso y satisfactorio hacia el Open Source. + +En el [próximo capítulo](tipos-de-contribuciones.md), analizaremos varios tipos de contribuciones en Open Source diff --git a/docs/intro-to-oss/translations/es/por-que-open-source.md b/docs/intro-to-oss/translations/es/por-que-open-source.md new file mode 100644 index 00000000..fc8844ef --- /dev/null +++ b/docs/intro-to-oss/translations/es/por-que-open-source.md @@ -0,0 +1,55 @@ +# ¿Por qué Open Source? + +En el capítulo anterior, exploramos el concepto de Open Source y su historia. Ahora, profundicemos en los beneficios de contribuir a proyectos Open Source. Al comprender las ventajas de la colaboración en Open Source, estará mejor equipado para aprovechar las oportunidades que presenta y aprovechar al máximo su viaje por el Open Source. + +## Acceso al conocimiento + +Uno de los beneficios clave de contribuir a proyectos Open Source es la oportunidad de acceder a una gran cantidad de conocimientos y recursos. Como colaborador de Open Source, podrás: + +1. **Aprende de proyectos del mundo real**: los proyectos Open Source brindan una oportunidad única para estudiar y aprender de bases de código del mundo real. Al examinar cómo otros desarrolladores han abordado problemas complejos, podrá obtener información sobre las mejores prácticas, patrones de diseño y técnicas de vanguardia que puede aplicar a sus propios proyectos. + +2. **Acceda a diversas perspectivas**: los proyectos Open Source atraen a colaboradores de todo el mundo, cada uno de los cuales aporta su propio conjunto único de habilidades, experiencias y perspectivas. Al colaborar con otros, puede ampliar su comprensión de diferentes tecnologías, lenguajes de programación y metodologías de desarrollo. + +3. **Manténgase actualizado con las últimas tendencias**: la comunidad Open Source suele estar a la vanguardia de la innovación, con nuevos proyectos, herramientas y tecnologías que surgen constantemente. Al participar en proyectos Open Source, puede mantenerse actualizado con los últimos desarrollos en su campo y conocer las tendencias emergentes y las mejores prácticas. + +4. **Acceda a recursos de alta calidad**: la comunidad Open Source es conocida por su compromiso de producir documentación, tutoriales y otros recursos educativos de alta calidad. Al aprovechar esta riqueza de conocimientos, podrá profundizar su comprensión de diversas tecnologías y conceptos y seguir creciendo como desarrollador. + +## Acceso a la comunidad + +La comunidad Open Source es una red global y diversa de desarrolladores, entusiastas y defensores que comparten una pasión común por la colaboración y el intercambio de conocimientos. Al contribuir a proyectos Open Source, puedes: + +1. **Conéctese con personas con ideas afines**: los proyectos Open Source brindan la oportunidad de colaborar con otras personas que comparten sus intereses y pasiones. Al trabajar juntos, pueden formar conexiones y amistades duraderas que pueden enriquecer su vida personal y profesional. + +2. **Amplíe su red**: la comunidad Open Source es amplia y está interconectada, con innumerables proyectos, eventos y foros donde los desarrolladores se reúnen para colaborar y compartir conocimientos. Al participar en estas actividades, puede ampliar su red profesional y conectarse con posibles mentores, colaboradores e incluso empleadores. + +3. **Desarrollar habilidades de comunicación y colaboración**: trabajar en proyectos Open Source a menudo implica colaborar con otros, ya sea de forma remota o en persona. Esto puede ayudarlo a desarrollar habilidades esenciales de comunicación y colaboración, como brindar comentarios constructivos, resolver conflictos y trabajar de manera efectiva en equipo. + +4. **Retribuir a la comunidad**: Contribuir a proyectos Open Source es una forma de retribuir a la comunidad que le ha proporcionado conocimientos y recursos valiosos. Al compartir sus habilidades y experiencia, puede ayudar a respaldar el crecimiento continuo y el éxito del movimiento Open Source. + +## Acceso a habilidades + +Contribuir a proyectos Open Source puede ayudarle a desarrollar una amplia gama de habilidades técnicas y no técnicas que son muy valoradas en el mercado laboral. Como colaborador de Open Source, tendrás la oportunidad de: + +1. **Mejore sus habilidades de programación**: trabajar en proyectos del mundo real es una excelente manera de mejorar sus habilidades de programación y profundizar su comprensión de diversas tecnologías y lenguajes. Al abordar problemas desafiantes y aprender de otros contribuyentes, puede perfeccionar sus habilidades y convertirse en un desarrollador más competente. + +2. **Adquiera experiencia con nuevas tecnologías**: Los proyectos Open Source a menudo implican tecnologías y herramientas de vanguardia que es posible que no se utilicen en su trabajo o estudios diarios. Al contribuir a estos proyectos, puede adquirir experiencia práctica con nuevas tecnologías y ampliar sus habilidades. + +3. **Cree su portafolio**: Contribuir a proyectos Open Source le permite crear un registro público de su trabajo, mostrando sus habilidades y experiencia a posibles empleadores. Un sólido portafolio de contribuciones al Open Source puede ayudarlo a destacarse en el mercado laboral y demostrar su compromiso con el aprendizaje continuo y el crecimiento profesional. + +4. **Desarrollar habilidades de resolución de problemas y pensamiento crítico**: trabajar en proyectos Open Source a menudo implica abordar problemas complejos y tomar decisiones importantes. Al afrontar estos desafíos, puede desarrollar valiosas habilidades de pensamiento crítico y resolución de problemas que pueden aplicarse a diversos aspectos de su vida y carrera. + +5. **Aprenda a gestionar y organizar proyectos**: Contribuir a proyectos Open Source puede exponerlo a diversos aspectos de la gestión y organización de proyectos, como establecer prioridades, gestionar plazos y coordinar con los miembros del equipo. Estas habilidades pueden ser invaluables tanto en su vida personal como profesional, ayudándolo a convertirse en una persona más eficaz y organizada. + +6. **Desarrollar habilidades de liderazgo y tutoría**: a medida que adquiera experiencia en la comunidad Open Source, es posible que se encuentre en condiciones de asesorar y guiar a nuevos contribuyentes. Al asumir estos roles de liderazgo, puede desarrollar habilidades esenciales, como comunicación, empatía y delegación, que pueden ayudarlo a tener éxito en su carrera y vida personal. + +## Beneficios adicionales + +Además de los beneficios mencionados anteriormente, contribuir a proyectos Open Source también puede proporcionar otras ventajas, como por ejemplo: + +1. **Mayores oportunidades laborales**: muchos empleadores valoran la experiencia en Open Source y buscan activamente candidatos que tengan un historial comprobado de contribución a proyectos Open Source. Al mostrar sus contribuciones al Open Source, puede aumentar sus posibilidades de conseguir el trabajo de sus sueños o avanzar en su carrera. + +2. **Realización personal**: Contribuir a proyectos Open Source puede ser una experiencia gratificante y satisfactoria, tanto a nivel personal como profesional. Al compartir sus habilidades y conocimientos, puede marcar una diferencia tangible en el mundo y contribuir a algo más grande que usted mismo. + +3. **Oportunidades de reconocimiento**: los proyectos Open Source a menudo atraen la atención de líderes de la industria, personas influyentes y medios de comunicación. Al realizar contribuciones significativas a proyectos de alto perfil, puede obtener reconocimiento y establecerse como un experto en su campo. + +En el [siguiente capítulo](herramientas-para-tener-exito.md), analizaremos las herramientas y recursos esenciales que necesitará para tener éxito en su viaje hacia el Open Source, incluidos GitHub, Git, VS Code y Discord. Al familiarizarse con estas herramientas, estará mejor equipado para colaborar con otros, administrar sus proyectos y contribuir de manera efectiva a proyectos Open Source. \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/que-es-open-source.md b/docs/intro-to-oss/translations/es/que-es-open-source.md new file mode 100644 index 00000000..6d19d78d --- /dev/null +++ b/docs/intro-to-oss/translations/es/que-es-open-source.md @@ -0,0 +1,67 @@ +# ¿Qué es Open Source? + +En este capítulo, profundizaremos en el concepto de Open Source, su definición y su historia. Obtener una comprensión profunda del Open Source le ayudará a apreciar el contexto en el que colaborará y contribuirá. + +## Definición + +El Open Source se refiere a un tipo de software cuyo código fuente se pone a disposición del público, lo que permite que cualquiera pueda ver, usar, modificar y distribuir el código. Esto contrasta con el software propietario, donde el código fuente se mantiene en secreto y sólo se distribuye el programa compilado. El principio central detrás del Open Source es la idea de colaboración y la creencia de que compartir conocimientos y recursos conduce a un software mejor, más confiable y más innovador. + +El software Open Source se basa en la premisa de que cuando muchas personas trabajan juntas, pueden crear algo mayor que la suma de sus partes. Los contribuyentes a los proyectos Open Source provienen de diversos orígenes y aportan una amplia gama de habilidades, experiencias y perspectivas. Esta diversidad de pensamiento y experiencia conduce a un software más sólido, innovador y confiable. + +### Licencias Open Source + +Para que el software se considere Open Source, debe publicarse bajo una licencia que otorgue a los usuarios el derecho de acceder, modificar y distribuir el código fuente. Existen numerosas licencias Open Source disponibles, cada una con su propio conjunto de términos y condiciones. Algunas licencias Open Source populares incluyen la licencia MIT, la licencia pública general GNU (GPL) y la licencia Apache. + +Estas licencias son cruciales porque garantizan que el software permanezca abierto y accesible para todos. Al otorgar a los usuarios el derecho de ver, modificar y distribuir el código, las licencias Open Source promueven una cultura de colaboración, innovación y conocimiento compartido. + +## Breve historia del Open Source + +La idea de compartir libremente conocimientos y recursos ha existido durante siglos, pero el movimiento Open Source tal como lo conocemos hoy se remonta a los primeros días de la informática. + +### Primeros comienzos + +En las décadas de 1950 y 1960, el software de computadora a menudo iba incluido con el hardware y el código fuente se compartía libremente entre investigadores y desarrolladores. Durante este tiempo, era común que los programadores colaboraran, compartieran ideas y modificaran el código de los demás para mejorar e innovar. + +Sin embargo, en las décadas de 1970 y 1980, cuando la industria del software comenzó a crecer y comercializarse, las empresas comenzaron a ver el software como un activo valioso y comenzaron a restringir el acceso al código fuente. Este cambio marcó el comienzo de la división entre el software propietario y el emergente movimiento Open Source. + +### El nacimiento del software libre + +En respuesta a las crecientes restricciones al acceso y distribución de software, el científico informático Richard Stallman fundó la Free Software Foundation (FSF) en 1985. El objetivo de la FSF era promover el desarrollo y uso de software libre, que definieron como software que otorga a los usuarios la Libertad para ejecutar, estudiar, compartir y modificar el código. Este concepto es similar al de Open Source pero pone un mayor énfasis en los aspectos éticos y políticos de la libertad del software. + +Stallman y la FSF desarrollaron el Proyecto GNU (que significa "GNU's Not Unix"), un esfuerzo ambicioso para crear un sistema operativo completamente libre y abierto. Si bien el Proyecto GNU proporcionó muchos componentes esenciales, le faltaba una pieza crítica: un núcleo libre y abierto, el componente central de un sistema operativo. + +### La llegada de Linux + +En 1991, un estudiante finlandés de informática llamado Linus Torvalds desarrolló un kernel gratuito y Open Source llamado Linux. Cuando se combinó con el sistema GNU, Linux formó un sistema operativo completo, gratuito y Open Source que todavía se utiliza ampliamente en la actualidad. El éxito de Linux ayudó a popularizar el concepto de Open Source y provocó una ola de nuevos proyectos, herramientas y tecnologías. + +### La iniciativa Open Source + +En 1998, Christine Peterson, directora ejecutiva de Foresight, acuñó el término "software Open Source" como un [esfuerzo deliberado para hacer que este campo... sea más comprensible para los recién llegados y para las empresas](https://opensource.com/article/18/2/coining-term-open-source-software). Ella, junto con Eric S. Raymond, Bruce Perens y otros desarrolladores y defensores crearon la Iniciativa Open Source (OSI) para difundir más conciencia sobre este concepto. A partir de ahí, la OSI desarrolló la definición de Open Source, un conjunto de criterios que debe cumplir el software para ser considerado Open Source. Estos criterios incluyen distribución gratuita, disponibilidad del código fuente, trabajos derivados e integridad de la licencia. + +Los esfuerzos de la OSI para promover el Open Source generaron un aumento del interés y la adopción tanto por parte de individuos como de organizaciones. Hoy en día, el software Open Source se utiliza ampliamente en diversas industrias, y muchas empresas de tecnología reconocidas, como Google, IBM y Microsoft, apoyan y contribuyen activamente a proyectos Open Source. + +### El crecimiento de las comunidades Open Source + +A medida que el movimiento Open Source cobró impulso, surgieron numerosas comunidades y plataformas para facilitar la colaboración y el intercambio de conocimientos. Algunos ejemplos notables incluyen: + +- **SourceForge**: Lanzada en 1999, SourceForge fue una de las primeras plataformas basadas en web que proporcionó herramientas y recursos para que los desarrolladores colaboraran en proyectos Open Source. En su apogeo, SourceForge alojó miles de proyectos y atrajo a millones de usuarios. +- **GitHub**: Fundada en 2008, GitHub se convirtió rápidamente en la plataforma de referencia para alojar y colaborar en repositorios de Git. Hoy en día, GitHub alberga millones de proyectos Open Source y cuenta con una vibrante comunidad de contribuyentes de todo el mundo. +- **GitLab**: Lanzado en 2011 como una alternativa Open Source a GitHub, GitLab ofrece un conjunto de herramientas y características para administrar repositorios de Git, rastrear problemas y facilitar la colaboración. + +Estas plataformas han desempeñado un papel crucial a la hora de fomentar el crecimiento de las comunidades Open Source y facilitar que los desarrolladores contribuyan y colaboren en proyectos. + +### El auge de la participación corporativa + +En los últimos años, ha habido un aumento significativo en la participación corporativa en proyectos Open Source. Muchas empresas ahora reconocen el valor del Open Source y contribuyen y apoyan activamente varios proyectos. Algunas empresas incluso han llegado a abrir al Open Source sus propias herramientas y tecnologías internas, como TensorFlow de Google y React de Facebook. + +Esta mayor participación corporativa no solo ha generado más recursos y apoyo para proyectos Open Source, sino que también ha ayudado a legitimar el movimiento Open Source y fomentar una adopción más amplia. + +## La evolución del Open Source + +El movimiento Open Source ha recorrido un largo camino desde sus inicios. Hoy en día, el software Open Source está en todas partes e impulsa todo, desde sitios web y aplicaciones móviles hasta inteligencia artificial y algoritmos de aprendizaje automático. + +A medida que el Open Source continúa evolucionando, constantemente surgen nuevos proyectos, herramientas y tecnologías, que amplían los límites de lo que es posible e impulsan la innovación en una amplia gama de industrias. + +La creciente popularidad del Open Source también ha dado lugar a un próspero ecosistema de conferencias, reuniones y comunidades en línea donde los desarrolladores pueden reunirse para aprender, colaborar y compartir sus conocimientos. Al participar en estos eventos e interactuar con la comunidad Open Source, tendrá la oportunidad de ampliar sus habilidades, construir su red y mantenerse actualizado con los últimos desarrollos en el campo. + +En el [próximo capítulo](por-que-open-source.md), exploraremos los muchos beneficios de contribuir a proyectos Open Source y discutiremos cómo la colaboración en Open Source puede ayudarle a acceder al conocimiento, conectarse con una comunidad y desarrollar habilidades valiosas. \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/recursos-adicionales.md b/docs/intro-to-oss/translations/es/recursos-adicionales.md new file mode 100644 index 00000000..a62a8de9 --- /dev/null +++ b/docs/intro-to-oss/translations/es/recursos-adicionales.md @@ -0,0 +1,25 @@ +# Recursos adicionales + +En esta página, puedes encontrar recursos que te ayudarán a obtener más información sobre cómo contribuir al Open Source: + +## Guías y tutoriales + +- [Guías del Open Source](https://opensource.guide/) de GitHub: guías completas sobre diversos aspectos del Open Source, incluidos cómo empezar, contribuir, mantener proyectos y crear comunidades. + +- [Primeras contribuciones](https://github.com/firstcontributions/first-contributions) de Roshan Jossey: una guía para principiantes que le guiará para realizar su primera contribución a un proyecto Open Source. + +- [Guía para principiantes sobre el desarrollo de software Open Source](https://training.linuxfoundation.org/training/beginners-guide-open-source-software-development/) de The Linux Foundation: un curso en línea gratuito que cubre los conceptos básicos del software Open Source, incluyendo su historia, licencias y modelos de desarrollo. + +- [Red de estudiantes de Open Source (OSSN) de Mozilla](https://community.mozilla.org/en/): proporciona recursos y apoyo para estudiantes interesados ​​en el Open Source, incluidas guías, eventos y oportunidades de tutoría. + +- [Introducción a GitHub y proyectos Open Source](https://www.digitalocean.com/community/tutorial_series/an-introduction-to-open-source) de DigitalOcean: una serie de tutoriales para principiantes que cubre los conceptos básicos del Open Source, incluido cómo encontrar proyectos en los que contribuir, comprender el código base y enviar contribuciones. + +- [Viernes de Open Source](https://opensourcefriday.com/) de GitHub: un movimiento global que anima a individuos y organizaciones a contribuir al Open Source todos los viernes. El sitio web proporciona recursos y guías sobre cómo iniciarse en el Open Source y encontrar proyectos en los que contribuir. + +## Publicaciones de blog + +- [Más allá de la creación de contenido: cómo las contribuciones en Open Source pueden ayudarlo a hacerse notar](https://dev.to/opensauced/beyond-content-creation-how-open-source-contributions-can-help-you-get-noticed-4l5n) +- [Escribir su primera solicitud de extracción: consejos, mejores prácticas y herramientas impulsadas por IA para lograr el éxito](https://dev.to/opensauced/writing-your-first-pull-request-tips-best-practices-and-ai-powered-tools-for-success-3bg9) +- [Cómo contribuir al Open Source sin saber codificar: una guía con sugerencias de proyectos](https://dev.to/opensauced/how-to-contribute-to-open-source-without-knowing-how-to-code-a-guide-with-project-suggestions-59e5) +-[Cómo escribir un buen problema: consejos para una comunicación eficaz en Open Source](https://dev.to/opensauced/how-to-write-a-good-issue-tips-for-effective-communication-in-open-source-5443) +- [Los buenos primeros problemas no existen](https://opensauced.pizza/blog/good-first-issues-dont-exist) \ No newline at end of file diff --git a/docs/intro-to-oss/translations/es/tipos-de-contribuciones.md b/docs/intro-to-oss/translations/es/tipos-de-contribuciones.md new file mode 100644 index 00000000..d886d342 --- /dev/null +++ b/docs/intro-to-oss/translations/es/tipos-de-contribuciones.md @@ -0,0 +1,105 @@ +# Tipos de contribuciones al Open Source + +Las contribuciones a proyectos Open Source pueden adoptar muchas formas, como codificación, documentación, pruebas y más. Es importante señalar que las contribuciones al Open Source no se limitan únicamente a los desarrolladores. Cualquiera puede contribuir a proyectos Open Source, independientemente de sus habilidades técnicas. + +En este capítulo, discutiremos los tipos de contribuciones de codificación y no codificación involucradas en proyectos Open Source. + +## Contribuciones no codificadas + +Las contribuciones sin codificación no implican escribir ni modificar código. Las contribuciones sin codificación son esenciales para la sostenibilidad y el crecimiento de los proyectos Open Source. + +Este tipo de contribuciones permiten que personas con diversas habilidades y antecedentes participen y hagan contribuciones significativas al software y a la comunidad. Puede leer [este artículo](https://dev.to/opensauced/how-to-contribute-to-open-source-without-knowing-how-to-code-a-guide-with-project-suggestions-59e5) para obtener más información sobre cómo contribuir a proyectos Open Source sin saber codificar. A continuación, hablaremos sobre algunas contribuciones comunes sin codificación. + +### Documentación + +¿Eres amante de las palabras? ¿Te irritan los errores gramaticales? ¿Te gusta analizar problemas complejos o ayudar a las personas a aprender? ¡Entonces la documentación es para ti! + +La documentación es crucial para los proyectos Open Source. Esto implica crear, mejorar o mantener los recursos escritos que acompañan a los proyectos de Open Source Software. La documentación puede hacer que un proyecto sea más accesible y fácil de usar, y puede ayudar a atraer nuevos contribuyentes y fomentar la repetición de contribuciones. + +#### Consejos para contribuir a la documentación + + +*Si está interesado en contribuir con la documentación, aquí tiene algunos consejos:* + +- **Lea toda la documentación**.
Leer toda la documentación le ayudará a comprender mejor el producto y cómo utilizarlo. + +- **Encuentre una tarea que se ajuste bien a sus habilidades e intereses**.
si no está seguro de por dónde empezar, eche un vistazo a los problemas o discusiones antes de comunicarse con un mantenedor. + +- **Utilice el producto**.
El uso del producto usted mismo le ayudará a obtener información sobre el usuario y a determinar qué información debe agregarse o eliminarse de la documentación. + +- **Sea paciente y persistente**.
Se necesita tiempo para redactar una buena documentación. No tengas miedo de pedir ayuda si te quedas atascado. + +##### Ejemplos de aportaciones de documentación: + +Ahora, quizás te preguntes qué debes hacer para contribuir a la documentación de un proyecto. A continuación se muestran algunos ejemplos de qué contribuir: + +- **Escriba o actualice el archivo README**
Si ve que un proyecto necesita un archivo README que explique cómo instalarlo y usarlo, puede ofrecerse a escribir uno. O, si nota que falta información o instrucciones en el archivo README, puede crear un problema y sugerir cómo actualizarlo. + + +- **Crear un tutorial**
Cuando la documentación sobre una función no está disponible, puede abordar este problema y crear un tutorial que guíe a los usuarios a través de la función. + +- **Actualizar la documentación**
A veces, un proyecto tiene nuevos cambios o lanzamientos, pero los mantenedores aún necesitan actualizar la documentación. Puede ayudar a actualizar la documentación para reflejar estos nuevos cambios. + +- **Traducir la documentación**
Si domina otros idiomas, puede ayudar a un proyecto traduciendo la documentación para ampliar su alcance a más usuarios. + +- **Corregir errores tipográficos y gramaticales**
Aunque parezcan pequeños, corregir errores tipográficos y gramaticales puede ayudar a mantener la coherencia y aclarar la documentación. + +### Diseño gráfico + +¿Eres una persona creativa a la que le gusta el diseño? Si es así, quizás quieras considerar contribuir a un proyecto Open Source a través del diseño. + +Esta contribución implica la creación de activos visuales para proyectos Open Source, como logotipos, íconos, ilustraciones, diseños de sitios web y otros elementos gráficos. Estos activos visuales desempeñan un papel importante a la hora de mejorar la experiencia general del usuario y la marca del proyecto. Las contribuciones al diseño gráfico pueden hacer que el software Open Source sea más atractivo, fácil de usar y reconocible. + +- **Logotipo y marca**
Diseñar un logotipo único y memorable para un proyecto Open Source puede ayudar a establecer su identidad y marca. Un logotipo bien diseñado puede hacer que el proyecto sea reconocible al instante y darle una imagen profesional. + +- **Diseño de iconos**
los iconos son esenciales para las interfaces de usuario. Puedes crear íconos personalizados para aplicaciones de software o sitios web, mejorando el atractivo visual y la facilidad de uso del proyecto. + +- **Diseño de sitios web**
los proyectos Open Source suelen tener sitios web para proporcionar información, documentación y enlaces de descarga. Tu puedes contribuir diseñando diseños de sitios web, gráficos, carteles y otros elementos visuales para hacer que el sitio sea más atractivo y fácil de usar. + +- **Diseño de interfaz de usuario (UI)**
para proyectos de software, el diseño de UI es crucial. Tu puedes crear maquetas, bocetos y diseños de alta fidelidad para la interfaz de usuario, haciéndola más intuitiva y visualmente atractiva. + +- **Diseño de experiencia de usuario (UX)**: Al considerar cómo interactúan los usuarios con el software, puede contribuir a mejorar la experiencia general del usuario. Esto incluye el diseño de flujos de usuarios, navegación y pruebas de usabilidad. + +- **Diseño de accesibilidad**
El software y los sitios web deben ser accesibles para todos los usuarios, independientemente de si tienen discapacidades. Puedes contribuir, por ejemplo, creando combinaciones de colores accesibles y contrastes o posicionando elementos visuales dentro del proyecto. Usted puede ayudar a garantizar que todos los elementos visuales sean claros y fáciles de usar. + +- **Diseño responsivo**
diseñar imágenes que funcionen bien en varios dispositivos y tamaños de pantalla es crucial para las aplicaciones web modernas. El diseño responsivo garantiza que el proyecto se vea bien y funcione correctamente tanto en dispositivos móviles como de escritorio. + +### Creación de contenido + +La contribución a través de la creación de contenido —publicaciones de blogs, videos o transmisiones en vivo— implica investigar, escribir o grabar, editar y publicar el contenido. El objetivo es informar y educar a otros sobre un software, proyecto, tecnología o mejores prácticas de Open Source en particular para atraer a más usuarios y contribuyentes. Al igual que la documentación, no necesariamente es necesario saber codificar para crear estos contenidos. + +Aquí hay algunas ideas sobre qué crear: + +- **Últimas funciones**
Puede compartir las funciones más recientes de un proyecto Open Source, como una nueva versión del software o un nuevo complemento. + +- **Tutorial**
La mayoría de las veces, la documentación tiene un espacio limitado para explicar el proyecto en detalle para adaptarse a todos los niveles de usuarios. Puede aprovechar esta oportunidad para dirigirse a audiencias específicas y crear un tutorial sobre cómo instalar y configurar el software o cómo usarlo. + +- **Impacto**
Puede considerar compartir sobre el impacto de un proyecto Open Source en sus usuarios. ¿Por qué quieren usarlo o cuáles son los beneficios de usar el software? De esa forma, estás ayudando a promocionar el proyecto para ganar más usuarios. + +- **Mejores prácticas en Open Source**
Aunque muchos creadores de contenido han compartido información sobre cómo usar Git y GitHub o cómo contribuir a Open Source, siempre que aprendas algo nuevo, siempre podrás compartirlo a través de tu contenido. Nunca se sabe si lo que crea puede inspirar y ayudar a otros a contribuir a Open Source. + +## Contribuciones de codificación + +Las contribuciones de codificación impulsan el desarrollo Open Source. Implican escribir, modificar o mejorar el código fuente real de un proyecto Open Source, lo que afecta directamente la funcionalidad y la calidad del software. + +Los contribuyentes colaboran con los mantenedores del proyecto y la comunidad para garantizar que sus contribuciones de código se alineen con los objetivos del proyecto y los estándares de codificación. Además, los proyectos Open Source suelen tener pautas y procesos para aceptar e integrar contribuciones de codificación, como revisiones de código e integración continua. + +A continuación, se muestran algunos ejemplos de contribuciones que puedes hacer a un proyecto con tus habilidades de codificación: + +- **Escribir nuevo código**
Este es el tipo más común de contribución de codificación. Escribe código nuevo para agregar características o mejorar la funcionalidad de un proyecto Open Source. + +- **Solucionar bugs**
Identificar y corregir errores es una contribución fundamental a la codificación. Usted localiza problemas dentro del código base, los diagnostica y luego escribe código para solucionarlos. Las correcciones de errores mejoran la estabilidad y confiabilidad del software. + +- **Refactorización de código**
Refactorizar código implica reestructurar y mejorar el código existente sin cambiar su comportamiento. Esto ayuda a mejorar la legibilidad, el mantenimiento y la escalabilidad del código, que son vitales para la salud del proyecto a largo plazo. + +- **Diseño y mantenimiento de la API**
Puedes contribuir a proyectos con API públicas diseñando, manteniendo o mejorando la API para garantizar su calidad y confiabilidad. + +- **Desarrollo de funcionalidades**
Puedes ayudar a implementar nuevas características o funcionalidades en respuesta a las necesidades del usuario o los objetivos del proyecto. El desarrollo de funcionalidades implica planificar, diseñar y codificar nuevos componentes o capacidades. + +- **Optimización del rendimiento**
Puede contribuir a optimizar el rendimiento del software mejorando los algoritmos u optimizando el uso de recursos. Este tipo de contribución tiene como objetivo hacer que el software funcione de manera más eficiente. + +- **Pruebas y aseguramiento de la calidad (QA)**
Escribir pruebas automatizadas, incluidas pruebas unitarias, pruebas de integración y pruebas de un extremo a otro, es una contribución de codificación que garantiza la confiabilidad del software. Las pruebas ayudan a detectar y prevenir regresiones y problemas. + +--- + +¡Felicitaciones por terminar este curso! Recapitulemos lo que ha aprendido en el [próximo capítulo](conclusion.md). \ No newline at end of file