From 46dc2dad70ea06f1738f7368e0e6f880a8441dfa Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 19 Jan 2024 02:25:07 +0000 Subject: [PATCH 01/76] feat: add Apanish translation --- translations/es/01-intro.md | 57 +++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 translations/es/01-intro.md diff --git a/translations/es/01-intro.md b/translations/es/01-intro.md new file mode 100644 index 00000000..05ba320e --- /dev/null +++ b/translations/es/01-intro.md @@ -0,0 +1,57 @@ +# Introducción + +¡Bienvenido al curso "Introducción al código abierto"! Este curso integral lo guiará a través del fascinante mundo del código abierto 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 de código abierto, así como también cómo desarrollar su currículum de código abierto. 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 código abierto, 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 código abierto y sus beneficios**: exploraremos el concepto de código abierto, su historia y las numerosas ventajas de contribuir a proyectos de código abierto. +2. **Aprenda a encontrar proyectos de código abierto**: Descubrir proyectos que se alineen con sus intereses y habilidades es crucial para una experiencia gratificante de código abierto. 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 código abierto, 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 de código abierto. +5. **Desarrolla tu currículum de código abierto**: mostrar tus contribuciones de código abierto 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 código abierto. + +## Expectativas + +Este curso está diseñado para brindarle una base sólida en la colaboración de código abierto. 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 código abierto 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 de código abierto, más aprenderá y crecerá como desarrollador. + +2. **La paciencia es clave**: dominar la colaboración de código abierto 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 código abierto 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 de código abierto y lo ayudará a crecer como desarrollador. + +4. **Aprendizaje continuo**: el código abierto 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 de código abierto. 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 código abierto 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 de código abierto: + +1. **Introducción:** Comenzaremos preparando el escenario para su viaje hacia el código abierto, analizando los requisitos previos, los objetivos y las expectativas. +1. **¿Qué es el código abierto?:** En este capítulo, exploraremos la definición de código abierto y su historia, brindándole una base sólida para comprender el contexto de la colaboración de código abierto. +1. **¿Por qué el código abierto?:** Profundizaremos en los beneficios del código abierto, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. +1. **Herramientas para tener éxito:** Este capítulo le presentará las herramientas esenciales para una colaboración exitosa de código abierto, incluidos GitHub, Git, CodeSee, VS Code y Discord. +1. **Cómo contribuir al código abierto:** 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. +1. **La salsa secreta:** Este capítulo revelará las estrategias y técnicas para comenzar, ganar terreno en sus contribuciones y desarrollar su currículum de código abierto. +1. **Conclusión:** Concluiremos el curso con conclusiones clave y discutiremos los próximos pasos en su viaje hacia el código abierto. + +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 de código abierto 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 código abierto 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. + +## LFG 🚀 + +Ahora que hemos preparado el escenario, ¡es hora de embarcarse en su viaje hacia el código abierto! En el próximo capítulo, profundizaremos en la definición de código abierto y exploraremos su historia, sentando las bases para una comprensión más profunda de la colaboración de código abierto. ¡Empecemos! + +[Siguiente Sección ->](02-what-is-open-source.md) From 97d89b64fdfd5aad8b25132c0243ee7f3d0983c0 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Sat, 20 Jan 2024 01:08:41 +0000 Subject: [PATCH 02/76] Add chapter 02 translation --- translations/es/02-what-is-open-source.md | 69 +++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 translations/es/02-what-is-open-source.md diff --git a/translations/es/02-what-is-open-source.md b/translations/es/02-what-is-open-source.md new file mode 100644 index 00000000..77f0001f --- /dev/null +++ b/translations/es/02-what-is-open-source.md @@ -0,0 +1,69 @@ +# ¿Qué es código abierto? + +En este capítulo, profundizaremos en el concepto de código abierto, su definición y su historia. Obtener una comprensión profunda del código abierto le ayudará a apreciar el contexto en el que colaborará y contribuirá. + +## Definición + +El código abierto 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 código abierto 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 de código abierto 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 de código abierto 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 de código abierto + +Para que el software se considere de código abierto, debe publicarse bajo una licencia que otorgue a los usuarios el derecho de acceder, modificar y distribuir el código fuente. Existen numerosas licencias de código abierto disponibles, cada una con su propio conjunto de términos y condiciones. Algunas licencias de código abierto 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 de código abierto promueven una cultura de colaboración, innovación y conocimiento compartido. + +## Breve historia del código abierto + +La idea de compartir libremente conocimientos y recursos ha existido durante siglos, pero el movimiento de código abierto 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 de código abierto. + +### 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 código abierto 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 de código abierto llamado Linux. Cuando se combinó con el sistema GNU, Linux formó un sistema operativo completo, gratuito y de código abierto que todavía se utiliza ampliamente en la actualidad. El éxito de Linux ayudó a popularizar el concepto de código abierto y provocó una ola de nuevos proyectos, herramientas y tecnologías. + +### La iniciativa de código abierto + +En 1998, Christine Peterson, directora ejecutiva de Foresight, acuñó el término "software de código abierto" 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 de Código Abierto (OSI) para difundir más conciencia sobre este concepto. A partir de ahí, la OSI desarrolló la definición de código abierto, un conjunto de criterios que debe cumplir el software para ser considerado de código abierto. 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 código abierto generaron un aumento del interés y la adopción tanto por parte de individuos como de organizaciones. Hoy en día, el software de código abierto se utiliza ampliamente en diversas industrias, y muchas empresas de tecnología reconocidas, como Google, IBM y Microsoft, apoyan y contribuyen activamente a proyectos de código abierto. + +### El crecimiento de las comunidades de código abierto + +A medida que el movimiento de código abierto 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 de código abierto. 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 de código abierto y cuenta con una vibrante comunidad de contribuyentes de todo el mundo. +- **GitLab**: Lanzado en 2011 como una alternativa de código abierto 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 de código abierto 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 de código abierto. Muchas empresas ahora reconocen el valor del código abierto y contribuyen y apoyan activamente varios proyectos. Algunas empresas incluso han llegado a abrir el código abierto de 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 de código abierto, sino que también ha ayudado a legitimar el movimiento de código abierto y fomentar una adopción más amplia. + +## La evolución del código abierto + +El movimiento de código abierto ha recorrido un largo camino desde sus inicios. Hoy en día, el software de código abierto 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 código abierto 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 código abierto 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 de código abierto, 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, exploraremos los muchos beneficios de contribuir a proyectos de código abierto y discutiremos cómo la colaboración de código abierto puede ayudarle a acceder al conocimiento, conectarse con una comunidad y desarrollar habilidades valiosas. + +[Siguiente Sección ->](03-why-open-source.md) From aa3717b33ab4919b7ff9493b781ff62107d4009b Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 24 Jan 2024 02:12:42 +0000 Subject: [PATCH 03/76] Added chapter 03 translation --- translations/es/03-why-open-source.md | 57 +++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 translations/es/03-why-open-source.md diff --git a/translations/es/03-why-open-source.md b/translations/es/03-why-open-source.md new file mode 100644 index 00000000..8c3993f1 --- /dev/null +++ b/translations/es/03-why-open-source.md @@ -0,0 +1,57 @@ +# ¿Por qué código abierto? + +En el capítulo anterior, exploramos el concepto de código abierto y su historia. Ahora, profundicemos en los beneficios de contribuir a proyectos de código abierto. Al comprender las ventajas de la colaboración de código abierto, estará mejor equipado para aprovechar las oportunidades que presenta y aprovechar al máximo su viaje por el código abierto. + +## Acceso al conocimiento + +Uno de los beneficios clave de contribuir a proyectos de código abierto es la oportunidad de acceder a una gran cantidad de conocimientos y recursos. Como colaborador de código abierto, podrás: + +1. **Aprende de proyectos del mundo real**: los proyectos de código abierto 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 de código abierto 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 de código abierto suele estar a la vanguardia de la innovación, con nuevos proyectos, herramientas y tecnologías que surgen constantemente. Al participar en proyectos de código abierto, 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 de código abierto 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 de código abierto 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 de código abierto, puedes: + +1. **Conéctese con personas con ideas afines**: los proyectos de código abierto 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 de código abierto 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 de código abierto 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 de código abierto 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 de código abierto. + +## Acceso a habilidades + +Contribuir a proyectos de código abierto 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 código abierto, 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 de código abierto 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 cartera**: Contribuir a proyectos de código abierto le permite crear un registro público de su trabajo, mostrando sus habilidades y experiencia a posibles empleadores. Un sólido portafolio de contribuciones de código abierto 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 de código abierto 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 de código abierto 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 de código abierto, 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 de código abierto también puede proporcionar otras ventajas, como por ejemplo: + +1. **Mayores oportunidades laborales**: muchos empleadores valoran la experiencia en código abierto y buscan activamente candidatos que tengan un historial comprobado de contribución a proyectos de código abierto. Al mostrar sus contribuciones de código abierto, puede aumentar sus posibilidades de conseguir el trabajo de sus sueños o avanzar en su carrera. + +2. **Realización personal**: Contribuir a proyectos de código abierto 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 de código abierto 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, analizaremos las herramientas y recursos esenciales que necesitará para tener éxito en su viaje hacia el código abierto, incluidos GitHub, Git, CodeSee, 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 de código abierto. + +[Siguiente Sección ->](04-tools-to-be-successful.md) From a7c2f6161d8fda74d38af575ae4a998ded0dcd39 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 29 Jan 2024 22:24:28 +0000 Subject: [PATCH 04/76] fix: file number 1 was renamed --- translations/es/01-introduccion.md | 57 ++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 translations/es/01-introduccion.md diff --git a/translations/es/01-introduccion.md b/translations/es/01-introduccion.md new file mode 100644 index 00000000..05ba320e --- /dev/null +++ b/translations/es/01-introduccion.md @@ -0,0 +1,57 @@ +# Introducción + +¡Bienvenido al curso "Introducción al código abierto"! Este curso integral lo guiará a través del fascinante mundo del código abierto 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 de código abierto, así como también cómo desarrollar su currículum de código abierto. 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 código abierto, 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 código abierto y sus beneficios**: exploraremos el concepto de código abierto, su historia y las numerosas ventajas de contribuir a proyectos de código abierto. +2. **Aprenda a encontrar proyectos de código abierto**: Descubrir proyectos que se alineen con sus intereses y habilidades es crucial para una experiencia gratificante de código abierto. 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 código abierto, 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 de código abierto. +5. **Desarrolla tu currículum de código abierto**: mostrar tus contribuciones de código abierto 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 código abierto. + +## Expectativas + +Este curso está diseñado para brindarle una base sólida en la colaboración de código abierto. 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 código abierto 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 de código abierto, más aprenderá y crecerá como desarrollador. + +2. **La paciencia es clave**: dominar la colaboración de código abierto 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 código abierto 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 de código abierto y lo ayudará a crecer como desarrollador. + +4. **Aprendizaje continuo**: el código abierto 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 de código abierto. 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 código abierto 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 de código abierto: + +1. **Introducción:** Comenzaremos preparando el escenario para su viaje hacia el código abierto, analizando los requisitos previos, los objetivos y las expectativas. +1. **¿Qué es el código abierto?:** En este capítulo, exploraremos la definición de código abierto y su historia, brindándole una base sólida para comprender el contexto de la colaboración de código abierto. +1. **¿Por qué el código abierto?:** Profundizaremos en los beneficios del código abierto, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. +1. **Herramientas para tener éxito:** Este capítulo le presentará las herramientas esenciales para una colaboración exitosa de código abierto, incluidos GitHub, Git, CodeSee, VS Code y Discord. +1. **Cómo contribuir al código abierto:** 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. +1. **La salsa secreta:** Este capítulo revelará las estrategias y técnicas para comenzar, ganar terreno en sus contribuciones y desarrollar su currículum de código abierto. +1. **Conclusión:** Concluiremos el curso con conclusiones clave y discutiremos los próximos pasos en su viaje hacia el código abierto. + +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 de código abierto 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 código abierto 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. + +## LFG 🚀 + +Ahora que hemos preparado el escenario, ¡es hora de embarcarse en su viaje hacia el código abierto! En el próximo capítulo, profundizaremos en la definición de código abierto y exploraremos su historia, sentando las bases para una comprensión más profunda de la colaboración de código abierto. ¡Empecemos! + +[Siguiente Sección ->](02-what-is-open-source.md) From 729ca55bd158625841a4d051f37b963ef578e19d Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 29 Jan 2024 22:27:11 +0000 Subject: [PATCH 05/76] fix: The link to chapter 2 has been replaced --- translations/es/01-introduccion.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/es/01-introduccion.md b/translations/es/01-introduccion.md index 05ba320e..5f9a7a94 100644 --- a/translations/es/01-introduccion.md +++ b/translations/es/01-introduccion.md @@ -54,4 +54,4 @@ Utilice los ejemplos y demostraciones como punto de partida, pero no tema explor Ahora que hemos preparado el escenario, ¡es hora de embarcarse en su viaje hacia el código abierto! En el próximo capítulo, profundizaremos en la definición de código abierto y exploraremos su historia, sentando las bases para una comprensión más profunda de la colaboración de código abierto. ¡Empecemos! -[Siguiente Sección ->](02-what-is-open-source.md) +[Siguiente Sección ->](02-que-es-codigo-abierto.md) From 36edfaa077392c168b4d83dfe28e0bd9f1c3b698 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 29 Jan 2024 22:30:22 +0000 Subject: [PATCH 06/76] fix: file number 2 was renamed --- translations/es/02-que-es-codigo-abierto.md | 69 +++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 translations/es/02-que-es-codigo-abierto.md diff --git a/translations/es/02-que-es-codigo-abierto.md b/translations/es/02-que-es-codigo-abierto.md new file mode 100644 index 00000000..77f0001f --- /dev/null +++ b/translations/es/02-que-es-codigo-abierto.md @@ -0,0 +1,69 @@ +# ¿Qué es código abierto? + +En este capítulo, profundizaremos en el concepto de código abierto, su definición y su historia. Obtener una comprensión profunda del código abierto le ayudará a apreciar el contexto en el que colaborará y contribuirá. + +## Definición + +El código abierto 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 código abierto 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 de código abierto 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 de código abierto 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 de código abierto + +Para que el software se considere de código abierto, debe publicarse bajo una licencia que otorgue a los usuarios el derecho de acceder, modificar y distribuir el código fuente. Existen numerosas licencias de código abierto disponibles, cada una con su propio conjunto de términos y condiciones. Algunas licencias de código abierto 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 de código abierto promueven una cultura de colaboración, innovación y conocimiento compartido. + +## Breve historia del código abierto + +La idea de compartir libremente conocimientos y recursos ha existido durante siglos, pero el movimiento de código abierto 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 de código abierto. + +### 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 código abierto 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 de código abierto llamado Linux. Cuando se combinó con el sistema GNU, Linux formó un sistema operativo completo, gratuito y de código abierto que todavía se utiliza ampliamente en la actualidad. El éxito de Linux ayudó a popularizar el concepto de código abierto y provocó una ola de nuevos proyectos, herramientas y tecnologías. + +### La iniciativa de código abierto + +En 1998, Christine Peterson, directora ejecutiva de Foresight, acuñó el término "software de código abierto" 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 de Código Abierto (OSI) para difundir más conciencia sobre este concepto. A partir de ahí, la OSI desarrolló la definición de código abierto, un conjunto de criterios que debe cumplir el software para ser considerado de código abierto. 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 código abierto generaron un aumento del interés y la adopción tanto por parte de individuos como de organizaciones. Hoy en día, el software de código abierto se utiliza ampliamente en diversas industrias, y muchas empresas de tecnología reconocidas, como Google, IBM y Microsoft, apoyan y contribuyen activamente a proyectos de código abierto. + +### El crecimiento de las comunidades de código abierto + +A medida que el movimiento de código abierto 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 de código abierto. 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 de código abierto y cuenta con una vibrante comunidad de contribuyentes de todo el mundo. +- **GitLab**: Lanzado en 2011 como una alternativa de código abierto 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 de código abierto 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 de código abierto. Muchas empresas ahora reconocen el valor del código abierto y contribuyen y apoyan activamente varios proyectos. Algunas empresas incluso han llegado a abrir el código abierto de 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 de código abierto, sino que también ha ayudado a legitimar el movimiento de código abierto y fomentar una adopción más amplia. + +## La evolución del código abierto + +El movimiento de código abierto ha recorrido un largo camino desde sus inicios. Hoy en día, el software de código abierto 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 código abierto 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 código abierto 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 de código abierto, 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, exploraremos los muchos beneficios de contribuir a proyectos de código abierto y discutiremos cómo la colaboración de código abierto puede ayudarle a acceder al conocimiento, conectarse con una comunidad y desarrollar habilidades valiosas. + +[Siguiente Sección ->](03-why-open-source.md) From e17af06f4ee0381589e68ae07a4e402dd5337459 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 29 Jan 2024 22:31:50 +0000 Subject: [PATCH 07/76] fix: The link to chapter 3 has been replaced --- translations/es/02-que-es-codigo-abierto.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/es/02-que-es-codigo-abierto.md b/translations/es/02-que-es-codigo-abierto.md index 77f0001f..5f57dba5 100644 --- a/translations/es/02-que-es-codigo-abierto.md +++ b/translations/es/02-que-es-codigo-abierto.md @@ -66,4 +66,4 @@ La creciente popularidad del código abierto también ha dado lugar a un próspe En el próximo capítulo, exploraremos los muchos beneficios de contribuir a proyectos de código abierto y discutiremos cómo la colaboración de código abierto puede ayudarle a acceder al conocimiento, conectarse con una comunidad y desarrollar habilidades valiosas. -[Siguiente Sección ->](03-why-open-source.md) +[Siguiente Sección ->](03-por-que-codigo-abierto.md) From ebc7fef9fa2d38e8e56ea05f59d861b73fc0daa5 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 29 Jan 2024 22:32:30 +0000 Subject: [PATCH 08/76] fix: file number 3 was renamed --- translations/es/03-por-que-codigo-abierto.md | 57 ++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 translations/es/03-por-que-codigo-abierto.md diff --git a/translations/es/03-por-que-codigo-abierto.md b/translations/es/03-por-que-codigo-abierto.md new file mode 100644 index 00000000..8c3993f1 --- /dev/null +++ b/translations/es/03-por-que-codigo-abierto.md @@ -0,0 +1,57 @@ +# ¿Por qué código abierto? + +En el capítulo anterior, exploramos el concepto de código abierto y su historia. Ahora, profundicemos en los beneficios de contribuir a proyectos de código abierto. Al comprender las ventajas de la colaboración de código abierto, estará mejor equipado para aprovechar las oportunidades que presenta y aprovechar al máximo su viaje por el código abierto. + +## Acceso al conocimiento + +Uno de los beneficios clave de contribuir a proyectos de código abierto es la oportunidad de acceder a una gran cantidad de conocimientos y recursos. Como colaborador de código abierto, podrás: + +1. **Aprende de proyectos del mundo real**: los proyectos de código abierto 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 de código abierto 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 de código abierto suele estar a la vanguardia de la innovación, con nuevos proyectos, herramientas y tecnologías que surgen constantemente. Al participar en proyectos de código abierto, 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 de código abierto 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 de código abierto 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 de código abierto, puedes: + +1. **Conéctese con personas con ideas afines**: los proyectos de código abierto 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 de código abierto 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 de código abierto 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 de código abierto 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 de código abierto. + +## Acceso a habilidades + +Contribuir a proyectos de código abierto 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 código abierto, 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 de código abierto 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 cartera**: Contribuir a proyectos de código abierto le permite crear un registro público de su trabajo, mostrando sus habilidades y experiencia a posibles empleadores. Un sólido portafolio de contribuciones de código abierto 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 de código abierto 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 de código abierto 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 de código abierto, 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 de código abierto también puede proporcionar otras ventajas, como por ejemplo: + +1. **Mayores oportunidades laborales**: muchos empleadores valoran la experiencia en código abierto y buscan activamente candidatos que tengan un historial comprobado de contribución a proyectos de código abierto. Al mostrar sus contribuciones de código abierto, puede aumentar sus posibilidades de conseguir el trabajo de sus sueños o avanzar en su carrera. + +2. **Realización personal**: Contribuir a proyectos de código abierto 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 de código abierto 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, analizaremos las herramientas y recursos esenciales que necesitará para tener éxito en su viaje hacia el código abierto, incluidos GitHub, Git, CodeSee, 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 de código abierto. + +[Siguiente Sección ->](04-tools-to-be-successful.md) From b7632c0e257b075346eccc00e540d3cd4cc815d3 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 29 Jan 2024 22:33:57 +0000 Subject: [PATCH 09/76] fix: translation fix --- translations/es/03-por-que-codigo-abierto.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/es/03-por-que-codigo-abierto.md b/translations/es/03-por-que-codigo-abierto.md index 8c3993f1..20dc4425 100644 --- a/translations/es/03-por-que-codigo-abierto.md +++ b/translations/es/03-por-que-codigo-abierto.md @@ -34,7 +34,7 @@ Contribuir a proyectos de código abierto puede ayudarle a desarrollar una ampli 2. **Adquiera experiencia con nuevas tecnologías**: Los proyectos de código abierto 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 cartera**: Contribuir a proyectos de código abierto le permite crear un registro público de su trabajo, mostrando sus habilidades y experiencia a posibles empleadores. Un sólido portafolio de contribuciones de código abierto puede ayudarlo a destacarse en el mercado laboral y demostrar su compromiso con el aprendizaje continuo y el crecimiento profesional. +3. **Cree su portafolio**: Contribuir a proyectos de código abierto le permite crear un registro público de su trabajo, mostrando sus habilidades y experiencia a posibles empleadores. Un sólido portafolio de contribuciones de código abierto 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 de código abierto 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. From 43820fbd30623d6cf6f3e153af1a95361eaa2f0e Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 29 Jan 2024 22:36:10 +0000 Subject: [PATCH 10/76] fix: The link to chapter 4 has been replaced --- translations/es/03-por-que-codigo-abierto.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/es/03-por-que-codigo-abierto.md b/translations/es/03-por-que-codigo-abierto.md index 20dc4425..7fe995d6 100644 --- a/translations/es/03-por-que-codigo-abierto.md +++ b/translations/es/03-por-que-codigo-abierto.md @@ -54,4 +54,4 @@ Además de los beneficios mencionados anteriormente, contribuir a proyectos de c En el siguiente capítulo, analizaremos las herramientas y recursos esenciales que necesitará para tener éxito en su viaje hacia el código abierto, incluidos GitHub, Git, CodeSee, 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 de código abierto. -[Siguiente Sección ->](04-tools-to-be-successful.md) +[Siguiente Sección ->](04-herramientas-para-tener-exito.md) From 54753819ce9499f41224613dba1d2be92c8ce38d Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 29 Jan 2024 22:47:28 +0000 Subject: [PATCH 11/76] Removed files: 01-intro.md, 02-what-is-open-source.md, 03-why-open-source.md --- translations/es/01-intro.md | 57 ------------------- translations/es/02-what-is-open-source.md | 69 ----------------------- translations/es/03-why-open-source.md | 57 ------------------- 3 files changed, 183 deletions(-) delete mode 100644 translations/es/01-intro.md delete mode 100644 translations/es/02-what-is-open-source.md delete mode 100644 translations/es/03-why-open-source.md diff --git a/translations/es/01-intro.md b/translations/es/01-intro.md deleted file mode 100644 index 05ba320e..00000000 --- a/translations/es/01-intro.md +++ /dev/null @@ -1,57 +0,0 @@ -# Introducción - -¡Bienvenido al curso "Introducción al código abierto"! Este curso integral lo guiará a través del fascinante mundo del código abierto 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 de código abierto, así como también cómo desarrollar su currículum de código abierto. 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 código abierto, 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 código abierto y sus beneficios**: exploraremos el concepto de código abierto, su historia y las numerosas ventajas de contribuir a proyectos de código abierto. -2. **Aprenda a encontrar proyectos de código abierto**: Descubrir proyectos que se alineen con sus intereses y habilidades es crucial para una experiencia gratificante de código abierto. 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 código abierto, 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 de código abierto. -5. **Desarrolla tu currículum de código abierto**: mostrar tus contribuciones de código abierto 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 código abierto. - -## Expectativas - -Este curso está diseñado para brindarle una base sólida en la colaboración de código abierto. 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 código abierto 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 de código abierto, más aprenderá y crecerá como desarrollador. - -2. **La paciencia es clave**: dominar la colaboración de código abierto 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 código abierto 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 de código abierto y lo ayudará a crecer como desarrollador. - -4. **Aprendizaje continuo**: el código abierto 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 de código abierto. 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 código abierto 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 de código abierto: - -1. **Introducción:** Comenzaremos preparando el escenario para su viaje hacia el código abierto, analizando los requisitos previos, los objetivos y las expectativas. -1. **¿Qué es el código abierto?:** En este capítulo, exploraremos la definición de código abierto y su historia, brindándole una base sólida para comprender el contexto de la colaboración de código abierto. -1. **¿Por qué el código abierto?:** Profundizaremos en los beneficios del código abierto, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. -1. **Herramientas para tener éxito:** Este capítulo le presentará las herramientas esenciales para una colaboración exitosa de código abierto, incluidos GitHub, Git, CodeSee, VS Code y Discord. -1. **Cómo contribuir al código abierto:** 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. -1. **La salsa secreta:** Este capítulo revelará las estrategias y técnicas para comenzar, ganar terreno en sus contribuciones y desarrollar su currículum de código abierto. -1. **Conclusión:** Concluiremos el curso con conclusiones clave y discutiremos los próximos pasos en su viaje hacia el código abierto. - -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 de código abierto 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 código abierto 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. - -## LFG 🚀 - -Ahora que hemos preparado el escenario, ¡es hora de embarcarse en su viaje hacia el código abierto! En el próximo capítulo, profundizaremos en la definición de código abierto y exploraremos su historia, sentando las bases para una comprensión más profunda de la colaboración de código abierto. ¡Empecemos! - -[Siguiente Sección ->](02-what-is-open-source.md) diff --git a/translations/es/02-what-is-open-source.md b/translations/es/02-what-is-open-source.md deleted file mode 100644 index 77f0001f..00000000 --- a/translations/es/02-what-is-open-source.md +++ /dev/null @@ -1,69 +0,0 @@ -# ¿Qué es código abierto? - -En este capítulo, profundizaremos en el concepto de código abierto, su definición y su historia. Obtener una comprensión profunda del código abierto le ayudará a apreciar el contexto en el que colaborará y contribuirá. - -## Definición - -El código abierto 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 código abierto 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 de código abierto 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 de código abierto 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 de código abierto - -Para que el software se considere de código abierto, debe publicarse bajo una licencia que otorgue a los usuarios el derecho de acceder, modificar y distribuir el código fuente. Existen numerosas licencias de código abierto disponibles, cada una con su propio conjunto de términos y condiciones. Algunas licencias de código abierto 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 de código abierto promueven una cultura de colaboración, innovación y conocimiento compartido. - -## Breve historia del código abierto - -La idea de compartir libremente conocimientos y recursos ha existido durante siglos, pero el movimiento de código abierto 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 de código abierto. - -### 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 código abierto 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 de código abierto llamado Linux. Cuando se combinó con el sistema GNU, Linux formó un sistema operativo completo, gratuito y de código abierto que todavía se utiliza ampliamente en la actualidad. El éxito de Linux ayudó a popularizar el concepto de código abierto y provocó una ola de nuevos proyectos, herramientas y tecnologías. - -### La iniciativa de código abierto - -En 1998, Christine Peterson, directora ejecutiva de Foresight, acuñó el término "software de código abierto" 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 de Código Abierto (OSI) para difundir más conciencia sobre este concepto. A partir de ahí, la OSI desarrolló la definición de código abierto, un conjunto de criterios que debe cumplir el software para ser considerado de código abierto. 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 código abierto generaron un aumento del interés y la adopción tanto por parte de individuos como de organizaciones. Hoy en día, el software de código abierto se utiliza ampliamente en diversas industrias, y muchas empresas de tecnología reconocidas, como Google, IBM y Microsoft, apoyan y contribuyen activamente a proyectos de código abierto. - -### El crecimiento de las comunidades de código abierto - -A medida que el movimiento de código abierto 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 de código abierto. 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 de código abierto y cuenta con una vibrante comunidad de contribuyentes de todo el mundo. -- **GitLab**: Lanzado en 2011 como una alternativa de código abierto 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 de código abierto 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 de código abierto. Muchas empresas ahora reconocen el valor del código abierto y contribuyen y apoyan activamente varios proyectos. Algunas empresas incluso han llegado a abrir el código abierto de 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 de código abierto, sino que también ha ayudado a legitimar el movimiento de código abierto y fomentar una adopción más amplia. - -## La evolución del código abierto - -El movimiento de código abierto ha recorrido un largo camino desde sus inicios. Hoy en día, el software de código abierto 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 código abierto 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 código abierto 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 de código abierto, 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, exploraremos los muchos beneficios de contribuir a proyectos de código abierto y discutiremos cómo la colaboración de código abierto puede ayudarle a acceder al conocimiento, conectarse con una comunidad y desarrollar habilidades valiosas. - -[Siguiente Sección ->](03-why-open-source.md) diff --git a/translations/es/03-why-open-source.md b/translations/es/03-why-open-source.md deleted file mode 100644 index 8c3993f1..00000000 --- a/translations/es/03-why-open-source.md +++ /dev/null @@ -1,57 +0,0 @@ -# ¿Por qué código abierto? - -En el capítulo anterior, exploramos el concepto de código abierto y su historia. Ahora, profundicemos en los beneficios de contribuir a proyectos de código abierto. Al comprender las ventajas de la colaboración de código abierto, estará mejor equipado para aprovechar las oportunidades que presenta y aprovechar al máximo su viaje por el código abierto. - -## Acceso al conocimiento - -Uno de los beneficios clave de contribuir a proyectos de código abierto es la oportunidad de acceder a una gran cantidad de conocimientos y recursos. Como colaborador de código abierto, podrás: - -1. **Aprende de proyectos del mundo real**: los proyectos de código abierto 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 de código abierto 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 de código abierto suele estar a la vanguardia de la innovación, con nuevos proyectos, herramientas y tecnologías que surgen constantemente. Al participar en proyectos de código abierto, 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 de código abierto 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 de código abierto 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 de código abierto, puedes: - -1. **Conéctese con personas con ideas afines**: los proyectos de código abierto 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 de código abierto 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 de código abierto 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 de código abierto 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 de código abierto. - -## Acceso a habilidades - -Contribuir a proyectos de código abierto 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 código abierto, 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 de código abierto 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 cartera**: Contribuir a proyectos de código abierto le permite crear un registro público de su trabajo, mostrando sus habilidades y experiencia a posibles empleadores. Un sólido portafolio de contribuciones de código abierto 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 de código abierto 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 de código abierto 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 de código abierto, 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 de código abierto también puede proporcionar otras ventajas, como por ejemplo: - -1. **Mayores oportunidades laborales**: muchos empleadores valoran la experiencia en código abierto y buscan activamente candidatos que tengan un historial comprobado de contribución a proyectos de código abierto. Al mostrar sus contribuciones de código abierto, puede aumentar sus posibilidades de conseguir el trabajo de sus sueños o avanzar en su carrera. - -2. **Realización personal**: Contribuir a proyectos de código abierto 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 de código abierto 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, analizaremos las herramientas y recursos esenciales que necesitará para tener éxito en su viaje hacia el código abierto, incluidos GitHub, Git, CodeSee, 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 de código abierto. - -[Siguiente Sección ->](04-tools-to-be-successful.md) From 33bdac884b6d4dbe445233306e6839167720a971 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 2 Feb 2024 20:35:47 +0000 Subject: [PATCH 12/76] Added chapter 04 translation --- .../es/04-herramientas-para-tener-exito.md | 137 ++++++++++++++++++ 1 file changed, 137 insertions(+) create mode 100644 translations/es/04-herramientas-para-tener-exito.md diff --git a/translations/es/04-herramientas-para-tener-exito.md b/translations/es/04-herramientas-para-tener-exito.md new file mode 100644 index 00000000..e9795c68 --- /dev/null +++ b/translations/es/04-herramientas-para-tener-exito.md @@ -0,0 +1,137 @@ +# Herramientas para tener éxito + +Para tener éxito en su viaje hacia el código abierto, 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 de código abierto. En este capítulo, analizaremos las siguientes herramientas esenciales para la colaboración de código abierto: + +- GitHub y Git +- CodeSee +- 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 navegue hasta [https://github.com/new](https://github.com/new) o 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 `repositorio-practica`. + +![nueva captura de pantalla del repositorio](/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 `repositorio-practica`. + +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 `repositorio-practica`. + +4. **Realizar cambios y confirmar**: Debería haber un archivo en su repositorio: `README.md`. Dentro de ese archivo, debajo de `#repositorio-practica`, 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/repositorio-practica +``` + +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 de código abierto! + +## CodeSee + +CodeSee es una poderosa herramienta de visualización que ayuda a los desarrolladores a comprender bases de código complejas y navegar por proyectos grandes de manera más eficiente. Al proporcionar una representación visual de su código, CodeSee le permite: + +- **Identificar dependencias**: CodeSee lo ayuda a comprender cómo están conectadas las diferentes partes de su código base y cómo los cambios en un área pueden afectar otras áreas. +- **Analizar la estructura del código**: CodeSee le permite visualizar la estructura de su código, lo que facilita la identificación de patrones, antipatrones y áreas de mejora. +- **Navegue por bases de código grandes**: con CodeSee, puede navegar rápidamente por bases de código grandes y encontrar las partes del código en las que necesita trabajar. + +Para comenzar con CodeSee, visite el sitio web oficial (https://www.codesee.io/) y siga las instrucciones para instalar la extensión del navegador e integrarla con su cuenta de GitHub. + +## VS Code + +Visual Studio Code (VS Code) es un editor de código popular, gratuito y de código abierto 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 de código abierto, 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 de código abierto 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 de código abierto 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 de código abierto. 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 de código abierto 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 de código abierto. En el próximo capítulo, analizaremos cómo contribuir a proyectos de código abierto, 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. + +[Siguiente Sección ->](05-como-contribuir-a-codigo-abierto.md) From 0fab421c8f75a59e714ce781738c19a3ba2e9eca Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Tue, 6 Feb 2024 21:11:05 +0000 Subject: [PATCH 13/76] Added chapter 05 translation --- .../es/05-como-contribuir-a-codigo-abierto.md | 353 ++++++++++++++++++ 1 file changed, 353 insertions(+) create mode 100644 translations/es/05-como-contribuir-a-codigo-abierto.md diff --git a/translations/es/05-como-contribuir-a-codigo-abierto.md b/translations/es/05-como-contribuir-a-codigo-abierto.md new file mode 100644 index 00000000..973af58e --- /dev/null +++ b/translations/es/05-como-contribuir-a-codigo-abierto.md @@ -0,0 +1,353 @@ +# Cómo contribuir a código abierto + +En este capítulo, lo guiaremos a través del proceso de contribución a proyectos de código abierto. + +## Encontrar proyectos en los que trabajar + +Uno de los primeros desafíos que puede enfrentar al comenzar con el código abierto 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 de código abierto. 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 de código abierto y agradecen las contribuciones de la comunidad. + +3. **Únase a comunidades de código abierto**: existen numerosas comunidades, foros y plataformas de chat en línea dedicados al desarrollo de código abierto. 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 "primeros buenos números", 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 de código abierto. Al utilizar OpenSauced, puede encontrar proyectos que se alineen con sus intereses, habilidades y objetivos. + +### Descubriendo el código abierto con OpenSauced + +OpenSauced es una poderosa herramienta para encontrar proyectos de código abierto 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. + + ![Imagen](../../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](../../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 de código abierto 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 de código abierto, 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. Esto le ayudará 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 de código abierto 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 de código abierto 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 de código abierto. 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 las Pautas de contribución**: investigue cómo el proyecto recibe contribuciones leyendo el archivo CONTRIBUCIÓN. Desea asegurarse de seguir las reglas de contribución del proyecto. + +2. **Busque o cree un problema**: busque problemas etiquetados como "primer buen número" o "apto para principiantes" que sean adecuados para su nivel de habilidad. Alternativamente, identifique una característica o mejora en la que le gustaría trabajar. Compruebe si se alinea con la hoja de ruta del proyecto y cree un problema. Esto podría incluir actualizaciones de documentación, correcciones de errores, cambios de contenido y más. + +3. **Solicite que se le asigne el problema**: al realizar su primera contribución a un proyecto, es una buena idea pedirles a los mantenedores que le asignen el problema. Esto asegurará que no duplique el trabajo y que su contribución esté alineada con los objetivos y requisitos del proyecto. + + Si no hay instrucciones en el archivo CONTRIBUTING, puede dejar un comentario sobre el problema: "¿Me pueden asignar este problema?" Cuando el mantenedor lo haya asignado, notará que su nombre de usuario ahora se encuentra en la sección "Asignados". + + ![captura de pantalla del problema asignado](../../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](https://docs.github.com/en/get-started/quickstart/fork-a-repo#forking-a-repository)**: Bifurcar un repositorio 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 su repositorio bifurcado](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository#cloning-a-repository)**: haga un copia de su repositorio bifurcado a 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, crea una nueva rama en tu repositorio local para trabajar en tu contribución. Crear una nueva rama es la mejor práctica en código abierto porque mantiene los cambios separados de la rama "principal". + + 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 y pruebe sus cambios para asegurarse de que funcionen como se espera. + +5. **Agregue y confirme sus 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. + +6. **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. + +7. **[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)**: una vez que hayas enviado tus cambios, navega hasta el repositorio del proyecto original en GitHub y haz clic en el botón "Comparar y solicitar extracción". Complete la información requerida y envíe su solicitud de extracción haciendo clic en el botón "Crear solicitud de extracción". + +8. **Responder a los comentarios**: 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 de código abierto 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 de código abierto. + +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 de código abierto, 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 haciendo clic en el botón "Nuevo problema" en la pestaña "Problemas" y complete el formulario. +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. Agréguese al libro de visitas. + + Hay dos formas de completar esta actividad: + + - Utilizando la herramienta CLI. + - Editar manualmente el archivo `.all-contributorsrc`. + + Aunque agregarse al libro de visitas con la herramienta CLI es más sencillo, recomendamos editar manualmente el archivo para obtener más experiencia agregando y confirmando sus cambios, creando solicitudes de extracción y revisiones de solicitudes de extracción. A continuación encontrará las instrucciones para cada método: + + **Herramienta CLI** + + - 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. + + **Adición manual** + + - Abra el archivo `.all-contributorsrc`. + - Ir al último contribuyente en la matriz de contribuyentes. + - Agregue una coma después de la última llave de cierre (`},`). + - Copia y pega la siguiente plantilla: + + ```javascript + { + "login": "", + "name": "", + "avatar_url": "", + "profile": "", + "contributions": [] + } + ``` + + - Agréguese manualmente al libro de visitas actualizando esta información: + + - **login**: su nombre de usuario de GitHub. + - **name**: Tu nombre. + - **avatar_url**: URL de tu avatar en GitHub. + + En su navegador, copie y pegue el enlace de su perfil de GitHub, agregue `.png` al final (por ejemplo, `https://github.com/TU_NOMBRE_DE_USUARIO.png`) y haga clic en Intro. Copia y pega el enlace aquí. + + - **profile**: Enlace a tu sitio web (si lo incluyes en tu perfil de GitHub) **o** tu perfil de GitHub. + - **contribution**: Tipo de tus contribuciones. + + Consulte los tipos (en la primera columna) en esta [clave de emoji y tipos de contribución](https://allcontributors.org/docs/en/emoji-key) para completar los valores. + + > ⚠️ **Tienes que utilizar estrictamente los tipos de la lista para evitar romper todo el proyecto.** + + El resultado sería así: + + ```javascript + { + "login": "nombre-de-usuario-de-github", + "name": "Nombre de Usuario", + "avatar_url": "https://avatars.githubusercontent.com/u/xxxxxxxx?v=x", + "profile": "URL link", + "contributions": [ + "pregunta", + "Blog", + "código" + ] + } + ``` + + > ⚠️ **Recuerde agregar una coma después de las comillas, excepto la última de la matriz y la última llave de cierre.** + +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. + + > **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. Si utilizó el método de la herramienta CLI en el paso 5 para agregarse al libro de visitas, **omita este paso**. De lo contrario: + + Agregue y confirme sus cambios ejecutando el siguiente comando: + + ```bash + git commit -am "Tu mensaje de confirmación" + ``` + + Reemplace `"Tu mensaje de confirmación"` por su propio mensaje. Por ejemplo, `"Agregar a Alice como colaboradora"`. + + > **Nota**: A diferencia del enfoque `git add .` y `git commit -m "Tu mensaje"`, en el comando `git commit -am`, agregar el indicador `-a` a `git commit` omite el proceso de puesta en escena. La bandera `-a` organiza automáticamente todos sus cambios en archivos _committed_. Combinarlo con el indicador `-m` le permite escribir el mensaje de confirmación. + +10. Ejecute `git log` para verificar si ha confirmado sus cambios. Presione `Q` para cerrar el registro. + + Si se agrega utilizando la herramienta CLI, automáticamente agrega y confirma sus cambios. Entonces verá este mensaje de confirmación automatizado: + + ```bash + docs: add @your_username as a contributor + ``` + +11. Envíe el compromiso a su repositorio bifurcado con este comando: + + ```bash + git push -u origin nombre-rama + ``` + +12. Vaya a su repositorio bifurcado en GitHub y cree una solicitud de extracción con el título `feat: Add <@github-username> as a colaborator`. + +¡Felicitaciones por tu primera 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 de código abierto. 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 de código abierto, como los repositorios [libro de visitas](https://github.com/open-sauced/guestbook) y [pizza verse](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 de código abierto: + +#### 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`, `hazaña: 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 de código abierto, obtendrá experiencia valiosa, desarrollará nuevas habilidades y creará un sólido portafolio de trabajo. En el próximo capítulo, analizaremos algunas estrategias para comenzar con las contribuciones de código abierto, ganar terreno en sus contribuciones y desarrollar su currículum de código abierto utilizando OpenSauced. + +[Siguiente Sección ->](06-la-salsa-secreta.md) From ecf89cd54ab871b9932b594d87f91f93d6e11b0f Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Tue, 6 Feb 2024 21:14:09 +0000 Subject: [PATCH 14/76] fix: link to images folder --- translations/es/04-herramientas-para-tener-exito.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/es/04-herramientas-para-tener-exito.md b/translations/es/04-herramientas-para-tener-exito.md index e9795c68..8bdcaf5f 100644 --- a/translations/es/04-herramientas-para-tener-exito.md +++ b/translations/es/04-herramientas-para-tener-exito.md @@ -57,7 +57,7 @@ Para practicar el uso de GitHub, veremos cómo crear un repositorio, clonarlo, r Elija usted mismo como propietario del repositorio e ingrese un nombre para su repositorio. Para este ejemplo, usaremos `repositorio-practica`. -![nueva captura de pantalla del repositorio](/images/new-repo.png) +![nueva captura de pantalla del repositorio](../../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. From 08970c5763168c1555e6718d605fcb15bb2430d0 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Tue, 6 Feb 2024 21:17:07 +0000 Subject: [PATCH 15/76] fix: consistency changes --- translations/es/04-herramientas-para-tener-exito.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/translations/es/04-herramientas-para-tener-exito.md b/translations/es/04-herramientas-para-tener-exito.md index 8bdcaf5f..3a202bf3 100644 --- a/translations/es/04-herramientas-para-tener-exito.md +++ b/translations/es/04-herramientas-para-tener-exito.md @@ -55,7 +55,7 @@ Para practicar el uso de GitHub, veremos cómo crear un repositorio, clonarlo, r 1. **Cree un nuevo repositorio**: inicie sesión en su cuenta de GitHub y navegue hasta [https://github.com/new](https://github.com/new) o 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 `repositorio-practica`. +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](../../images/new-repo.png) @@ -69,16 +69,16 @@ Para este ejemplo, inicialice el repositorio con un archivo README. 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 `repositorio-practica`. +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 `repositorio-practica`. +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 `#repositorio-practica`, escribe '¡hola mundo!' Una vez que haya realizado cambios, puede prepararlos y confirmarlos. +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/repositorio-practica +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: From 4dd1b7a48a0e30e6361fa8b1817dde78e1f47efc Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 7 Feb 2024 03:27:56 +0000 Subject: [PATCH 16/76] Added chapter 06 translation --- translations/es/06-la-salsa-secreta.md | 79 ++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 translations/es/06-la-salsa-secreta.md diff --git a/translations/es/06-la-salsa-secreta.md b/translations/es/06-la-salsa-secreta.md new file mode 100644 index 00000000..ead24475 --- /dev/null +++ b/translations/es/06-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 de código abierto. Discutiremos cómo centrarse en problemas abiertos, obtener tracción en sus contribuciones y desarrollar su currículum de código abierto 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 de código abierto, 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 de código abierto 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 "primer buen número" 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 de código abierto. + +## Obteniendo tracción en las contribuciones + +A medida que adquiera más experiencia en contribuciones de código abierto, 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 código abierto 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 de código abierto. + +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 de código abierto. + +5. **Orientar a nuevos contribuyentes**: a medida que adquiera más experiencia en contribuciones de código abierto, considere asesorar a nuevos contribuyentes que recién estén comenzando su recorrido por el código abierto. Esto puede ayudarle a contribuir a la comunidad, desarrollar sus habilidades de liderazgo y construir una reputación positiva. + +## Construyendo su currículum de código abierto + +Crear un currículum sólido de código abierto 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 de código abierto y desarrollar su currículum de código abierto. Veamos cómo puede utilizar OpenSauced para respaldar su viaje hacia el código abierto. + +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 de código abierto. 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](../../images/opensauced-profile.png) + +3. **Cree su currículum de código abierto**: 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 código abierto. 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 resaltado a tu perfil](../../images/opensauced-highlights.png) + +**¡Compártelo!**: Una vez que hayas creado un currículum de contribuciones de código abierto, 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 de código abierto. + +Al aprovechar OpenSauced para realizar un seguimiento de sus contribuciones de código abierto y desarrollar su currículum, estará mejor equipado para mostrar sus habilidades, experiencia e impacto en la comunidad de código abierto. + +En conclusión, comenzar con contribuciones de código abierto 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 código abierto. + +[Sección Final ->](07-tipos-de-contribuciones.md) From eca821700988dcc13d2024392623f13ccd677e4c Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 7 Feb 2024 04:03:21 +0000 Subject: [PATCH 17/76] Added chapter 07 translation --- translations/es/07-tipos-de-contribuciones.md | 109 ++++++++++++++++++ 1 file changed, 109 insertions(+) create mode 100644 translations/es/07-tipos-de-contribuciones.md diff --git a/translations/es/07-tipos-de-contribuciones.md b/translations/es/07-tipos-de-contribuciones.md new file mode 100644 index 00000000..461938be --- /dev/null +++ b/translations/es/07-tipos-de-contribuciones.md @@ -0,0 +1,109 @@ +# Tipos de contribuciones + +En este capítulo, discutiremos los tipos de contribuciones de codificación y no codificación involucradas en proyectos de código abierto. + +## Tipo de 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 de código abierto. Permiten que personas con una variedad de habilidades y antecedentes participen y hagan contribuciones significativas al software y a la comunidad. + +> [Cómo contribuir al código abierto 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) + +**Tipos comunes de contribuciones no codificadas** + + - Documentación + - Diseño gráfico + - Redacción de blogs + +### 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! + +Esto implica crear, mejorar o mantener los recursos escritos que acompañan a los proyectos de software de código abierto. La documentación es crucial para los proyectos de código abierto. 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. + +#### Cómo contribuir a la documentación + +*Si está interesado en contribuir con la documentación, aquí tiene algunos consejos:* + +- **Lea la documentación**: Esto le ayudará a comprender cómo se utiliza el producto. + +- **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**: obtener información sobre el usuario le ayudará a ver qué información es necesaria o no útil en los documentos. + +- **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: + + - Escriba un archivo README que explique cómo instalar y usar el proyecto: [La aplicación OpenSauced + ](https://github.com/open-sauced/app/blob/beta/README.md) + + - Cree un tutorial que guíe a los usuarios a través de las funciones del proyecto: [Función destacada de OpenSauced](https://docs.opensauced.pizza/community/highlights/) + + - Actualice la documentación del proyecto para reflejar los nuevos cambios: [Agregar tarjetas de desarrollo a Introducción](https://github.com/open-sauced/docs/issues/156) + + - Traducir la documentación del proyecto a otros idiomas: [Traducir el curso a otro idioma](https://github.com/open-sauced/intro/issues/16) + + - Corregir errores tipográficos y gramaticales en la documentación: [Agregar información sobre posesivos + ](https://github.com/StyleGuides/WritingStyleGuide/pull/519) + + - Mejorar el formato de la documentación: [Destino del enlace incorrecto en la documentación](https://github.com/open-sauced/docs/pull/144) + + - Agregue la información que falta a la documentación: [Agregue más información para usar esta plantilla en el README](https://github.com/open-sauced/100-days-of-oss-template/pull/8) + +Contribuir a la documentación es una excelente manera de ayudar a los proyectos de código abierto y hacerlos más accesibles para todos. Si tienes las habilidades y el interés, ¡participa! + +### Diseño gráfico + +Esta contribución de código abierto implica la creación de activos visuales, como logotipos, íconos, ilustraciones, diseños de sitios web y otros elementos gráficos, para proyectos de código abierto. 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 de código abierto sea más atractivo, fácil de usar y reconocible. + - **Logotipo y marca**: Diseñar un logotipo único y memorable para un proyecto de código abierto 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. Los diseñadores gráficos pueden crear íconos personalizados para aplicaciones de software o sitios web, mejorando el atractivo visual y la usabilidad del proyecto: [registro en Eventhub](https://github.com/WebXGuild/webx-guild/pull/13) + + - **Diseño de sitios web**: los proyectos de código abierto suelen tener sitios web para proporcionar información, documentación y enlaces de descarga. Los diseñadores gráficos pueden 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. Los diseñadores pueden 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)**: los diseñadores de UX se centran en mejorar la experiencia general del usuario considerando cómo interactúan los usuarios con el software. Esto incluye el diseño de flujos de usuarios, navegación y pruebas de usabilidad. + +- **Diseño de accesibilidad**: Garantizar que los elementos gráficos del proyecto sean accesibles para todos los usuarios, incluidos aquellos con discapacidades, es un aspecto importante del diseño gráfico. Los diseñadores pueden crear combinaciones de colores accesibles y garantizar que los elementos visuales sean perceptibles y operables. + +- **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. + +### Escritura de blogs + +Este tipo de contribución de código abierto implica la creación y publicación de blogs, artículos o tutoriales relacionados con software, proyectos, tecnologías o mejores prácticas de código abierto. Al igual que la documentación, no necesariamente es necesario saber codificar para escribir estas publicaciones. + +#### Formas de utilizar los blogs como contribución de código abierto + +- Puede escribir sobre las últimas funciones de un proyecto de código abierto, como una nueva versión del software o un nuevo complemento: [Anuncio de la versión 0.2.0 de Analog](https://dev.to/analogjs/announcing-the-020-release-of-analog-aa1) + +- Puedes escribir un tutorial sobre cómo instalar y configurar el software: [Cómo hacer una deliciosa guía de contribución](https://dev.to/opensauced/how-to-make-a-delicious-contributing-guide-4bp3 ) + +- Escriba sobre el impacto de un proyecto de código abierto, como por ejemplo cómo se ha utilizado para marcar la diferencia en el mundo: [Reteniendo a los mejores ingenieros](https://opensauced.pizza/blog/retaining-the-best-engineers ) + +- Tipos de contribuciones codificadas y no codificadas, como cómo comenzar con el código abierto: [Código abierto 101: una guía para principiantes para comenzar](https://opensauced.pizza/blog/open-source-101-a-beginner's-guide-to-getting-started) + +## Tipos de contribuciones de codificación + +Las contribuciones de codificación impulsan el desarrollo de código abierto. Implican escribir, modificar o mejorar el código fuente real de un proyecto de código abierto, 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 de código abierto 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 código nuevo**: este es el tipo más común de contribución de codificación. Los desarrolladores escriben código nuevo para agregar funciones, corregir errores o mejorar la funcionalidad de un proyecto de código abierto. Estas contribuciones generalmente se envían en forma de solicitudes de extracción (PR) o parches: [Mostrar quién reaccionó a los momentos destacados](https://github.com/open-sauced/app/pull/1591) + +- **Corrección de errores**: identificar y corregir errores es una contribución fundamental a la codificación. Los desarrolladores localizan problemas dentro del código base, los diagnostican y luego escriben código para corregirlos. Las correcciones de errores mejoran la estabilidad y confiabilidad del software: [La verificación de pelusa ocurre dos veces al confirmar +](https://github.com/open-sauced/app/pull/1635) + +- **Refactorización de código**: La refactorización implica reestructurar y mejorar el código existente sin cambiar su comportamiento externo. Esto ayuda a mejorar la legibilidad, el mantenimiento y la escalabilidad del código, que son vitales para la salud a largo plazo del proyecto: [función CalcDistanceFromToday](https://github.com/open-sauced/app/pull/1633) + +- **Diseño y mantenimiento de API**: para proyectos con API públicas, los desarrolladores pueden contribuir al diseño, mantenimiento y mejora de la API para garantizar que permanezca estable y amigable para los desarrolladores: [Token de actualización +](https://github.com/IridiumIdentity/iridium/pull/134) + +- **Desarrollo de funcionalidades**: los desarrolladores contribuyen implementando nuevas características o funcionalidades en respuesta a las necesidades del usuario o los objetivos del proyecto. El desarrollo de funcionalidades a menudo implica planificar, diseñar y codificar nuevos componentes o capacidades: [Se agregó la página de contacto +](https://github.com/TechIsHiring/techishiring-website/pull/53) + +- **Optimización del rendimiento**: los codificadores pueden trabajar para optimizar el rendimiento del software refactorizando el código, mejorando los algoritmos u optimizando el uso de recursos. Este tipo de contribución tiene como objetivo hacer que el software se ejecute de manera más eficiente: [La tabla de repositorios en pantallas pequeñas no muestra la selección](https://github.com/open-sauced/app/pull/1559) + +- **Pruebas y control de calidad**: 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: [Agregar componente de inicio de sesión forzado al sistema de diseño](https://github.com/open-sauced/app/pull/1330) + +[Siguiente sección ->](08-recursos-adicionales.md) From 645b0379ae69f4bfb57f6c484fba8f5ecd58f6a4 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 9 Feb 2024 01:53:09 +0000 Subject: [PATCH 18/76] Added chapter 08 translation --- translations/es/08-recursos-adicionales.md | 23 ++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 translations/es/08-recursos-adicionales.md diff --git a/translations/es/08-recursos-adicionales.md b/translations/es/08-recursos-adicionales.md new file mode 100644 index 00000000..372fee74 --- /dev/null +++ b/translations/es/08-recursos-adicionales.md @@ -0,0 +1,23 @@ +¡Felicitaciones por su viaje hacia el código abierto! Aquí hay algunos recursos para aprender más sobre cómo comenzar con el código abierto: + +## Guías y tutoriales +- [Guías de código abierto](https://opensource.guide/) de GitHub: guías completas sobre diversos aspectos del código abierto, 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 de código abierto. + +- [Guía para principiantes sobre el desarrollo de software de código abierto](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 de código abierto, incluyendo su historia, licencias y modelos de desarrollo. + +- [Red de estudiantes de código abierto (OSSN) de Mozilla](https://community.mozilla.org/en/): proporciona recursos y apoyo para estudiantes interesados ​​en el código abierto, incluidas guías, eventos y oportunidades de tutoría. + +- [Introducción a GitHub y proyectos de código abierto](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 de código abierto, incluido cómo encontrar proyectos en los que contribuir, comprender el código base y enviar contribuciones. + +- [Viernes de código abierto](https://opensourcefriday.com/) de GitHub: un movimiento global que anima a individuos y organizaciones a contribuir al código abierto todos los viernes. El sitio web proporciona recursos y guías sobre cómo iniciarse en el código abierto y encontrar proyectos en los que contribuir. + +## Publicaciones de blog +- [Más allá de la creación de contenido: cómo las contribuciones de código abierto 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 código abierto 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 número: consejos para una comunicación eficaz en código abierto](https://dev.to/opensauced/how-to-write-a-good-issue-tips-for-effective-communication-in-open-source-5443) +- [Los primeros números buenos no existen](https://opensauced.pizza/blog/good-first-issues-dont-exist) + +[Siguiente Sección ->](09-conclusion.md) From 6e6f9183f288b9f8d3da5ffe1495055e6a4f7fed Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 9 Feb 2024 02:03:26 +0000 Subject: [PATCH 19/76] Added chapter 09 translation --- translations/es/09-conclusion.md | 41 ++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 translations/es/09-conclusion.md diff --git a/translations/es/09-conclusion.md b/translations/es/09-conclusion.md new file mode 100644 index 00000000..c1e156a6 --- /dev/null +++ b/translations/es/09-conclusion.md @@ -0,0 +1,41 @@ +# Conclusión + +Mientras concluimos este curso sobre cómo comenzar con el código abierto, recapitulemos los puntos clave y analicemos lo que sigue en su viaje hacia el código abierto. + +## 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 código abierto: + +1. **¿Qué es código abierto?**: Discutimos la definición de código abierto, su historia y los principios básicos que guían el movimiento del código abierto. + +2. **¿Por qué código abierto?**: Exploramos los beneficios de participar en proyectos de código abierto, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. + +3. **Herramientas para tener éxito**: presentamos herramientas y plataformas esenciales para contribuyentes de código abierto, como GitHub, Git, CodeSee, Visual Studio Code y Discord. + +4. **Cómo contribuir a código abierto**: 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. + +5. **La salsa secreta**: compartimos estrategias para comenzar con las contribuciones de código abierto, ganar terreno en sus contribuciones y desarrollar su currículum de código abierto utilizando OpenSauced. + +Al comprender estos conceptos y aplicar las estrategias que hemos analizado, estará bien equipado para embarcarse en un viaje exitoso hacia el código abierto. + +## ¿Que sigue? + +Con el conocimiento y las herramientas que obtuvo en este curso, está listo para sumergirse en el mundo del código abierto y comenzar a realizar contribuciones significativas. Estos son algunos de los próximos pasos que le ayudarán a continuar su viaje hacia el código abierto: + +1. **Identifica tus intereses y objetivos**: antes de comenzar a contribuir en proyectos de código abierto, 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 de código abierto 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 de código abierto**: ú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 código abierto para aprender de otros, establecer contactos con otros desarrolladores y mantenerse actualizado sobre las últimas tendencias y mejores prácticas en el mundo del código abierto. . + +6. **Comparta sus experiencias**: documente su viaje hacia el código abierto 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 de código abierto. + +7. **Continuar aprendiendo**: El código abierto 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 de código abierto. Hemos incluido una [sección de recursos adicionales](08-recursos-adicionales.md) para obtener más información. + +En conclusión, embarcarse en un viaje hacia el código abierto 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 código abierto. Así que adelante y comienza a contribuir: ¡la comunidad de código abierto espera ansiosamente tu participación! + +[Siguiente sección ->](10-glosario.md) From 4b93a4d67eb13bb5f6ee0d20e6ba8caba54aba34 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 9 Feb 2024 19:59:12 +0000 Subject: [PATCH 20/76] Added chapter 10 translation --- translations/es/10-glosario.md | 72 ++++++++++++++++++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 translations/es/10-glosario.md diff --git a/translations/es/10-glosario.md b/translations/es/10-glosario.md new file mode 100644 index 00000000..d319b06d --- /dev/null +++ b/translations/es/10-glosario.md @@ -0,0 +1,72 @@ +## Aseguramiento de la calidad + +El aseguramiento de la calidad en proyectos de código abierto 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 de código abierto 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 de código abierto. Los contribuyentes pueden ser desarrolladores, diseñadores, escritores, evaluadores o cualquier otra persona que ayude a mejorar el proyecto. + +## Documentos + +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 de código abierto 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 de código abierto. 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 + +OSS significa proyectos de "software de código abierto". 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 código abierto, 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. From 6756d24bf78e905b452828700898b731dc549db6 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 9 Feb 2024 20:54:26 +0000 Subject: [PATCH 21/76] docs: Update README with spanish translation & french link --- translations/es/README.md | 58 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 translations/es/README.md diff --git a/translations/es/README.md b/translations/es/README.md new file mode 100644 index 00000000..1dff2907 --- /dev/null +++ b/translations/es/README.md @@ -0,0 +1,58 @@ +
+
+ Salsa abierta +

🍕 Introducción al código abierto con OpenSauced 🍕

+ El sitio proporciona materiales del curso de Introducción al código abierto de OpenSauced. +
+
+ +¡Bienvenido al curso de Introducción al Código Abierto con OpenSauced! Este curso está diseñado para brindarle una introducción al código abierto y guiarlo a través del proceso de contribución a proyectos de código abierto. +## Soporte de idioma +Al igual que la pizza, el código abierto debe compartirse con todos. Haga clic en los enlaces a continuación para seguir este curso en los siguientes idiomas diferentes. + +- [Inglés](/README.md) +- [Francés](/translations/fr/README.md) + +## Resumen del curso + +El curso está dividido en cinco capítulos, cada uno de los cuales cubre un aspecto diferente del código abierto: + +1. **¿Qué es código abierto?** Este capítulo proporciona una introducción al código abierto, su historia y su importancia en el panorama actual del desarrollo de software. + +2. **¿Por qué código abierto?** En este capítulo, conocerá los beneficios del software de código abierto, como una mayor colaboración, un desarrollo más rápido y una mejor calidad. + +3. **Herramientas para tener éxito.** Descubra las herramientas y plataformas clave necesarias para un viaje exitoso en el desarrollo de código abierto. Desde Git y GitHub para control de versiones y colaboración hasta CodeSee para visualización de código y VS Code como editor de código, este capítulo proporciona una descripción general de cómo aprovechar estas herramientas esenciales. + +4. **¿Cómo contribuir al código abierto?** Este capítulo cubre la búsqueda de proyectos en los que trabajar, el envío de contribuciones, la integración en nuevos proyectos y los resultados después de enviar las contribuciones. Los consejos para encontrar proyectos incluyen navegar por GitHub y GitLab, seguir sus intereses personales, unirse a comunidades de código abierto y utilizar plataformas como OpenSauced. + +5. **La salsa secreta** Este capítulo se centra en proporcionar estrategias y consejos menos conocidos para lograr un impacto duradero en la comunidad de código abierto. Este capítulo proporciona estrategias para encontrar problemas, ganar impulso en su viaje hacia el código abierto y aprovechar OpenSauced para crear su currículum de código abierto. + +## Informaciones complementarias + +Este es el comienzo de su viaje hacia el código abierto, por lo que le brindamos algunos recursos adicionales para ayudarlo a comenzar: +- [Glosario](10-glosario.md): Un glosario de términos y definiciones comúnmente utilizados en el campo del código abierto. +- [Recursos adicionales](08-recursos-adicionales.md): una lista de recursos adicionales para aprender más sobre el código abierto, incluidas publicaciones de blog, tutoriales y guías. + +## Para comenzar + +Para comenzar el curso, simplemente navegue hasta el [`archivo intro`](01-introduccion.md) en el repositorio o visite [Introducción al código abierto con el sitio web OpenSauced](https://intro.opensauced.pizza/) y comience a leer. 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 de código abierto o crear tu propio proyecto desde cero. + +## Construyendo su currículum de código abierto + +Una de las características únicas de este curso es que proporciona orientación sobre cómo crear su CV de código abierto utilizando OpenSauced. OpenSauced es una plataforma que le ayuda a realizar un seguimiento y mostrar sus contribuciones de código abierto, 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 código abierto, consulte la sección [Construyendo su currículum de código abierto](06-la-salsa-secreta.md#construyendo-su-currículum-de-código-abierto) en el capítulo [La salsa secreta](06-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! + +--- + +🤝 ¿Interesado en contribuir 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 [la Guía de contribución](https://docs.opensauced.pizza/contributing/introduction-to-contributing/) para obtener pautas sobre cómo proceder con su contribución. + +[![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 From 405e734e64adfa4471e8236fd4cef4faf87d5dc1 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 9 Feb 2024 21:20:17 +0000 Subject: [PATCH 22/76] docs: UPDATE README with spanish link --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 42b214d0..a16ac6c1 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,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. Click on the links below to take this course in the following languages: - [French](./translations/fr/README.md) +- [Spanish](./translations/es/README.md) ## Course Overview From 291d9009c2b494b3affbd890490056b2262d9d08 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 9 Feb 2024 21:23:27 +0000 Subject: [PATCH 23/76] feat: add spanish translation --- _layouts/navbar.md | 1 + 1 file changed, 1 insertion(+) diff --git a/_layouts/navbar.md b/_layouts/navbar.md index f14c4c2d..5856fad4 100644 --- a/_layouts/navbar.md +++ b/_layouts/navbar.md @@ -3,3 +3,4 @@ - Languages - [:us: English ](/) - [:fr: French ](/translations/fr/) + - [:es: Spanish ](/translations/es/) From 579deeb64d9f9d3898e7b278f36f49522c9188de Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 9 Feb 2024 21:39:39 +0000 Subject: [PATCH 24/76] feat: add spanish navbaar --- translations/es/_layouts/navbar.md | 6 ++++++ 1 file changed, 6 insertions(+) create mode 100644 translations/es/_layouts/navbar.md diff --git a/translations/es/_layouts/navbar.md b/translations/es/_layouts/navbar.md new file mode 100644 index 00000000..551638af --- /dev/null +++ b/translations/es/_layouts/navbar.md @@ -0,0 +1,6 @@ +- [Página de inicio](/) +- [⭐ Repositorio Estrella](https://github.com/open-sauced/intro) +- Idiomas + - [:us: Inglés ](/) + - [:fr: Francés ](/translations/fr/) + - [:es: Español ](/translations/es/) \ No newline at end of file From 0f100466bbe9cda25c27316d043f97364da028d3 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 9 Feb 2024 21:40:07 +0000 Subject: [PATCH 25/76] feat: add spanish sidebar --- translations/es/_layouts/sidebar.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 translations/es/_layouts/sidebar.md diff --git a/translations/es/_layouts/sidebar.md b/translations/es/_layouts/sidebar.md new file mode 100644 index 00000000..53f8bd18 --- /dev/null +++ b/translations/es/_layouts/sidebar.md @@ -0,0 +1,11 @@ +- Páginas + - [Introducción](/translations/es/01-introduccion.md) + - [¿Qué es código abierto?](/translations/es/02-que-es-codigo-abierto.md) + - [¿Por qué código abierto?](/translations/es/03-por-que-codigo-abierto.md) + - [Herramientas para tener éxito](/translations/es/04-herramientas-para-tener-exito.md) + - [Cómo contribuir a código abierto](/translations/es/05-como-contribuir-a-codigo-abierto.md) + - [La Salsa Secreta](/translations/es/06-la-salsa-secreta.md) + - [Tipos de contribuciones](/translations/es/07-tipos-de-contribuciones.md) + - [Recursos adicionales](/translations/es/08-recursos-adicionales.md) + - [Conclusión](/translations/es/09-conclusion.md) + - [Glosario](/translations/es/10-glosario.md) \ No newline at end of file From aa33d80b62219f993dab2daf4a31bd2a62412416 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 12 Feb 2024 20:17:07 +0000 Subject: [PATCH 26/76] Removed files: 02-que-es-codigo abierto 03-por-que-codigo-abierto 05-como-contribuir-a-codigo-abierto --- .../{02-que-es-codigo-abierto.md => 02-que-es-open-source.md} | 0 .../{03-por-que-codigo-abierto.md => 03-por-que-open-source.md} | 0 ...a-codigo-abierto.md => 05-como-contribuir-al-open-source.md} | 2 +- 3 files changed, 1 insertion(+), 1 deletion(-) rename translations/es/{02-que-es-codigo-abierto.md => 02-que-es-open-source.md} (100%) rename translations/es/{03-por-que-codigo-abierto.md => 03-por-que-open-source.md} (100%) rename translations/es/{05-como-contribuir-a-codigo-abierto.md => 05-como-contribuir-al-open-source.md} (99%) diff --git a/translations/es/02-que-es-codigo-abierto.md b/translations/es/02-que-es-open-source.md similarity index 100% rename from translations/es/02-que-es-codigo-abierto.md rename to translations/es/02-que-es-open-source.md diff --git a/translations/es/03-por-que-codigo-abierto.md b/translations/es/03-por-que-open-source.md similarity index 100% rename from translations/es/03-por-que-codigo-abierto.md rename to translations/es/03-por-que-open-source.md diff --git a/translations/es/05-como-contribuir-a-codigo-abierto.md b/translations/es/05-como-contribuir-al-open-source.md similarity index 99% rename from translations/es/05-como-contribuir-a-codigo-abierto.md rename to translations/es/05-como-contribuir-al-open-source.md index 973af58e..4c621284 100644 --- a/translations/es/05-como-contribuir-a-codigo-abierto.md +++ b/translations/es/05-como-contribuir-al-open-source.md @@ -1,4 +1,4 @@ -# Cómo contribuir a código abierto +# Cómo contribuir al código abierto En este capítulo, lo guiaremos a través del proceso de contribución a proyectos de código abierto. From 8ea78a93d946ddf9b395aa6445e678db08d1885e Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 12 Feb 2024 20:21:40 +0000 Subject: [PATCH 27/76] =?UTF-8?q?fix:=20sidebar:=20turn=20c=C3=B3digo=20ab?= =?UTF-8?q?ierto=20back=20to=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- translations/es/_layouts/sidebar.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/translations/es/_layouts/sidebar.md b/translations/es/_layouts/sidebar.md index 53f8bd18..75f70939 100644 --- a/translations/es/_layouts/sidebar.md +++ b/translations/es/_layouts/sidebar.md @@ -1,9 +1,9 @@ - Páginas - [Introducción](/translations/es/01-introduccion.md) - - [¿Qué es código abierto?](/translations/es/02-que-es-codigo-abierto.md) - - [¿Por qué código abierto?](/translations/es/03-por-que-codigo-abierto.md) + - [¿Qué es Open Source?](/translations/es/02-que-es-open-source.md) + - [¿Por qué Open Source?](/translations/es/03-por-que-open-source.md) - [Herramientas para tener éxito](/translations/es/04-herramientas-para-tener-exito.md) - - [Cómo contribuir a código abierto](/translations/es/05-como-contribuir-a-codigo-abierto.md) + - [Cómo contribuir al Open Source](/translations/es/05-como-contribuir-al-open-source.md) - [La Salsa Secreta](/translations/es/06-la-salsa-secreta.md) - [Tipos de contribuciones](/translations/es/07-tipos-de-contribuciones.md) - [Recursos adicionales](/translations/es/08-recursos-adicionales.md) From 6e56ade531261275545ad95c86ab7ee5ff45bf72 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 12 Feb 2024 20:48:17 +0000 Subject: [PATCH 28/76] =?UTF-8?q?fix:=20chapter=2001=20turn=20c=C3=B3digo?= =?UTF-8?q?=20abierto=20back=20into=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- translations/es/01-introduccion.md | 50 +++++++++++++++--------------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/translations/es/01-introduccion.md b/translations/es/01-introduccion.md index 5f9a7a94..5b4f54f7 100644 --- a/translations/es/01-introduccion.md +++ b/translations/es/01-introduccion.md @@ -1,10 +1,10 @@ # Introducción -¡Bienvenido al curso "Introducción al código abierto"! Este curso integral lo guiará a través del fascinante mundo del código abierto 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 de código abierto, así como también cómo desarrollar su currículum de código abierto. Pero primero, preparemos el escenario analizando los requisitos previos, los objetivos y las expectativas de este curso. +¡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 código abierto, 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. +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. @@ -12,46 +12,46 @@ Además, este curso supone que está familiarizado con Git y GitHub. Git es un s A lo largo de este curso, nuestros objetivos principales son ayudarlo a: -1. **Comprender el código abierto y sus beneficios**: exploraremos el concepto de código abierto, su historia y las numerosas ventajas de contribuir a proyectos de código abierto. -2. **Aprenda a encontrar proyectos de código abierto**: Descubrir proyectos que se alineen con sus intereses y habilidades es crucial para una experiencia gratificante de código abierto. 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 código abierto, 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 de código abierto. -5. **Desarrolla tu currículum de código abierto**: mostrar tus contribuciones de código abierto 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 código abierto. +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 de código abierto. 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. +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 código abierto 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 de código abierto, más aprenderá y crecerá como desarrollador. +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 de código abierto 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. +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 código abierto 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 de código abierto y lo ayudará a crecer como desarrollador. +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 código abierto 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. +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 de código abierto. 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 código abierto y lograr el éxito en sus contribuciones. +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 de código abierto: +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: -1. **Introducción:** Comenzaremos preparando el escenario para su viaje hacia el código abierto, analizando los requisitos previos, los objetivos y las expectativas. -1. **¿Qué es el código abierto?:** En este capítulo, exploraremos la definición de código abierto y su historia, brindándole una base sólida para comprender el contexto de la colaboración de código abierto. -1. **¿Por qué el código abierto?:** Profundizaremos en los beneficios del código abierto, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. -1. **Herramientas para tener éxito:** Este capítulo le presentará las herramientas esenciales para una colaboración exitosa de código abierto, incluidos GitHub, Git, CodeSee, VS Code y Discord. -1. **Cómo contribuir al código abierto:** 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. -1. **La salsa secreta:** Este capítulo revelará las estrategias y técnicas para comenzar, ganar terreno en sus contribuciones y desarrollar su currículum de código abierto. -1. **Conclusión:** Concluiremos el curso con conclusiones clave y discutiremos los próximos pasos en su viaje hacia el código abierto. +1. **Introducción:** Comenzaremos preparando el escenario para su viaje hacia el Open Source, analizando los requisitos previos, los objetivos y las expectativas. +1. **¿Qué es Open Source?:** 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. +1. **¿Por qué Open Source?:** Profundizaremos en los beneficios del Open Source, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. +1. **Herramientas para tener éxito:** Este capítulo le presentará las herramientas esenciales para una colaboración exitosa en Open Source, incluidos GitHub, Git, CodeSee, VS Code y Discord. +1. **Cómo contribuir al Open Source:** 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. +1. **La salsa secreta:** Este capítulo revelará las estrategias y técnicas para comenzar, ganar terreno en sus contribuciones y desarrollar su currículum de Open Source. +1. **Conclusión:** 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 de código abierto del mundo real, como [OpenSauced](https://opensauced.pizza/), para demostrar cómo aplicar las habilidades que ha aprendido. +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 código abierto puede diferir según sus intereses, habilidades y proyectos elegidos. +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. ## LFG 🚀 -Ahora que hemos preparado el escenario, ¡es hora de embarcarse en su viaje hacia el código abierto! En el próximo capítulo, profundizaremos en la definición de código abierto y exploraremos su historia, sentando las bases para una comprensión más profunda de la colaboración de código abierto. ¡Empecemos! +Ahora que hemos preparado el escenario, ¡es hora de embarcarse en su viaje hacia el Open Source! En el próximo capítulo, 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! -[Siguiente Sección ->](02-que-es-codigo-abierto.md) +[Siguiente Sección ->](02-que-es-open-source.md) From d34f7153a5a3675d15d5f54c1754ddc1fb952064 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 12 Feb 2024 21:11:34 +0000 Subject: [PATCH 29/76] =?UTF-8?q?fix:=20chapter=2002:=20turn=20c=C3=B3digo?= =?UTF-8?q?=20abierto=20back=20into=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- translations/es/02-que-es-open-source.md | 58 ++++++++++++------------ 1 file changed, 29 insertions(+), 29 deletions(-) diff --git a/translations/es/02-que-es-open-source.md b/translations/es/02-que-es-open-source.md index 5f57dba5..396d7fd0 100644 --- a/translations/es/02-que-es-open-source.md +++ b/translations/es/02-que-es-open-source.md @@ -1,69 +1,69 @@ -# ¿Qué es código abierto? +# ¿Qué es Open Source? -En este capítulo, profundizaremos en el concepto de código abierto, su definición y su historia. Obtener una comprensión profunda del código abierto le ayudará a apreciar el contexto en el que colaborará y contribuirá. +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 código abierto 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 código abierto 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 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 de código abierto 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 de código abierto 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. +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 de código abierto +### Licencias Open Source -Para que el software se considere de código abierto, debe publicarse bajo una licencia que otorgue a los usuarios el derecho de acceder, modificar y distribuir el código fuente. Existen numerosas licencias de código abierto disponibles, cada una con su propio conjunto de términos y condiciones. Algunas licencias de código abierto populares incluyen la licencia MIT, la licencia pública general GNU (GPL) y la licencia Apache. +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 de código abierto promueven una cultura de colaboración, innovación y conocimiento compartido. +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 código abierto +## Breve historia del Open Source -La idea de compartir libremente conocimientos y recursos ha existido durante siglos, pero el movimiento de código abierto tal como lo conocemos hoy se remonta a los primeros días de la informática. +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 de código abierto. +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 código abierto pero pone un mayor énfasis en los aspectos éticos y políticos de la libertad del software. +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 de código abierto llamado Linux. Cuando se combinó con el sistema GNU, Linux formó un sistema operativo completo, gratuito y de código abierto que todavía se utiliza ampliamente en la actualidad. El éxito de Linux ayudó a popularizar el concepto de código abierto y provocó una ola de nuevos proyectos, herramientas y tecnologías. +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 de código abierto +### La iniciativa Open Source -En 1998, Christine Peterson, directora ejecutiva de Foresight, acuñó el término "software de código abierto" 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 de Código Abierto (OSI) para difundir más conciencia sobre este concepto. A partir de ahí, la OSI desarrolló la definición de código abierto, un conjunto de criterios que debe cumplir el software para ser considerado de código abierto. Estos criterios incluyen distribución gratuita, disponibilidad del código fuente, trabajos derivados e integridad de la licencia. +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 código abierto generaron un aumento del interés y la adopción tanto por parte de individuos como de organizaciones. Hoy en día, el software de código abierto se utiliza ampliamente en diversas industrias, y muchas empresas de tecnología reconocidas, como Google, IBM y Microsoft, apoyan y contribuyen activamente a proyectos de código abierto. +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 de código abierto +### El crecimiento de las comunidades Open Source -A medida que el movimiento de código abierto cobró impulso, surgieron numerosas comunidades y plataformas para facilitar la colaboración y el intercambio de conocimientos. Algunos ejemplos notables incluyen: +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 de código abierto. 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 de código abierto y cuenta con una vibrante comunidad de contribuyentes de todo el mundo. -- **GitLab**: Lanzado en 2011 como una alternativa de código abierto a GitHub, GitLab ofrece un conjunto de herramientas y características para administrar repositorios de Git, rastrear problemas y facilitar la colaboración. +- **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 de código abierto y facilitar que los desarrolladores contribuyan y colaboren en proyectos. +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 de código abierto. Muchas empresas ahora reconocen el valor del código abierto y contribuyen y apoyan activamente varios proyectos. Algunas empresas incluso han llegado a abrir el código abierto de sus propias herramientas y tecnologías internas, como TensorFlow de Google y React de Facebook. +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 de código abierto, sino que también ha ayudado a legitimar el movimiento de código abierto y fomentar una adopción más amplia. +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 código abierto +## La evolución del Open Source -El movimiento de código abierto ha recorrido un largo camino desde sus inicios. Hoy en día, el software de código abierto está en todas partes e impulsa todo, desde sitios web y aplicaciones móviles hasta inteligencia artificial y algoritmos de aprendizaje automático. +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 código abierto 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. +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 código abierto 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 de código abierto, tendrá la oportunidad de ampliar sus habilidades, construir su red y mantenerse actualizado con los últimos desarrollos en el campo. +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, exploraremos los muchos beneficios de contribuir a proyectos de código abierto y discutiremos cómo la colaboración de código abierto puede ayudarle a acceder al conocimiento, conectarse con una comunidad y desarrollar habilidades valiosas. +En el próximo capítulo, 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. -[Siguiente Sección ->](03-por-que-codigo-abierto.md) +[Siguiente Sección ->](03-por-que-open-source.md) From 5da83ae6d4c547c7438f0576881d4e86d0dccf09 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 14 Feb 2024 02:39:53 +0000 Subject: [PATCH 30/76] =?UTF-8?q?fix:=20chapter=2003:=20turn=20c=C3=B3digo?= =?UTF-8?q?=20abierto=20back=20into=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- translations/es/03-por-que-open-source.md | 46 +++++++++++------------ 1 file changed, 23 insertions(+), 23 deletions(-) diff --git a/translations/es/03-por-que-open-source.md b/translations/es/03-por-que-open-source.md index 7fe995d6..85f4d290 100644 --- a/translations/es/03-por-que-open-source.md +++ b/translations/es/03-por-que-open-source.md @@ -1,57 +1,57 @@ -# ¿Por qué código abierto? +# ¿Por qué Open Source? -En el capítulo anterior, exploramos el concepto de código abierto y su historia. Ahora, profundicemos en los beneficios de contribuir a proyectos de código abierto. Al comprender las ventajas de la colaboración de código abierto, estará mejor equipado para aprovechar las oportunidades que presenta y aprovechar al máximo su viaje por el código abierto. +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 de código abierto es la oportunidad de acceder a una gran cantidad de conocimientos y recursos. Como colaborador de código abierto, podrás: +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 de código abierto 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. +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 de código abierto 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. +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 de código abierto suele estar a la vanguardia de la innovación, con nuevos proyectos, herramientas y tecnologías que surgen constantemente. Al participar en proyectos de código abierto, puede mantenerse actualizado con los últimos desarrollos en su campo y conocer las tendencias emergentes y las mejores prácticas. +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 de código abierto 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. +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 de código abierto 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 de código abierto, puedes: +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 de código abierto 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. +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 de código abierto 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. +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 de código abierto 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. +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 de código abierto 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 de código abierto. +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 de código abierto 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 código abierto, tendrás la oportunidad de: +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 de código abierto 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. +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 de código abierto le permite crear un registro público de su trabajo, mostrando sus habilidades y experiencia a posibles empleadores. Un sólido portafolio de contribuciones de código abierto puede ayudarlo a destacarse en el mercado laboral y demostrar su compromiso con el aprendizaje continuo y el crecimiento profesional. +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 de código abierto 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. +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 de código abierto 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. +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 de código abierto, 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. +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 de código abierto también puede proporcionar otras ventajas, como por ejemplo: +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 código abierto y buscan activamente candidatos que tengan un historial comprobado de contribución a proyectos de código abierto. Al mostrar sus contribuciones de código abierto, puede aumentar sus posibilidades de conseguir el trabajo de sus sueños o avanzar en su carrera. +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 de código abierto 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. +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 de código abierto 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. +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, analizaremos las herramientas y recursos esenciales que necesitará para tener éxito en su viaje hacia el código abierto, incluidos GitHub, Git, CodeSee, 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 de código abierto. +En el siguiente capítulo, analizaremos las herramientas y recursos esenciales que necesitará para tener éxito en su viaje hacia el Open Source, incluidos GitHub, Git, CodeSee, 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. [Siguiente Sección ->](04-herramientas-para-tener-exito.md) From cd65ba2ce22c2cc89d051baab899a9aeb2d552d7 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 14 Feb 2024 02:49:45 +0000 Subject: [PATCH 31/76] =?UTF-8?q?fix:=20chapter=2004:=20turn=20c=C3=B3digo?= =?UTF-8?q?=20abierto=20back=20into=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../es/04-herramientas-para-tener-exito.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/translations/es/04-herramientas-para-tener-exito.md b/translations/es/04-herramientas-para-tener-exito.md index 3a202bf3..b734b9c2 100644 --- a/translations/es/04-herramientas-para-tener-exito.md +++ b/translations/es/04-herramientas-para-tener-exito.md @@ -1,6 +1,6 @@ # Herramientas para tener éxito -Para tener éxito en su viaje hacia el código abierto, 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 de código abierto. En este capítulo, analizaremos las siguientes herramientas esenciales para la colaboración de código abierto: +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 - CodeSee @@ -98,7 +98,7 @@ 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 de código abierto! +¡Ahora ha configurado con éxito Git y GitHub en su máquina local y está listo para colaborar en proyectos Open Source! ## CodeSee @@ -112,7 +112,7 @@ Para comenzar con CodeSee, visite el sitio web oficial (https://www.codesee.io/) ## VS Code -Visual Studio Code (VS Code) es un editor de código popular, gratuito y de código abierto 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 de código abierto, que incluyen: +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. @@ -123,15 +123,15 @@ Para descargar e instalar VS Code, visite el sitio web oficial (https://code.vis ## Discord -Discord es una popular plataforma de mensajería y chat de voz ampliamente utilizada por comunidades de código abierto para comunicación y colaboración. Al unirte a servidores de Discord relacionados con tus intereses y proyectos, podrás: +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 de código abierto 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 de código abierto. Al participar en estas discusiones, puede aprender de otros, compartir sus ideas y contribuir al conocimiento colectivo de 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 de código abierto en plataformas como GitHub, GitLab u OpenSauced para encontrar sus servidores Discord y unirse a la conversación. +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 de código abierto. En el próximo capítulo, analizaremos cómo contribuir a proyectos de código abierto, 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. +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, 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. -[Siguiente Sección ->](05-como-contribuir-a-codigo-abierto.md) +[Siguiente Sección ->](05-como-contribuir-al-open-source.md) From dfc49bbb2bf4ba19e4413f31de2d759bb7ba86bb Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 14 Feb 2024 03:06:13 +0000 Subject: [PATCH 32/76] =?UTF-8?q?fix:=20chapter=2005:=20turn=20c=C3=B3digo?= =?UTF-8?q?=20abierto=20back=20into=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../es/05-como-contribuir-al-open-source.md | 50 +++++++++---------- 1 file changed, 25 insertions(+), 25 deletions(-) diff --git a/translations/es/05-como-contribuir-al-open-source.md b/translations/es/05-como-contribuir-al-open-source.md index 4c621284..a979bc6b 100644 --- a/translations/es/05-como-contribuir-al-open-source.md +++ b/translations/es/05-como-contribuir-al-open-source.md @@ -1,22 +1,22 @@ -# Cómo contribuir al código abierto +# Cómo contribuir al Open Source -En este capítulo, lo guiaremos a través del proceso de contribución a proyectos de código abierto. +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 código abierto 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: +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 de código abierto. Puede utilizar su función de búsqueda para encontrar proyectos basados ​​en palabras clave, lenguajes de programación o temas específicos. +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 de código abierto y agradecen las contribuciones de la comunidad. +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 de código abierto**: existen numerosas comunidades, foros y plataformas de chat en línea dedicados al desarrollo de código abierto. 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 "primeros buenos números", proyectos interesantes de GitHub y problemas que tenemos abiertos en nuestros repositorios. +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 "primeros buenos números", 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 de código abierto. Al utilizar OpenSauced, puede encontrar proyectos que se alineen con sus intereses, habilidades y objetivos. +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 código abierto con OpenSauced +### Descubriendo el Open Source con OpenSauced -OpenSauced es una poderosa herramienta para encontrar proyectos de código abierto en los que contribuir. Para comenzar con OpenSauced, siga estos pasos: +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. @@ -34,11 +34,11 @@ OpenSauced es una poderosa herramienta para encontrar proyectos de código abier 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 de código abierto en los que trabajar y concentrarse en contribuir a los proyectos que se alinean con sus intereses y objetivos. +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 de código abierto, es importante familiarizarse con las pautas, convenciones y flujo de trabajo del proyecto y tomar la iniciativa de incorporarse. +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: @@ -46,11 +46,11 @@ A continuación se ofrecen algunos consejos que le ayudarán a incorporarse con 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 de código abierto 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. +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 de código abierto generalmente son solidarias y acogedoras; Otros contribuyentes estarán encantados de ayudarle. +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 de código abierto. 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. +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 @@ -80,7 +80,7 @@ Una vez que un mantenedor le haya asignado un problema, el siguiente paso es tra 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, crea una nueva rama en tu repositorio local para trabajar en tu contribución. Crear una nueva rama es la mejor práctica en código abierto porque mantiene los cambios separados de la rama "principal". +3. **Crea una nueva rama**: antes de realizar cualquier cambio, crea una nueva rama en tu repositorio local para trabajar en tu contribución. Crear una nueva rama es la mejor práctica en Open Source porque mantiene los cambios separados de la rama "principal". Puede crear una nueva rama usando el siguiente comando: @@ -113,14 +113,14 @@ Una vez que un mantenedor le haya asignado un problema, el siguiente paso es tra 8. **Responder a los comentarios**: 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 de código abierto y colaborar con otros desarrolladores para mejorar el código base. +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 de código abierto. + ¡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. @@ -128,7 +128,7 @@ Una vez enviada y revisada su contribución, puede ocurrir uno de los siguientes ## Seamos prácticos -Ahora que sabes cómo encontrar y contribuir a proyectos de código abierto, 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). +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 @@ -200,9 +200,9 @@ Necesitará tener estas herramientas descargadas e instaladas en su máquina loc "avatar_url": "https://avatars.githubusercontent.com/u/xxxxxxxx?v=x", "profile": "URL link", "contributions": [ - "pregunta", - "Blog", - "código" + "question", + "blog", + "code" ] } ``` @@ -274,7 +274,7 @@ Luego, extraiga los últimos cambios en la rama `main` en el repositorio `origin ## Fusionar conflictos -Los conflictos de fusión son algo que encontrarás comúnmente al contribuir a un proyecto de código abierto. 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. +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`. @@ -282,9 +282,9 @@ Debes prestar atención a los conflictos y decidir cómo quieres resolverlos. Pu ### Consejos para evitar resolver conflictos de fusión repetidamente -Algunos repositorios de código abierto, como los repositorios [libro de visitas](https://github.com/open-sauced/guestbook) y [pizza verse](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. +Algunos repositorios Open Source, como los repositorios [libro de visitas](https://github.com/open-sauced/guestbook) y [pizza verse](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 de código abierto: +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 @@ -348,6 +348,6 @@ Antes de resolver conflictos de fusión, primero debe [actualizar sus ramas](#ac
-A medida que continúe contribuyendo a proyectos de código abierto, obtendrá experiencia valiosa, desarrollará nuevas habilidades y creará un sólido portafolio de trabajo. En el próximo capítulo, analizaremos algunas estrategias para comenzar con las contribuciones de código abierto, ganar terreno en sus contribuciones y desarrollar su currículum de código abierto utilizando OpenSauced. +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, 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. [Siguiente Sección ->](06-la-salsa-secreta.md) From 3e89c0b9ac3f8c66848d66052ada1204f09fa525 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 14 Feb 2024 03:15:28 +0000 Subject: [PATCH 33/76] =?UTF-8?q?fix:=20chapter=2006:=20turn=20c=C3=B3digo?= =?UTF-8?q?=20abierto=20back=20into=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- translations/es/06-la-salsa-secreta.md | 30 +++++++++++++------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/translations/es/06-la-salsa-secreta.md b/translations/es/06-la-salsa-secreta.md index ead24475..4db95f2d 100644 --- a/translations/es/06-la-salsa-secreta.md +++ b/translations/es/06-la-salsa-secreta.md @@ -1,14 +1,14 @@ # La Salsa Secreta -En este capítulo, compartiremos algunas estrategias y consejos menos conocidos para lograr un impacto duradero en la comunidad de código abierto. Discutiremos cómo centrarse en problemas abiertos, obtener tracción en sus contribuciones y desarrollar su currículum de código abierto utilizando OpenSauced. +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 de código abierto, 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. +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 de código abierto 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. +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 "primer buen número" 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. @@ -18,33 +18,33 @@ A continuación se ofrecen algunos consejos para encontrar y abordar problemas 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 de código abierto. +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 de código abierto, 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: +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 código abierto 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 de código abierto. +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 de código abierto. +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 de código abierto, considere asesorar a nuevos contribuyentes que recién estén comenzando su recorrido por el código abierto. Esto puede ayudarle a contribuir a la comunidad, desarrollar sus habilidades de liderazgo y construir una reputación positiva. +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 código abierto +## Construyendo su currículum de Open Source -Crear un currículum sólido de código abierto 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 de código abierto y desarrollar su currículum de código abierto. Veamos cómo puede utilizar OpenSauced para respaldar su viaje hacia el código abierto. +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 de código abierto. Puede navegar hasta él haciendo clic en su nombre de usuario en la esquina superior derecha de la página. +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](../../images/opensauced-profile.png) -3. **Cree su currículum de código abierto**: 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 código abierto. 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. +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. @@ -70,10 +70,10 @@ Para ser más eficaz a la hora de destacar sus contribuciones, le recomendamos u ![Agregar un resaltado a tu perfil](../../images/opensauced-highlights.png) -**¡Compártelo!**: Una vez que hayas creado un currículum de contribuciones de código abierto, 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 de código abierto. +**¡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 de código abierto y desarrollar su currículum, estará mejor equipado para mostrar sus habilidades, experiencia e impacto en la comunidad de código abierto. +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. -En conclusión, comenzar con contribuciones de código abierto 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 código abierto. +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. [Sección Final ->](07-tipos-de-contribuciones.md) From 60c5516a88e9631c1b584a0dadfc58f84ce84907 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 14 Feb 2024 04:11:09 +0000 Subject: [PATCH 34/76] =?UTF-8?q?fix:=20chapter=2007:=20turn=20c=C3=B3digo?= =?UTF-8?q?=20abierto=20back=20into=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- translations/es/07-tipos-de-contribuciones.md | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/translations/es/07-tipos-de-contribuciones.md b/translations/es/07-tipos-de-contribuciones.md index 461938be..e1329f76 100644 --- a/translations/es/07-tipos-de-contribuciones.md +++ b/translations/es/07-tipos-de-contribuciones.md @@ -1,12 +1,12 @@ # Tipos de contribuciones -En este capítulo, discutiremos los tipos de contribuciones de codificación y no codificación involucradas en proyectos de código abierto. +En este capítulo, discutiremos los tipos de contribuciones de codificación y no codificación involucradas en proyectos Open Source. ## Tipo de 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 de código abierto. Permiten que personas con una variedad de habilidades y antecedentes participen y hagan contribuciones significativas al software y a la comunidad. + 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. Permiten que personas con una variedad de habilidades y antecedentes participen y hagan contribuciones significativas al software y a la comunidad. -> [Cómo contribuir al código abierto 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 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) **Tipos comunes de contribuciones no codificadas** @@ -18,7 +18,7 @@ En este capítulo, discutiremos los tipos de contribuciones de codificación y 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! -Esto implica crear, mejorar o mantener los recursos escritos que acompañan a los proyectos de software de código abierto. La documentación es crucial para los proyectos de código abierto. 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. +Esto implica crear, mejorar o mantener los recursos escritos que acompañan a los proyectos de software Open Source. La documentación es crucial para los proyectos Open Source. 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. #### Cómo contribuir a la documentación @@ -50,16 +50,16 @@ Esto implica crear, mejorar o mantener los recursos escritos que acompañan a lo - Agregue la información que falta a la documentación: [Agregue más información para usar esta plantilla en el README](https://github.com/open-sauced/100-days-of-oss-template/pull/8) -Contribuir a la documentación es una excelente manera de ayudar a los proyectos de código abierto y hacerlos más accesibles para todos. Si tienes las habilidades y el interés, ¡participa! +Contribuir a la documentación es una excelente manera de ayudar a los proyectos Open Source y hacerlos más accesibles para todos. Si tienes las habilidades y el interés, ¡participa! ### Diseño gráfico -Esta contribución de código abierto implica la creación de activos visuales, como logotipos, íconos, ilustraciones, diseños de sitios web y otros elementos gráficos, para proyectos de código abierto. 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 de código abierto sea más atractivo, fácil de usar y reconocible. - - **Logotipo y marca**: Diseñar un logotipo único y memorable para un proyecto de código abierto 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. +Esta contribución al Open Source implica la creación de activos visuales, como logotipos, íconos, ilustraciones, diseños de sitios web y otros elementos gráficos, para proyectos Open Source. 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. Los diseñadores gráficos pueden crear íconos personalizados para aplicaciones de software o sitios web, mejorando el atractivo visual y la usabilidad del proyecto: [registro en Eventhub](https://github.com/WebXGuild/webx-guild/pull/13) - - **Diseño de sitios web**: los proyectos de código abierto suelen tener sitios web para proporcionar información, documentación y enlaces de descarga. Los diseñadores gráficos pueden 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 sitios web**: los proyectos Open Source suelen tener sitios web para proporcionar información, documentación y enlaces de descarga. Los diseñadores gráficos pueden 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. Los diseñadores pueden crear maquetas, bocetos y diseños de alta fidelidad para la interfaz de usuario, haciéndola más intuitiva y visualmente atractiva. @@ -71,25 +71,25 @@ Esta contribución de código abierto implica la creación de activos visuales, ### Escritura de blogs -Este tipo de contribución de código abierto implica la creación y publicación de blogs, artículos o tutoriales relacionados con software, proyectos, tecnologías o mejores prácticas de código abierto. Al igual que la documentación, no necesariamente es necesario saber codificar para escribir estas publicaciones. +Este tipo de contribución al Open Source implica la creación y publicación de blogs, artículos o tutoriales relacionados con software, proyectos, tecnologías o mejores prácticas del Open Source. Al igual que la documentación, no necesariamente es necesario saber codificar para escribir estas publicaciones. -#### Formas de utilizar los blogs como contribución de código abierto +#### Formas de utilizar los blogs como contribución al Open Source -- Puede escribir sobre las últimas funciones de un proyecto de código abierto, como una nueva versión del software o un nuevo complemento: [Anuncio de la versión 0.2.0 de Analog](https://dev.to/analogjs/announcing-the-020-release-of-analog-aa1) +- Puede escribir sobre las últimas funciones de un proyecto Open Source, como una nueva versión del software o un nuevo complemento: [Anuncio de la versión 0.2.0 de Analog](https://dev.to/analogjs/announcing-the-020-release-of-analog-aa1) - Puedes escribir un tutorial sobre cómo instalar y configurar el software: [Cómo hacer una deliciosa guía de contribución](https://dev.to/opensauced/how-to-make-a-delicious-contributing-guide-4bp3 ) -- Escriba sobre el impacto de un proyecto de código abierto, como por ejemplo cómo se ha utilizado para marcar la diferencia en el mundo: [Reteniendo a los mejores ingenieros](https://opensauced.pizza/blog/retaining-the-best-engineers ) +- Escriba sobre el impacto de un proyecto Open Source, como por ejemplo cómo se ha utilizado para marcar la diferencia en el mundo: [Reteniendo a los mejores ingenieros](https://opensauced.pizza/blog/retaining-the-best-engineers ) -- Tipos de contribuciones codificadas y no codificadas, como cómo comenzar con el código abierto: [Código abierto 101: una guía para principiantes para comenzar](https://opensauced.pizza/blog/open-source-101-a-beginner's-guide-to-getting-started) +- Tipos de contribuciones codificadas y no codificadas, como cómo comenzar con el Open Source: [Open Source 101: una guía para principiantes para comenzar](https://opensauced.pizza/blog/open-source-101-a-beginner's-guide-to-getting-started) ## Tipos de contribuciones de codificación -Las contribuciones de codificación impulsan el desarrollo de código abierto. Implican escribir, modificar o mejorar el código fuente real de un proyecto de código abierto, 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 de código abierto suelen tener pautas y procesos para aceptar e integrar contribuciones de codificación, como revisiones de código e integración continua. +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 código nuevo**: este es el tipo más común de contribución de codificación. Los desarrolladores escriben código nuevo para agregar funciones, corregir errores o mejorar la funcionalidad de un proyecto de código abierto. Estas contribuciones generalmente se envían en forma de solicitudes de extracción (PR) o parches: [Mostrar quién reaccionó a los momentos destacados](https://github.com/open-sauced/app/pull/1591) +- **Escribir código nuevo**: este es el tipo más común de contribución de codificación. Los desarrolladores escriben código nuevo para agregar funciones, corregir errores o mejorar la funcionalidad de un proyecto Open Source. Estas contribuciones generalmente se envían en forma de solicitudes de extracción (PR) o parches: [Mostrar quién reaccionó a los momentos destacados](https://github.com/open-sauced/app/pull/1591) - **Corrección de errores**: identificar y corregir errores es una contribución fundamental a la codificación. Los desarrolladores localizan problemas dentro del código base, los diagnostican y luego escriben código para corregirlos. Las correcciones de errores mejoran la estabilidad y confiabilidad del software: [La verificación de pelusa ocurre dos veces al confirmar ](https://github.com/open-sauced/app/pull/1635) From 0b0a74c81327b2508db84cf86da689bc61212860 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 14 Feb 2024 04:18:49 +0000 Subject: [PATCH 35/76] =?UTF-8?q?fix:=20chapter=2008:=20turn=20c=C3=B3digo?= =?UTF-8?q?=20abierto=20back=20into=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- translations/es/08-recursos-adicionales.md | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/translations/es/08-recursos-adicionales.md b/translations/es/08-recursos-adicionales.md index 372fee74..9ba48f5b 100644 --- a/translations/es/08-recursos-adicionales.md +++ b/translations/es/08-recursos-adicionales.md @@ -1,23 +1,23 @@ -¡Felicitaciones por su viaje hacia el código abierto! Aquí hay algunos recursos para aprender más sobre cómo comenzar con el código abierto: +¡Felicitaciones por su viaje hacia el Open Source! Aquí hay algunos recursos para aprender más sobre cómo comenzar con el Open Source: ## Guías y tutoriales -- [Guías de código abierto](https://opensource.guide/) de GitHub: guías completas sobre diversos aspectos del código abierto, incluidos cómo empezar, contribuir, mantener proyectos y crear comunidades. +- [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 de código abierto. +- [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 de código abierto](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 de código abierto, incluyendo su historia, licencias y modelos de desarrollo. +- [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 código abierto (OSSN) de Mozilla](https://community.mozilla.org/en/): proporciona recursos y apoyo para estudiantes interesados ​​en el código abierto, incluidas guías, eventos y oportunidades de tutoría. +- [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 de código abierto](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 de código abierto, incluido cómo encontrar proyectos en los que contribuir, comprender el código base y enviar contribuciones. +- [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 código abierto](https://opensourcefriday.com/) de GitHub: un movimiento global que anima a individuos y organizaciones a contribuir al código abierto todos los viernes. El sitio web proporciona recursos y guías sobre cómo iniciarse en el código abierto y encontrar proyectos en los que contribuir. +- [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 de código abierto pueden ayudarlo a hacerse notar](https://dev.to/opensauced/beyond-content-creation-how-open-source-contributions-can-help-you-get-noticed-4l5n) +- [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 código abierto 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 número: consejos para una comunicación eficaz en código abierto](https://dev.to/opensauced/how-to-write-a-good-issue-tips-for-effective-communication-in-open-source-5443) -- [Los primeros números buenos no existen](https://opensauced.pizza/blog/good-first-issues-dont-exist) +- [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 número: 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 números no existen](https://opensauced.pizza/blog/good-first-issues-dont-exist) [Siguiente Sección ->](09-conclusion.md) From 9b6ab270e9fe6a863f7f04ac3b2598e9ec358b46 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 14 Feb 2024 04:26:25 +0000 Subject: [PATCH 36/76] =?UTF-8?q?fix:=20chapter09:=20turn=20c=C3=B3digo=20?= =?UTF-8?q?abierto=20back=20into=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- translations/es/09-conclusion.md | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/translations/es/09-conclusion.md b/translations/es/09-conclusion.md index c1e156a6..a1afbff4 100644 --- a/translations/es/09-conclusion.md +++ b/translations/es/09-conclusion.md @@ -1,41 +1,41 @@ # Conclusión -Mientras concluimos este curso sobre cómo comenzar con el código abierto, recapitulemos los puntos clave y analicemos lo que sigue en su viaje hacia el código abierto. +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 código abierto: +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: -1. **¿Qué es código abierto?**: Discutimos la definición de código abierto, su historia y los principios básicos que guían el movimiento del código abierto. +1. **¿Qué es Open Source?**: Discutimos la definición de Open Source, su historia y los principios básicos que guían el movimiento del Open Source. -2. **¿Por qué código abierto?**: Exploramos los beneficios de participar en proyectos de código abierto, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. +2. **¿Por qué Open Source?**: Exploramos los beneficios de participar en proyectos Open Source, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. -3. **Herramientas para tener éxito**: presentamos herramientas y plataformas esenciales para contribuyentes de código abierto, como GitHub, Git, CodeSee, Visual Studio Code y Discord. +3. **Herramientas para tener éxito**: presentamos herramientas y plataformas esenciales para contribuyentes del Open Source, como GitHub, Git, CodeSee, Visual Studio Code y Discord. -4. **Cómo contribuir a código abierto**: 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. +4. **Cómo 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. -5. **La salsa secreta**: compartimos estrategias para comenzar con las contribuciones de código abierto, ganar terreno en sus contribuciones y desarrollar su currículum de código abierto utilizando OpenSauced. +5. **La salsa secreta**: 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. -Al comprender estos conceptos y aplicar las estrategias que hemos analizado, estará bien equipado para embarcarse en un viaje exitoso hacia el código abierto. +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 código abierto y comenzar a realizar contribuciones significativas. Estos son algunos de los próximos pasos que le ayudarán a continuar su viaje hacia el código abierto: +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 de código abierto, 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. +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 de código abierto que se alineen con sus intereses y habilidades. Busque proyectos con comunidades activas, documentación clara y pautas de contribución bien definidas. +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 de código abierto**: ú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. +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 código abierto para aprender de otros, establecer contactos con otros desarrolladores y mantenerse actualizado sobre las últimas tendencias y mejores prácticas en el mundo del código abierto. . +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 código abierto 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 de código abierto. +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 código abierto 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 de código abierto. Hemos incluido una [sección de recursos adicionales](08-recursos-adicionales.md) para obtener más información. +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](08-recursos-adicionales.md) para obtener más información. -En conclusión, embarcarse en un viaje hacia el código abierto 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 código abierto. Así que adelante y comienza a contribuir: ¡la comunidad de código abierto espera ansiosamente tu participació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! [Siguiente sección ->](10-glosario.md) From 45056d7f9f9382aab7a31bbdc58d17573807ea7b Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 14 Feb 2024 04:31:17 +0000 Subject: [PATCH 37/76] =?UTF-8?q?fix:=20chapter=2010:=20turn=20c=C3=B3digo?= =?UTF-8?q?=20abierto=20back=20into=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- translations/es/10-glosario.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/translations/es/10-glosario.md b/translations/es/10-glosario.md index d319b06d..16a37148 100644 --- a/translations/es/10-glosario.md +++ b/translations/es/10-glosario.md @@ -1,6 +1,6 @@ ## Aseguramiento de la calidad -El aseguramiento de la calidad en proyectos de código abierto 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. +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 @@ -8,7 +8,7 @@ Una bifurcación es una copia de un repositorio. Cuando bifurcas un repositorio, ## 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 de código abierto a menudo dependen de las contribuciones de la comunidad para identificar y rectificar estos errores. +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 @@ -16,7 +16,7 @@ La clonación es el proceso utilizado para copiar un repositorio Git existente e ## Colaborador -Un colaborador es cualquier persona que realiza cambios, adiciones o sugerencias a un proyecto de código abierto. Los contribuyentes pueden ser desarrolladores, diseñadores, escritores, evaluadores o cualquier otra persona que ayude a mejorar el proyecto. +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. ## Documentos @@ -37,7 +37,7 @@ Una guía de estilo es un conjunto de reglas y convenciones que definen el forma ## Mantenedor -Un mantenedor es una persona o un grupo de personas responsables de mantener un proyecto de código abierto 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. +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 @@ -45,7 +45,7 @@ Markdown es un lenguaje de marcado ligero que se utiliza habitualmente para crea ## Miembro principal -Un miembro principal es un colaborador al que se le han otorgado privilegios o responsabilidades adicionales dentro de un proyecto de código abierto. Los miembros principales suelen ser colaboradores confiables que han demostrado un profundo conocimiento del proyecto y han realizado contribuciones significativas a su desarrollo. +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 @@ -57,7 +57,7 @@ Un problema es un problema o error que debe abordarse en el código. Cualquiera ## Proyectos OSS -OSS significa proyectos de "software de código abierto". 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. +Proyectos OSS significa proyectos de "software Open Source". 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 @@ -65,7 +65,7 @@ Una rama es una versión independiente del código que se crea con fines de desa ## Repositorio -Un repositorio es una ubicación central donde se almacena y administra el código. En el código abierto, 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. +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 From c009e02b9c1a1cf87f87ccebb66c3e5e362ac031 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 14 Feb 2024 04:47:36 +0000 Subject: [PATCH 38/76] =?UTF-8?q?docs:=20fix=20README:=20turn=20c=C3=B3dig?= =?UTF-8?q?o=20abierto=20back=20into=20Open=20Source?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- translations/es/README.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/translations/es/README.md b/translations/es/README.md index 1dff2907..085b1f3c 100644 --- a/translations/es/README.md +++ b/translations/es/README.md @@ -1,49 +1,49 @@

Salsa abierta -

🍕 Introducción al código abierto con OpenSauced 🍕

- El sitio proporciona materiales del curso de Introducción al código abierto de OpenSauced. +

🍕 Introducción al Open Source con OpenSauced 🍕

+ El sitio proporciona materiales del curso de Introducción al Open Source de OpenSauced.

-¡Bienvenido al curso de Introducción al Código Abierto con OpenSauced! Este curso está diseñado para brindarle una introducción al código abierto y guiarlo a través del proceso de contribución a proyectos de código abierto. +¡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 idioma -Al igual que la pizza, el código abierto debe compartirse con todos. Haga clic en los enlaces a continuación para seguir este curso en los siguientes idiomas diferentes. +Al igual que la pizza, el Open Source debe compartirse con todos. Haga clic en los enlaces a continuación para seguir este curso en los siguientes idiomas diferentes. - [Inglés](/README.md) - [Francés](/translations/fr/README.md) ## Resumen del curso -El curso está dividido en cinco capítulos, cada uno de los cuales cubre un aspecto diferente del código abierto: +El curso está dividido en cinco capítulos, cada uno de los cuales cubre un aspecto diferente del Open Source: -1. **¿Qué es código abierto?** Este capítulo proporciona una introducción al código abierto, su historia y su importancia en el panorama actual del desarrollo de software. +1. **¿Qué es Open Source?** Este capítulo proporciona una introducción al Open Source, su historia y su importancia en el panorama actual del desarrollo de software. -2. **¿Por qué código abierto?** En este capítulo, conocerá los beneficios del software de código abierto, como una mayor colaboración, un desarrollo más rápido y una mejor calidad. +2. **¿Por qué Open Source?** En este capítulo, conocerá los beneficios del software Open Source, como una mayor colaboración, un desarrollo más rápido y una mejor calidad. -3. **Herramientas para tener éxito.** Descubra las herramientas y plataformas clave necesarias para un viaje exitoso en el desarrollo de código abierto. Desde Git y GitHub para control de versiones y colaboración hasta CodeSee para visualización de código y VS Code como editor de código, este capítulo proporciona una descripción general de cómo aprovechar estas herramientas esenciales. +3. **Herramientas para tener éxito.** 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 hasta CodeSee para visualización de código y VS Code como editor de código, este capítulo proporciona una descripción general de cómo aprovechar estas herramientas esenciales. -4. **¿Cómo contribuir al código abierto?** Este capítulo cubre la búsqueda de proyectos en los que trabajar, el envío de contribuciones, la integración en nuevos proyectos y los resultados después de enviar las contribuciones. Los consejos para encontrar proyectos incluyen navegar por GitHub y GitLab, seguir sus intereses personales, unirse a comunidades de código abierto y utilizar plataformas como OpenSauced. +4. **¿Cómo contribuir al Open Source?** Este capítulo cubre la búsqueda de proyectos en los que trabajar, el envío de contribuciones, la integración en nuevos proyectos y los resultados después de enviar las contribuciones. Los consejos para encontrar proyectos incluyen navegar por GitHub y GitLab, seguir sus intereses personales, unirse a comunidades Open Source y utilizar plataformas como OpenSauced. -5. **La salsa secreta** Este capítulo se centra en proporcionar estrategias y consejos menos conocidos para lograr un impacto duradero en la comunidad de código abierto. Este capítulo proporciona estrategias para encontrar problemas, ganar impulso en su viaje hacia el código abierto y aprovechar OpenSauced para crear su currículum de código abierto. +5. **La salsa secreta** 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 viaje hacia el Open Source y aprovechar OpenSauced para crear su currículum de Open Source. ## Informaciones complementarias -Este es el comienzo de su viaje hacia el código abierto, por lo que le brindamos algunos recursos adicionales para ayudarlo a comenzar: -- [Glosario](10-glosario.md): Un glosario de términos y definiciones comúnmente utilizados en el campo del código abierto. -- [Recursos adicionales](08-recursos-adicionales.md): una lista de recursos adicionales para aprender más sobre el código abierto, incluidas publicaciones de blog, tutoriales y guías. +Este es el comienzo de su viaje hacia el Open Source, por lo que le brindamos algunos recursos adicionales para ayudarlo a comenzar: +- [Glosario](10-glosario.md): Un glosario de términos y definiciones comúnmente utilizados en el campo del Open Source. +- [Recursos adicionales](08-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 intro`](01-introduccion.md) en el repositorio o visite [Introducción al código abierto con el sitio web OpenSauced](https://intro.opensauced.pizza/) y comience a leer. Cada capítulo se basa en el anterior, por lo que recomendamos leerlos en orden. +Para comenzar el curso, simplemente navegue hasta el [`archivo introducción`](01-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. 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 de código abierto o crear tu propio proyecto desde cero. +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 código abierto +## 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 código abierto utilizando OpenSauced. OpenSauced es una plataforma que le ayuda a realizar un seguimiento y mostrar sus contribuciones de código abierto, lo que facilita que los posibles empleadores y colaboradores se destaquen. +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 código abierto, consulte la sección [Construyendo su currículum de código abierto](06-la-salsa-secreta.md#construyendo-su-currículum-de-código-abierto) en el capítulo [La salsa secreta](06-la-salsa-secreta.md). +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](06-la-salsa-secreta.md#construyendo-su-currículum-de-open-source) en el capítulo [La salsa secreta](06-la-salsa-secreta.md). --- From 71ef3ab1cc6227a110c6748eeb877e1ddf88e403 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 16 Feb 2024 21:19:50 -0500 Subject: [PATCH 39/76] =?UTF-8?q?fix:=20Update=20translations/es/10-glosar?= =?UTF-8?q?io.md=20back=20to=20=E2=80=9COpen=20Source=20Software=E2=80=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Christine Belzie <105683440+CBID2@users.noreply.github.com> --- translations/es/10-glosario.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/es/10-glosario.md b/translations/es/10-glosario.md index 16a37148..fccf7216 100644 --- a/translations/es/10-glosario.md +++ b/translations/es/10-glosario.md @@ -57,7 +57,7 @@ Un problema es un problema o error que debe abordarse en el código. Cualquiera ## Proyectos OSS -Proyectos OSS significa proyectos de "software Open Source". 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. +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 From 72cb9620e24d8824a0820ec6e5052b925df51f6b Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 16 Feb 2024 21:23:09 -0500 Subject: [PATCH 40/76] fix: Update chapter 07 change 'usabilidad' Co-authored-by: Mike Salcedo <107327871+Mike-Salcedo@users.noreply.github.com> --- translations/es/07-tipos-de-contribuciones.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/es/07-tipos-de-contribuciones.md b/translations/es/07-tipos-de-contribuciones.md index e1329f76..1ba13f9f 100644 --- a/translations/es/07-tipos-de-contribuciones.md +++ b/translations/es/07-tipos-de-contribuciones.md @@ -57,7 +57,7 @@ Contribuir a la documentación es una excelente manera de ayudar a los proyectos Esta contribución al Open Source implica la creación de activos visuales, como logotipos, íconos, ilustraciones, diseños de sitios web y otros elementos gráficos, para proyectos Open Source. 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. Los diseñadores gráficos pueden crear íconos personalizados para aplicaciones de software o sitios web, mejorando el atractivo visual y la usabilidad del proyecto: [registro en Eventhub](https://github.com/WebXGuild/webx-guild/pull/13) +- **Diseño de iconos**: los iconos son esenciales para las interfaces de usuario. Los diseñadores gráficos pueden crear íconos personalizados para aplicaciones de software o sitios web, mejorando el atractivo visual y la facilidad de uso del proyecto: [registro en Eventhub](https://github.com/WebXGuild/webx-guild/pull/13) - **Diseño de sitios web**: los proyectos Open Source suelen tener sitios web para proporcionar información, documentación y enlaces de descarga. Los diseñadores gráficos pueden 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. From c5ec57c46d066fe6f984eafaea92c73625e32d5b Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 16 Feb 2024 21:24:26 -0500 Subject: [PATCH 41/76] fix: Update translations/es/07-tipos-de-contribuciones.md Puede => Puedes Co-authored-by: Mike Salcedo <107327871+Mike-Salcedo@users.noreply.github.com> --- translations/es/07-tipos-de-contribuciones.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/es/07-tipos-de-contribuciones.md b/translations/es/07-tipos-de-contribuciones.md index 1ba13f9f..0012cc60 100644 --- a/translations/es/07-tipos-de-contribuciones.md +++ b/translations/es/07-tipos-de-contribuciones.md @@ -75,7 +75,7 @@ Este tipo de contribución al Open Source implica la creación y publicación de #### Formas de utilizar los blogs como contribución al Open Source -- Puede escribir sobre las últimas funciones de un proyecto Open Source, como una nueva versión del software o un nuevo complemento: [Anuncio de la versión 0.2.0 de Analog](https://dev.to/analogjs/announcing-the-020-release-of-analog-aa1) +- Puedes escribir sobre las últimas funciones de un proyecto Open Source, como una nueva versión del software o un nuevo complemento: [Anuncio de la versión 0.2.0 de Analog](https://dev.to/analogjs/announcing-the-020-release-of-analog-aa1) - Puedes escribir un tutorial sobre cómo instalar y configurar el software: [Cómo hacer una deliciosa guía de contribución](https://dev.to/opensauced/how-to-make-a-delicious-contributing-guide-4bp3 ) From a8f17079f3c1c795a53b83bf192d9732cb627478 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Fri, 16 Feb 2024 21:24:55 -0500 Subject: [PATCH 42/76] fix: Update translations/es/07-tipos-de-contribuciones.md como = > y Co-authored-by: Mike Salcedo <107327871+Mike-Salcedo@users.noreply.github.com> --- translations/es/07-tipos-de-contribuciones.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/translations/es/07-tipos-de-contribuciones.md b/translations/es/07-tipos-de-contribuciones.md index 0012cc60..a3149cc5 100644 --- a/translations/es/07-tipos-de-contribuciones.md +++ b/translations/es/07-tipos-de-contribuciones.md @@ -81,7 +81,7 @@ Este tipo de contribución al Open Source implica la creación y publicación de - Escriba sobre el impacto de un proyecto Open Source, como por ejemplo cómo se ha utilizado para marcar la diferencia en el mundo: [Reteniendo a los mejores ingenieros](https://opensauced.pizza/blog/retaining-the-best-engineers ) -- Tipos de contribuciones codificadas y no codificadas, como cómo comenzar con el Open Source: [Open Source 101: una guía para principiantes para comenzar](https://opensauced.pizza/blog/open-source-101-a-beginner's-guide-to-getting-started) +- Tipos de contribuciones codificadas y no codificadas, y cómo comenzar con el Open Source: [Open Source 101: una guía para principiantes para comenzar](https://opensauced.pizza/blog/open-source-101-a-beginner's-guide-to-getting-started) ## Tipos de contribuciones de codificación From f28e43a8e48054a2bf8109445a4260c528cdab3c Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:26:19 +0000 Subject: [PATCH 43/76] feat: added README file in spanish translation --- docs/intro-to-oss/translations/es/README.md | 86 +++++++++++++++++++++ 1 file changed, 86 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/README.md 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..4d39d946 --- /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 From 6da2a8190d7b75f3cf4ac96fddcd3aa13b70544f Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:28:40 +0000 Subject: [PATCH 44/76] feat: added CONTRIBUTING file translation --- .../translations/es/CONTRIBUTING.md | 281 ++++++++++++++++++ 1 file changed, 281 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/CONTRIBUTING.md 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 From ab0926842a4df2df32190a1fb750de6c2aa56fa9 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:33:12 +0000 Subject: [PATCH 45/76] feat: spanish language was added to the navbar --- docs/intro-to-oss/translations/es/_navbar.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/_navbar.md 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..67bed869 --- /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 From cd0369cbbdb6a70106b4e60e836477e144c59c61 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:36:21 +0000 Subject: [PATCH 46/76] =?UTF-8?q?feat:=20spanish=20chapters=20added=20to?= =?UTF-8?q?=20the=20sidebar=C2=B7?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/intro-to-oss/translations/es/_sidebar.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/_sidebar.md 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 From fd57383205184d3298a6df23283950f2257ff3db Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:40:15 +0000 Subject: [PATCH 47/76] feat: added intro chapter translation --- .../translations/es/introduccion.md | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/introduccion.md 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 From 868d07dcb77503ac26d5be9a5d867c3e060cdb85 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:42:59 +0000 Subject: [PATCH 48/76] feat: added what is open source chapter --- .../translations/es/que-es-open-source.md | 67 +++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/que-es-open-source.md 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 From eb65852c41925b9fc7b4de7027b82bafed589116 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:44:44 +0000 Subject: [PATCH 49/76] feat: added why open source chapter --- .../translations/es/por-que-open-source.md | 55 +++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/por-que-open-source.md 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 From 868d897a03fa1fb93bcfb3b1a1a045ec845b8b10 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:46:19 +0000 Subject: [PATCH 50/76] feat: added tools to be successful chapter --- .../es/herramientas-para-tener-exito.md | 124 ++++++++++++++++++ 1 file changed, 124 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/herramientas-para-tener-exito.md 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 From b86ddbfee116209d112591ca8a86214e89e897d1 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:49:13 +0000 Subject: [PATCH 51/76] feat: added how to contribuite to open source chapter --- .../es/como-contribuir-al-open-source.md | 286 ++++++++++++++++++ 1 file changed, 286 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/como-contribuir-al-open-source.md 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..8506f06f --- /dev/null +++ b/docs/intro-to-oss/translations/es/como-contribuir-al-open-source.md @@ -0,0 +1,286 @@ +# 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. Esto le ayudará 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 las Pautas de contribución**: investigue cómo el proyecto recibe contribuciones leyendo el archivo CONTRIBUCIÓN. Desea asegurarse de seguir las reglas de contribución del proyecto. + +2. **Busque o cree un problema**: busque problemas etiquetados como "buen primer problema" o "apto para principiantes" que sean adecuados para su nivel de habilidad. Alternativamente, identifique una característica o mejora en la que le gustaría trabajar. Compruebe si se alinea con la hoja de ruta del proyecto y cree un problema. Esto podría incluir actualizaciones de documentación, correcciones de errores, cambios de contenido y más. + +3. **Solicite que se le asigne el problema**: al realizar su primera contribución a un proyecto, es una buena idea pedirles a los mantenedores que le asignen el problema. Esto asegurará que no duplique el trabajo y que su contribución esté alineada con los objetivos y requisitos del proyecto. + + Si no hay instrucciones en el archivo CONTRIBUTING, puede dejar un comentario sobre el problema: "¿Me pueden asignar este problema?" Cuando el mantenedor lo haya asignado, notará que su 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](https://docs.github.com/en/get-started/quickstart/fork-a-repo#forking-a-repository)**: Bifurcar un repositorio 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 su repositorio bifurcado](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository#cloning-a-repository)**: haga un copia de su repositorio bifurcado a 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, crea una nueva rama en tu repositorio local para trabajar en tu contribución. Crear una nueva rama es la mejor práctica en Open Source porque mantiene los cambios separados de la rama `principal`. + + 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 y pruebe sus cambios para asegurarse de que funcionen como se espera. + +5. **Agregue y confirme sus 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. + +6. **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. + +7. **[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)**: una vez que hayas enviado tus cambios, navega hasta el repositorio del proyecto original en GitHub y haz clic en el botón "Comparar y solicitar extracción". Complete la información requerida y envíe su solicitud de extracción haciendo clic en el botón "Crear solicitud de extracción". + +8. **Responder a los comentarios**: 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 haciendo clic en el botón "Nuevo problema" en la pestaña "Problemas" y complete el formulario. +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 el formulario de solicitud de extracción. + + !> Su solicitud de extracción se marcará como no válida y podrá cerrarse si el formulario está incompleto. + +¡Felicitaciones por tu primera contribución! 🎉 + +?> Si está listo para su próxima contribución, consulte el [repositorio de pizza-vers](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. \ No newline at end of file From 4eda35613ae100f20a013f12936d258dc009076e Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:51:49 +0000 Subject: [PATCH 52/76] feat: added the secret sauce chapter --- .../translations/es/la-salsa-secreta.md | 79 +++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/la-salsa-secreta.md 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..ed069f9c --- /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. + +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 \ No newline at end of file From fe57434232fe5a16ba9d08bf106be799a10b19a6 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:53:33 +0000 Subject: [PATCH 53/76] feat: added types of contributions chapter --- .../es/tipos-de-contribuciones.md | 105 ++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/tipos-de-contribuciones.md 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 From 815a0b1b6f124ee5966704df05989aa39908a2c5 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:55:22 +0000 Subject: [PATCH 54/76] feat: added conclusion chapter --- .../translations/es/conclusion.md | 41 +++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/conclusion.md 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 From 60a2167b66c3686ab2c67e2c1150fe957742c131 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:57:23 +0000 Subject: [PATCH 55/76] feat: added additional resources chapter --- .../translations/es/recursos-adicionales.md | 25 +++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/recursos-adicionales.md 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 From 9573fb7de1021d91ffb8dac8c337c7dca320c386 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 03:58:40 +0000 Subject: [PATCH 56/76] feat: added glossary chapter --- docs/intro-to-oss/translations/es/glosario.md | 72 +++++++++++++++++++ 1 file changed, 72 insertions(+) create mode 100644 docs/intro-to-oss/translations/es/glosario.md 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 From 6caa20ecf9480f3aba6d1d8d9b61fe91fa4232a5 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:03:44 +0000 Subject: [PATCH 57/76] fix: added the spanish language in the main navbar --- docs/intro-to-oss/_navbar.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/intro-to-oss/_navbar.md b/docs/intro-to-oss/_navbar.md index f2926a21..f848dcb0 100644 --- a/docs/intro-to-oss/_navbar.md +++ b/docs/intro-to-oss/_navbar.md @@ -6,3 +6,4 @@ - Languages - [: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 From d3e514a8f14fcc80b3eb54a937894793ef741c8e Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:07:40 +0000 Subject: [PATCH 58/76] fix: remove _layouts/ sidebar file --- translations/es/_layouts/sidebar.md | 11 ----------- 1 file changed, 11 deletions(-) delete mode 100644 translations/es/_layouts/sidebar.md diff --git a/translations/es/_layouts/sidebar.md b/translations/es/_layouts/sidebar.md deleted file mode 100644 index 75f70939..00000000 --- a/translations/es/_layouts/sidebar.md +++ /dev/null @@ -1,11 +0,0 @@ -- Páginas - - [Introducción](/translations/es/01-introduccion.md) - - [¿Qué es Open Source?](/translations/es/02-que-es-open-source.md) - - [¿Por qué Open Source?](/translations/es/03-por-que-open-source.md) - - [Herramientas para tener éxito](/translations/es/04-herramientas-para-tener-exito.md) - - [Cómo contribuir al Open Source](/translations/es/05-como-contribuir-al-open-source.md) - - [La Salsa Secreta](/translations/es/06-la-salsa-secreta.md) - - [Tipos de contribuciones](/translations/es/07-tipos-de-contribuciones.md) - - [Recursos adicionales](/translations/es/08-recursos-adicionales.md) - - [Conclusión](/translations/es/09-conclusion.md) - - [Glosario](/translations/es/10-glosario.md) \ No newline at end of file From e8a2eb829fbbf5b3ea0b99309d29b5f7b5f3e72d Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:08:39 +0000 Subject: [PATCH 59/76] fix: remove _layouts/ navbar file --- translations/es/_layouts/navbar.md | 6 ------ 1 file changed, 6 deletions(-) delete mode 100644 translations/es/_layouts/navbar.md diff --git a/translations/es/_layouts/navbar.md b/translations/es/_layouts/navbar.md deleted file mode 100644 index 551638af..00000000 --- a/translations/es/_layouts/navbar.md +++ /dev/null @@ -1,6 +0,0 @@ -- [Página de inicio](/) -- [⭐ Repositorio Estrella](https://github.com/open-sauced/intro) -- Idiomas - - [:us: Inglés ](/) - - [:fr: Francés ](/translations/fr/) - - [:es: Español ](/translations/es/) \ No newline at end of file From 38b5fda6b131c8af18c6d8a9f12516ef50f812c2 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:09:48 +0000 Subject: [PATCH 60/76] fix: remove README file --- translations/es/README.md | 58 --------------------------------------- 1 file changed, 58 deletions(-) delete mode 100644 translations/es/README.md diff --git a/translations/es/README.md b/translations/es/README.md deleted file mode 100644 index 085b1f3c..00000000 --- a/translations/es/README.md +++ /dev/null @@ -1,58 +0,0 @@ -
-
- Salsa abierta -

🍕 Introducción al Open Source con OpenSauced 🍕

- El sitio proporciona materiales del curso de Introducción al Open Source de 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 idioma -Al igual que la pizza, el Open Source debe compartirse con todos. Haga clic en los enlaces a continuación para seguir este curso en los siguientes idiomas diferentes. - -- [Inglés](/README.md) -- [Francés](/translations/fr/README.md) - -## Resumen del curso - -El curso está dividido en cinco capítulos, cada uno de los cuales cubre un aspecto diferente del Open Source: - -1. **¿Qué es Open Source?** Este capítulo proporciona una introducción al Open Source, su historia y su importancia en el panorama actual del desarrollo de software. - -2. **¿Por qué Open Source?** En este capítulo, conocerá los beneficios del software Open Source, como una mayor colaboración, un desarrollo más rápido y una mejor calidad. - -3. **Herramientas para tener éxito.** 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 hasta CodeSee para visualización de código y VS Code como editor de código, este capítulo proporciona una descripción general de cómo aprovechar estas herramientas esenciales. - -4. **¿Cómo contribuir al Open Source?** Este capítulo cubre la búsqueda de proyectos en los que trabajar, el envío de contribuciones, la integración en nuevos proyectos y los resultados después de enviar las contribuciones. Los consejos para encontrar proyectos incluyen navegar por GitHub y GitLab, seguir sus intereses personales, unirse a comunidades Open Source y utilizar plataformas como OpenSauced. - -5. **La salsa secreta** 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 viaje hacia el Open Source y aprovechar OpenSauced para crear su currículum de 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](10-glosario.md): Un glosario de términos y definiciones comúnmente utilizados en el campo del Open Source. -- [Recursos adicionales](08-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`](01-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. 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](06-la-salsa-secreta.md#construyendo-su-currículum-de-open-source) en el capítulo [La salsa secreta](06-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! - ---- - -🤝 ¿Interesado en contribuir 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 [la Guía de contribución](https://docs.opensauced.pizza/contributing/introduction-to-contributing/) para obtener pautas sobre cómo proceder con su contribución. - -[![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 From dc467e522f96434aedc16cd2505ef0e6172f0410 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:10:47 +0000 Subject: [PATCH 61/76] fix: remove chapter 01 --- translations/es/01-introduccion.md | 57 ------------------------------ 1 file changed, 57 deletions(-) delete mode 100644 translations/es/01-introduccion.md diff --git a/translations/es/01-introduccion.md b/translations/es/01-introduccion.md deleted file mode 100644 index 5b4f54f7..00000000 --- a/translations/es/01-introduccion.md +++ /dev/null @@ -1,57 +0,0 @@ -# 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: - -1. **Introducción:** Comenzaremos preparando el escenario para su viaje hacia el Open Source, analizando los requisitos previos, los objetivos y las expectativas. -1. **¿Qué es Open Source?:** 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. -1. **¿Por qué Open Source?:** Profundizaremos en los beneficios del Open Source, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. -1. **Herramientas para tener éxito:** Este capítulo le presentará las herramientas esenciales para una colaboración exitosa en Open Source, incluidos GitHub, Git, CodeSee, VS Code y Discord. -1. **Cómo contribuir al Open Source:** 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. -1. **La salsa secreta:** Este capítulo revelará las estrategias y técnicas para comenzar, ganar terreno en sus contribuciones y desarrollar su currículum de Open Source. -1. **Conclusión:** 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. - -## LFG 🚀 - -Ahora que hemos preparado el escenario, ¡es hora de embarcarse en su viaje hacia el Open Source! En el próximo capítulo, 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! - -[Siguiente Sección ->](02-que-es-open-source.md) From 1d1e7de2040a2b4e4be4472700c35efc25e4444c Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:11:52 +0000 Subject: [PATCH 62/76] fix: remove chapter 02 --- translations/es/02-que-es-open-source.md | 69 ------------------------ 1 file changed, 69 deletions(-) delete mode 100644 translations/es/02-que-es-open-source.md diff --git a/translations/es/02-que-es-open-source.md b/translations/es/02-que-es-open-source.md deleted file mode 100644 index 396d7fd0..00000000 --- a/translations/es/02-que-es-open-source.md +++ /dev/null @@ -1,69 +0,0 @@ -# ¿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, 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. - -[Siguiente Sección ->](03-por-que-open-source.md) From 4669121070492339b31ad3c17c30de673cbd787c Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:12:57 +0000 Subject: [PATCH 63/76] fix: remove chapter 03 --- translations/es/03-por-que-open-source.md | 57 ----------------------- 1 file changed, 57 deletions(-) delete mode 100644 translations/es/03-por-que-open-source.md diff --git a/translations/es/03-por-que-open-source.md b/translations/es/03-por-que-open-source.md deleted file mode 100644 index 85f4d290..00000000 --- a/translations/es/03-por-que-open-source.md +++ /dev/null @@ -1,57 +0,0 @@ -# ¿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, analizaremos las herramientas y recursos esenciales que necesitará para tener éxito en su viaje hacia el Open Source, incluidos GitHub, Git, CodeSee, 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. - -[Siguiente Sección ->](04-herramientas-para-tener-exito.md) From c97045c342282f768b6643374b40b78df11a9bfc Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:13:37 +0000 Subject: [PATCH 64/76] fix: remove chapter 04 --- .../es/04-herramientas-para-tener-exito.md | 137 ------------------ 1 file changed, 137 deletions(-) delete mode 100644 translations/es/04-herramientas-para-tener-exito.md diff --git a/translations/es/04-herramientas-para-tener-exito.md b/translations/es/04-herramientas-para-tener-exito.md deleted file mode 100644 index b734b9c2..00000000 --- a/translations/es/04-herramientas-para-tener-exito.md +++ /dev/null @@ -1,137 +0,0 @@ -# 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 -- CodeSee -- 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 navegue hasta [https://github.com/new](https://github.com/new) o 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](../../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! - -## CodeSee - -CodeSee es una poderosa herramienta de visualización que ayuda a los desarrolladores a comprender bases de código complejas y navegar por proyectos grandes de manera más eficiente. Al proporcionar una representación visual de su código, CodeSee le permite: - -- **Identificar dependencias**: CodeSee lo ayuda a comprender cómo están conectadas las diferentes partes de su código base y cómo los cambios en un área pueden afectar otras áreas. -- **Analizar la estructura del código**: CodeSee le permite visualizar la estructura de su código, lo que facilita la identificación de patrones, antipatrones y áreas de mejora. -- **Navegue por bases de código grandes**: con CodeSee, puede navegar rápidamente por bases de código grandes y encontrar las partes del código en las que necesita trabajar. - -Para comenzar con CodeSee, visite el sitio web oficial (https://www.codesee.io/) y siga las instrucciones para instalar la extensión del navegador e integrarla con su cuenta de GitHub. - -## 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, 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. - -[Siguiente Sección ->](05-como-contribuir-al-open-source.md) From 59c1b2d474f09669d07177a5485b5b38c3f6992e Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:14:38 +0000 Subject: [PATCH 65/76] fix: remove chapter 05 --- .../es/05-como-contribuir-al-open-source.md | 353 ------------------ 1 file changed, 353 deletions(-) delete mode 100644 translations/es/05-como-contribuir-al-open-source.md diff --git a/translations/es/05-como-contribuir-al-open-source.md b/translations/es/05-como-contribuir-al-open-source.md deleted file mode 100644 index a979bc6b..00000000 --- a/translations/es/05-como-contribuir-al-open-source.md +++ /dev/null @@ -1,353 +0,0 @@ -# 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 "primeros buenos números", 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. - - ![Imagen](../../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](../../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. Esto le ayudará 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 las Pautas de contribución**: investigue cómo el proyecto recibe contribuciones leyendo el archivo CONTRIBUCIÓN. Desea asegurarse de seguir las reglas de contribución del proyecto. - -2. **Busque o cree un problema**: busque problemas etiquetados como "primer buen número" o "apto para principiantes" que sean adecuados para su nivel de habilidad. Alternativamente, identifique una característica o mejora en la que le gustaría trabajar. Compruebe si se alinea con la hoja de ruta del proyecto y cree un problema. Esto podría incluir actualizaciones de documentación, correcciones de errores, cambios de contenido y más. - -3. **Solicite que se le asigne el problema**: al realizar su primera contribución a un proyecto, es una buena idea pedirles a los mantenedores que le asignen el problema. Esto asegurará que no duplique el trabajo y que su contribución esté alineada con los objetivos y requisitos del proyecto. - - Si no hay instrucciones en el archivo CONTRIBUTING, puede dejar un comentario sobre el problema: "¿Me pueden asignar este problema?" Cuando el mantenedor lo haya asignado, notará que su nombre de usuario ahora se encuentra en la sección "Asignados". - - ![captura de pantalla del problema asignado](../../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](https://docs.github.com/en/get-started/quickstart/fork-a-repo#forking-a-repository)**: Bifurcar un repositorio 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 su repositorio bifurcado](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository#cloning-a-repository)**: haga un copia de su repositorio bifurcado a 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, crea una nueva rama en tu repositorio local para trabajar en tu contribución. Crear una nueva rama es la mejor práctica en Open Source porque mantiene los cambios separados de la rama "principal". - - 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 y pruebe sus cambios para asegurarse de que funcionen como se espera. - -5. **Agregue y confirme sus 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. - -6. **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. - -7. **[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)**: una vez que hayas enviado tus cambios, navega hasta el repositorio del proyecto original en GitHub y haz clic en el botón "Comparar y solicitar extracción". Complete la información requerida y envíe su solicitud de extracción haciendo clic en el botón "Crear solicitud de extracción". - -8. **Responder a los comentarios**: 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 haciendo clic en el botón "Nuevo problema" en la pestaña "Problemas" y complete el formulario. -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. Agréguese al libro de visitas. - - Hay dos formas de completar esta actividad: - - - Utilizando la herramienta CLI. - - Editar manualmente el archivo `.all-contributorsrc`. - - Aunque agregarse al libro de visitas con la herramienta CLI es más sencillo, recomendamos editar manualmente el archivo para obtener más experiencia agregando y confirmando sus cambios, creando solicitudes de extracción y revisiones de solicitudes de extracción. A continuación encontrará las instrucciones para cada método: - - **Herramienta CLI** - - - 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. - - **Adición manual** - - - Abra el archivo `.all-contributorsrc`. - - Ir al último contribuyente en la matriz de contribuyentes. - - Agregue una coma después de la última llave de cierre (`},`). - - Copia y pega la siguiente plantilla: - - ```javascript - { - "login": "", - "name": "", - "avatar_url": "", - "profile": "", - "contributions": [] - } - ``` - - - Agréguese manualmente al libro de visitas actualizando esta información: - - - **login**: su nombre de usuario de GitHub. - - **name**: Tu nombre. - - **avatar_url**: URL de tu avatar en GitHub. - - En su navegador, copie y pegue el enlace de su perfil de GitHub, agregue `.png` al final (por ejemplo, `https://github.com/TU_NOMBRE_DE_USUARIO.png`) y haga clic en Intro. Copia y pega el enlace aquí. - - - **profile**: Enlace a tu sitio web (si lo incluyes en tu perfil de GitHub) **o** tu perfil de GitHub. - - **contribution**: Tipo de tus contribuciones. - - Consulte los tipos (en la primera columna) en esta [clave de emoji y tipos de contribución](https://allcontributors.org/docs/en/emoji-key) para completar los valores. - - > ⚠️ **Tienes que utilizar estrictamente los tipos de la lista para evitar romper todo el proyecto.** - - El resultado sería así: - - ```javascript - { - "login": "nombre-de-usuario-de-github", - "name": "Nombre de Usuario", - "avatar_url": "https://avatars.githubusercontent.com/u/xxxxxxxx?v=x", - "profile": "URL link", - "contributions": [ - "question", - "blog", - "code" - ] - } - ``` - - > ⚠️ **Recuerde agregar una coma después de las comillas, excepto la última de la matriz y la última llave de cierre.** - -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. - - > **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. Si utilizó el método de la herramienta CLI en el paso 5 para agregarse al libro de visitas, **omita este paso**. De lo contrario: - - Agregue y confirme sus cambios ejecutando el siguiente comando: - - ```bash - git commit -am "Tu mensaje de confirmación" - ``` - - Reemplace `"Tu mensaje de confirmación"` por su propio mensaje. Por ejemplo, `"Agregar a Alice como colaboradora"`. - - > **Nota**: A diferencia del enfoque `git add .` y `git commit -m "Tu mensaje"`, en el comando `git commit -am`, agregar el indicador `-a` a `git commit` omite el proceso de puesta en escena. La bandera `-a` organiza automáticamente todos sus cambios en archivos _committed_. Combinarlo con el indicador `-m` le permite escribir el mensaje de confirmación. - -10. Ejecute `git log` para verificar si ha confirmado sus cambios. Presione `Q` para cerrar el registro. - - Si se agrega utilizando la herramienta CLI, automáticamente agrega y confirma sus cambios. Entonces verá este mensaje de confirmación automatizado: - - ```bash - docs: add @your_username as a contributor - ``` - -11. Envíe el compromiso a su repositorio bifurcado con este comando: - - ```bash - git push -u origin nombre-rama - ``` - -12. Vaya a su repositorio bifurcado en GitHub y cree una solicitud de extracción con el título `feat: Add <@github-username> as a colaborator`. - -¡Felicitaciones por tu primera 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 verse](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`, `hazaña: 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, 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. - -[Siguiente Sección ->](06-la-salsa-secreta.md) From f123547ef7a3135aedeb57c46a76d7329b54f053 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:15:45 +0000 Subject: [PATCH 66/76] fix: remove chapter 06 --- translations/es/06-la-salsa-secreta.md | 79 -------------------------- 1 file changed, 79 deletions(-) delete mode 100644 translations/es/06-la-salsa-secreta.md diff --git a/translations/es/06-la-salsa-secreta.md b/translations/es/06-la-salsa-secreta.md deleted file mode 100644 index 4db95f2d..00000000 --- a/translations/es/06-la-salsa-secreta.md +++ /dev/null @@ -1,79 +0,0 @@ -# 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 "primer buen número" 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](../../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 resaltado a tu perfil](../../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. - -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. - -[Sección Final ->](07-tipos-de-contribuciones.md) From 45506f88faa499fe71391a8309f34f48896e067c Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:16:23 +0000 Subject: [PATCH 67/76] fix: remove chapter 07 --- translations/es/07-tipos-de-contribuciones.md | 109 ------------------ 1 file changed, 109 deletions(-) delete mode 100644 translations/es/07-tipos-de-contribuciones.md diff --git a/translations/es/07-tipos-de-contribuciones.md b/translations/es/07-tipos-de-contribuciones.md deleted file mode 100644 index a3149cc5..00000000 --- a/translations/es/07-tipos-de-contribuciones.md +++ /dev/null @@ -1,109 +0,0 @@ -# Tipos de contribuciones - -En este capítulo, discutiremos los tipos de contribuciones de codificación y no codificación involucradas en proyectos Open Source. - -## Tipo de 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. Permiten que personas con una variedad de habilidades y antecedentes participen y hagan contribuciones significativas al software y a la comunidad. - -> [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) - -**Tipos comunes de contribuciones no codificadas** - - - Documentación - - Diseño gráfico - - Redacción de blogs - -### 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! - -Esto implica crear, mejorar o mantener los recursos escritos que acompañan a los proyectos de software Open Source. La documentación es crucial para los proyectos Open Source. 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. - -#### Cómo contribuir a la documentación - -*Si está interesado en contribuir con la documentación, aquí tiene algunos consejos:* - -- **Lea la documentación**: Esto le ayudará a comprender cómo se utiliza el producto. - -- **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**: obtener información sobre el usuario le ayudará a ver qué información es necesaria o no útil en los documentos. - -- **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: - - - Escriba un archivo README que explique cómo instalar y usar el proyecto: [La aplicación OpenSauced - ](https://github.com/open-sauced/app/blob/beta/README.md) - - - Cree un tutorial que guíe a los usuarios a través de las funciones del proyecto: [Función destacada de OpenSauced](https://docs.opensauced.pizza/community/highlights/) - - - Actualice la documentación del proyecto para reflejar los nuevos cambios: [Agregar tarjetas de desarrollo a Introducción](https://github.com/open-sauced/docs/issues/156) - - - Traducir la documentación del proyecto a otros idiomas: [Traducir el curso a otro idioma](https://github.com/open-sauced/intro/issues/16) - - - Corregir errores tipográficos y gramaticales en la documentación: [Agregar información sobre posesivos - ](https://github.com/StyleGuides/WritingStyleGuide/pull/519) - - - Mejorar el formato de la documentación: [Destino del enlace incorrecto en la documentación](https://github.com/open-sauced/docs/pull/144) - - - Agregue la información que falta a la documentación: [Agregue más información para usar esta plantilla en el README](https://github.com/open-sauced/100-days-of-oss-template/pull/8) - -Contribuir a la documentación es una excelente manera de ayudar a los proyectos Open Source y hacerlos más accesibles para todos. Si tienes las habilidades y el interés, ¡participa! - -### Diseño gráfico - -Esta contribución al Open Source implica la creación de activos visuales, como logotipos, íconos, ilustraciones, diseños de sitios web y otros elementos gráficos, para proyectos Open Source. 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. Los diseñadores gráficos pueden crear íconos personalizados para aplicaciones de software o sitios web, mejorando el atractivo visual y la facilidad de uso del proyecto: [registro en Eventhub](https://github.com/WebXGuild/webx-guild/pull/13) - - - **Diseño de sitios web**: los proyectos Open Source suelen tener sitios web para proporcionar información, documentación y enlaces de descarga. Los diseñadores gráficos pueden 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. Los diseñadores pueden 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)**: los diseñadores de UX se centran en mejorar la experiencia general del usuario considerando cómo interactúan los usuarios con el software. Esto incluye el diseño de flujos de usuarios, navegación y pruebas de usabilidad. - -- **Diseño de accesibilidad**: Garantizar que los elementos gráficos del proyecto sean accesibles para todos los usuarios, incluidos aquellos con discapacidades, es un aspecto importante del diseño gráfico. Los diseñadores pueden crear combinaciones de colores accesibles y garantizar que los elementos visuales sean perceptibles y operables. - -- **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. - -### Escritura de blogs - -Este tipo de contribución al Open Source implica la creación y publicación de blogs, artículos o tutoriales relacionados con software, proyectos, tecnologías o mejores prácticas del Open Source. Al igual que la documentación, no necesariamente es necesario saber codificar para escribir estas publicaciones. - -#### Formas de utilizar los blogs como contribución al Open Source - -- Puedes escribir sobre las últimas funciones de un proyecto Open Source, como una nueva versión del software o un nuevo complemento: [Anuncio de la versión 0.2.0 de Analog](https://dev.to/analogjs/announcing-the-020-release-of-analog-aa1) - -- Puedes escribir un tutorial sobre cómo instalar y configurar el software: [Cómo hacer una deliciosa guía de contribución](https://dev.to/opensauced/how-to-make-a-delicious-contributing-guide-4bp3 ) - -- Escriba sobre el impacto de un proyecto Open Source, como por ejemplo cómo se ha utilizado para marcar la diferencia en el mundo: [Reteniendo a los mejores ingenieros](https://opensauced.pizza/blog/retaining-the-best-engineers ) - -- Tipos de contribuciones codificadas y no codificadas, y cómo comenzar con el Open Source: [Open Source 101: una guía para principiantes para comenzar](https://opensauced.pizza/blog/open-source-101-a-beginner's-guide-to-getting-started) - -## Tipos de 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 código nuevo**: este es el tipo más común de contribución de codificación. Los desarrolladores escriben código nuevo para agregar funciones, corregir errores o mejorar la funcionalidad de un proyecto Open Source. Estas contribuciones generalmente se envían en forma de solicitudes de extracción (PR) o parches: [Mostrar quién reaccionó a los momentos destacados](https://github.com/open-sauced/app/pull/1591) - -- **Corrección de errores**: identificar y corregir errores es una contribución fundamental a la codificación. Los desarrolladores localizan problemas dentro del código base, los diagnostican y luego escriben código para corregirlos. Las correcciones de errores mejoran la estabilidad y confiabilidad del software: [La verificación de pelusa ocurre dos veces al confirmar -](https://github.com/open-sauced/app/pull/1635) - -- **Refactorización de código**: La refactorización implica reestructurar y mejorar el código existente sin cambiar su comportamiento externo. Esto ayuda a mejorar la legibilidad, el mantenimiento y la escalabilidad del código, que son vitales para la salud a largo plazo del proyecto: [función CalcDistanceFromToday](https://github.com/open-sauced/app/pull/1633) - -- **Diseño y mantenimiento de API**: para proyectos con API públicas, los desarrolladores pueden contribuir al diseño, mantenimiento y mejora de la API para garantizar que permanezca estable y amigable para los desarrolladores: [Token de actualización -](https://github.com/IridiumIdentity/iridium/pull/134) - -- **Desarrollo de funcionalidades**: los desarrolladores contribuyen implementando nuevas características o funcionalidades en respuesta a las necesidades del usuario o los objetivos del proyecto. El desarrollo de funcionalidades a menudo implica planificar, diseñar y codificar nuevos componentes o capacidades: [Se agregó la página de contacto -](https://github.com/TechIsHiring/techishiring-website/pull/53) - -- **Optimización del rendimiento**: los codificadores pueden trabajar para optimizar el rendimiento del software refactorizando el código, mejorando los algoritmos u optimizando el uso de recursos. Este tipo de contribución tiene como objetivo hacer que el software se ejecute de manera más eficiente: [La tabla de repositorios en pantallas pequeñas no muestra la selección](https://github.com/open-sauced/app/pull/1559) - -- **Pruebas y control de calidad**: 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: [Agregar componente de inicio de sesión forzado al sistema de diseño](https://github.com/open-sauced/app/pull/1330) - -[Siguiente sección ->](08-recursos-adicionales.md) From bcab405ed772d9f6ae498b90ba801ff9a4e1b379 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:16:54 +0000 Subject: [PATCH 68/76] fix: remove chapter 08 --- translations/es/08-recursos-adicionales.md | 23 ---------------------- 1 file changed, 23 deletions(-) delete mode 100644 translations/es/08-recursos-adicionales.md diff --git a/translations/es/08-recursos-adicionales.md b/translations/es/08-recursos-adicionales.md deleted file mode 100644 index 9ba48f5b..00000000 --- a/translations/es/08-recursos-adicionales.md +++ /dev/null @@ -1,23 +0,0 @@ -¡Felicitaciones por su viaje hacia el Open Source! Aquí hay algunos recursos para aprender más sobre cómo comenzar con el 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 número: 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 números no existen](https://opensauced.pizza/blog/good-first-issues-dont-exist) - -[Siguiente Sección ->](09-conclusion.md) From 1fc8cdf1d874446dc5c213a6ecc43198f61aec8e Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:17:28 +0000 Subject: [PATCH 69/76] fix: remove chapter 09 --- translations/es/09-conclusion.md | 41 -------------------------------- 1 file changed, 41 deletions(-) delete mode 100644 translations/es/09-conclusion.md diff --git a/translations/es/09-conclusion.md b/translations/es/09-conclusion.md deleted file mode 100644 index a1afbff4..00000000 --- a/translations/es/09-conclusion.md +++ /dev/null @@ -1,41 +0,0 @@ -# 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: - -1. **¿Qué es Open Source?**: Discutimos la definición de Open Source, su historia y los principios básicos que guían el movimiento del Open Source. - -2. **¿Por qué Open Source?**: Exploramos los beneficios de participar en proyectos Open Source, incluido el acceso al conocimiento, la comunidad y el desarrollo de habilidades. - -3. **Herramientas para tener éxito**: presentamos herramientas y plataformas esenciales para contribuyentes del Open Source, como GitHub, Git, CodeSee, Visual Studio Code y Discord. - -4. **Cómo 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. - -5. **La salsa secreta**: 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. - -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](08-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! - -[Siguiente sección ->](10-glosario.md) From 19e29ba5db93e4ec3bd294958e480146e70c6b08 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:18:55 +0000 Subject: [PATCH 70/76] fix: remove chapter 10 --- translations/es/10-glosario.md | 72 ---------------------------------- 1 file changed, 72 deletions(-) delete mode 100644 translations/es/10-glosario.md diff --git a/translations/es/10-glosario.md b/translations/es/10-glosario.md deleted file mode 100644 index fccf7216..00000000 --- a/translations/es/10-glosario.md +++ /dev/null @@ -1,72 +0,0 @@ -## 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. - -## Documentos - -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. From 3ac1b49cf94b03f223694b7dab2b99492b3c0702 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:38:45 +0000 Subject: [PATCH 71/76] fix: fix: README: relative paths --- docs/intro-to-oss/translations/es/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/intro-to-oss/translations/es/README.md b/docs/intro-to-oss/translations/es/README.md index 4d39d946..7a9a1e0d 100644 --- a/docs/intro-to-oss/translations/es/README.md +++ b/docs/intro-to-oss/translations/es/README.md @@ -11,8 +11,8 @@ 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) +- [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). From d209c2056441989ac2af8b54decda87e316b5ef0 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 04:45:25 +0000 Subject: [PATCH 72/76] fix: navbar: relative paths --- docs/intro-to-oss/translations/es/_navbar.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/intro-to-oss/translations/es/_navbar.md b/docs/intro-to-oss/translations/es/_navbar.md index 67bed869..130ec55b 100644 --- a/docs/intro-to-oss/translations/es/_navbar.md +++ b/docs/intro-to-oss/translations/es/_navbar.md @@ -1,10 +1,10 @@ - [Página de inicio](../../../README.md) -- [Empezar](/intro-to-oss/translations/es/) +- [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 + - [: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 From d267ecfa50942735c7ea1bcdc3bfa6751ce5e46c Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Wed, 8 May 2024 06:31:30 +0000 Subject: [PATCH 73/76] fix: us navbar: relative paths --- docs/intro-to-oss/_navbar.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/intro-to-oss/_navbar.md b/docs/intro-to-oss/_navbar.md index f848dcb0..6f8d8539 100644 --- a/docs/intro-to-oss/_navbar.md +++ b/docs/intro-to-oss/_navbar.md @@ -4,6 +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/) - - [:es: Spanish ](/intro-to-oss/translations/es/) \ No newline at end of file + - [: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 From e8c187db696296b45089bf323ad6373f1742d592 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Thu, 9 May 2024 16:28:11 -0500 Subject: [PATCH 74/76] feat: Update como-contribuir-al-open-source.md updated chapter translation based on this [PR](https://github.com/open-sauced/intro/pull/181) --- .../es/como-contribuir-al-open-source.md | 56 ++++++++++++++++--- 1 file changed, 48 insertions(+), 8 deletions(-) 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 index 8506f06f..eda3ac7c 100644 --- 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 @@ -42,7 +42,7 @@ Cuando esté interesado en contribuir a un nuevo proyecto Open Source, es import 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. Esto le ayudará a comprender los objetivos, requisitos y expectativas del proyecto para los contribuyentes. +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. @@ -56,15 +56,47 @@ A continuación se ofrecen algunos consejos que le ayudarán a incorporarse con Entonces, te has incorporado al proyecto. Ahora puedes prepararte para contribuir siguiendo estos pasos: -1. **Lea las Pautas de contribución**: investigue cómo el proyecto recibe contribuciones leyendo el archivo CONTRIBUCIÓN. Desea asegurarse de seguir las reglas de contribución del proyecto. +### 1. Lea la documentación -2. **Busque o cree un problema**: busque problemas etiquetados como "buen primer problema" o "apto para principiantes" que sean adecuados para su nivel de habilidad. Alternativamente, identifique una característica o mejora en la que le gustaría trabajar. Compruebe si se alinea con la hoja de ruta del proyecto y cree un problema. Esto podría incluir actualizaciones de documentación, correcciones de errores, cambios de contenido y más. +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. -3. **Solicite que se le asigne el problema**: al realizar su primera contribución a un proyecto, es una buena idea pedirles a los mantenedores que le asignen el problema. Esto asegurará que no duplique el trabajo y que su contribución esté alineada con los objetivos y requisitos del proyecto. +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 tecnológico que utiliza y cómo configurar y ejecutar el entorno local. - Si no hay instrucciones en el archivo CONTRIBUTING, puede dejar un comentario sobre el problema: "¿Me pueden asignar este problema?" Cuando el mantenedor lo haya asignado, notará que su nombre de usuario ahora se encuentra en la sección "Asignados". +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. - ![Sección de asignatarios de problemas en GitHub](../../../_assets/images/issue-assign.png) +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. + +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 @@ -139,7 +171,15 @@ Necesitará tener estas herramientas descargadas e instaladas en su máquina loc ### Empezando -1. Cree un problema haciendo clic en el botón "Nuevo problema" en la pestaña "Problemas" y complete el formulario. +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. @@ -283,4 +323,4 @@ Antes de resolver conflictos de fusión, primero debe [actualizar sus ramas](#ac
-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. \ No newline at end of file +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. From 61d914ec1c024cfe3425719dcba3bb216a99e1a0 Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 27 May 2024 22:56:48 -0500 Subject: [PATCH 75/76] update: updated the translation of the chapter 'como-contribuir-al-open-source' [Related PR](https://github.com/open-sauced/intro/pull/185) This commit translates the latest changes to the 'How to Contribute to Open Source' file These were some of the changes in the file: - Fork the Repository - Clone the Forked Repository - Create a New Branch - Make Changes - Run the Changes Locally - Add and Commit the Changes - Push the Changes - Working with a Pull Request --- .../es/como-contribuir-al-open-source.md | 203 ++++++++++++++++-- 1 file changed, 189 insertions(+), 14 deletions(-) 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 index eda3ac7c..9a8317d9 100644 --- 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 @@ -60,7 +60,7 @@ Entonces, te has incorporado al proyecto. Ahora puedes prepararte para contribui 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 tecnológico que utiliza y cómo configurar y ejecutar el entorno local. +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. @@ -74,7 +74,7 @@ Algunos proyectos también tienen convenciones, como código y estilo Markdown, 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. +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: @@ -102,9 +102,13 @@ Puede dejar un comentario sobre el problema, como "¿Me pueden asignar este prob 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](https://docs.github.com/en/get-started/quickstart/fork-a-repo#forking-a-repository)**: Bifurcar un repositorio 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. +### 1. Bifurcar el repositorio -2. **[Clonar su repositorio bifurcado](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository#cloning-a-repository)**: haga un copia de su repositorio bifurcado a su máquina local. Ejecute el siguiente comando en su terminal: +[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 @@ -112,7 +116,9 @@ Una vez que un mantenedor le haya asignado un problema, el siguiente paso es tra 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, crea una nueva rama en tu repositorio local para trabajar en tu contribución. Crear una nueva rama es la mejor práctica en Open Source porque mantiene los cambios separados de la rama `principal`. +### 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: @@ -122,9 +128,19 @@ Una vez que un mantenedor le haya asignado un problema, el siguiente paso es tra 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 y pruebe sus cambios para asegurarse de que funcionen como se espera. +### 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 -5. **Agregue y confirme sus cambios**: una vez que haya realizado los cambios, agréguelos al área de preparación y confírmelos con estos comandos: +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 . @@ -133,17 +149,173 @@ Una vez que un mantenedor le haya asignado un problema, el siguiente paso es tra Reemplace `"Tu mensaje de confirmación"` con una breve descripción de sus cambios. -6. **Envíe sus cambios**: envíe sus cambios a su repositorio bifurcado en GitHub ejecutando el siguiente comando: +### 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. + 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 -7. **[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)**: una vez que hayas enviado tus cambios, navega hasta el repositorio del proyecto original en GitHub y haz clic en el botón "Comparar y solicitar extracción". Complete la información requerida y envíe su solicitud de extracción haciendo clic en el botón "Crear solicitud de extracción". + ## [optional] What gif best describes this PR or how it makes you feel? -8. **Responder a los comentarios**: 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. + + + + ``` + +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. @@ -172,6 +344,7 @@ Necesitará tener estas herramientas descargadas e instaladas en su máquina loc ### 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. @@ -179,7 +352,9 @@ Necesitará tener estas herramientas descargadas e instaladas en su máquina loc - 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. @@ -211,13 +386,13 @@ Necesitará tener estas herramientas descargadas e instaladas en su máquina loc 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 el formulario de solicitud de extracción. +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 el formulario está incompleto. + !> 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-vers](https://github.com/open-sauced/pizza-verse) y siga las pautas de 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 From 78fda64a1c67d29d687fb75b92041184d9b438bb Mon Sep 17 00:00:00 2001 From: Samuel Soto <108969323+samucodesh@users.noreply.github.com> Date: Mon, 27 May 2024 23:00:59 -0500 Subject: [PATCH 76/76] update: Add link to Job Seekers Guide in La Salsa Secreta file [Related PR](https://github.com/open-sauced/intro/pull/194) This commit adds a link to the Job Seekers Guide within the 'La Salsa Secreta' file of the Spanish translation. This provides additional resources for individuals seeking employment opportunities in the tech industry. --- docs/intro-to-oss/translations/es/la-salsa-secreta.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/intro-to-oss/translations/es/la-salsa-secreta.md b/docs/intro-to-oss/translations/es/la-salsa-secreta.md index ed069f9c..e2cbf1da 100644 --- a/docs/intro-to-oss/translations/es/la-salsa-secreta.md +++ b/docs/intro-to-oss/translations/es/la-salsa-secreta.md @@ -72,8 +72,8 @@ Para ser más eficaz a la hora de destacar sus contribuciones, le recomendamos u **¡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. +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 \ No newline at end of file +En el [próximo capítulo](tipos-de-contribuciones.md), analizaremos varios tipos de contribuciones en Open Source