Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translation of the book to Spanish #785

Open
wants to merge 23 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 20 commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
4fa7ab6
Add Spanish templates for README and CONTRIBUTING documentation
Mar 3, 2025
2367813
Add Spanish translations and resources for various patterns and updat…
Mar 7, 2025
abecbd0
Add Spanish translations and resources for various patterns and updat…
Mar 7, 2025
cb325f2
Use Patlet as section title in the Spanish translations. Required for…
spier Mar 7, 2025
d22b57f
Adding @ovas04 as translation lead for the Spanish translation
spier Mar 7, 2025
960034b
Regenerate HTML file for Spanish mindmap
spier Mar 7, 2025
e7060bf
Regenerate PNG for ES mindmap (works locally only).
spier Mar 7, 2025
3b563a8
Remove file
spier Mar 7, 2025
5d83e35
Remove CODEOWNERS entry (folder) that does not exist
spier Mar 7, 2025
40d6da1
Revert "Regenerate HTML file for Spanish mindmap"
spier Mar 7, 2025
06627a1
Spelling fix
spier Mar 7, 2025
988a41f
Translating cover image of the book
spier Mar 9, 2025
04dead3
fix issues related to translations and format
ovas04 Mar 9, 2025
3b09f59
Fix formatting and translation inconsistencies in documentation files
ovas04 Mar 9, 2025
152a5f4
Fix translation errors and improve clarity in Spanish documentation
ovas04 Mar 10, 2025
df03e3f
fix translation inconsistencies and improve clarity in Spanish docume…
ovas04 Mar 10, 2025
972ceaf
fix translation inconsistencies and improve clarity in Spanish docume…
ovas04 Mar 10, 2025
99f486e
fix grammatical errors in Spanish
ovas04 Mar 10, 2025
7e6ab16
fix translation inconsistencies and improve clarity in Spanish docume…
ovas04 Mar 10, 2025
23d7814
fix the missing word
ovas04 Mar 10, 2025
58dee07
add translation credits for RMartin
ovas04 Mar 12, 2025
2a6589b
Regenerate TOC for es
spier Mar 12, 2025
f65e251
Regenerate mindmap
spier Mar 12, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/CODEOWNERS
Original file line number Diff line number Diff line change
Expand Up @@ -20,3 +20,5 @@
/translation/gl/ @psanxiao
/book/gl/ @psanxiao
/pattern-categorization/gl/ @psanxiao
/translation/es/ @ovas04
/book/es/ @ovas04
2 changes: 1 addition & 1 deletion .github/workflows/book.yml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ jobs:

strategy:
matrix:
language: [en, ja, zh, pt-br, gl]
language: [en, ja, zh, pt-br, gl, es]

steps:
- uses: actions/checkout@v4
Expand Down
3 changes: 2 additions & 1 deletion .github/workflows/generate-mindmap.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ on:
- "pattern-categorization/package.json"
- "pattern-categorization/gl/*"
- "pattern-categorization/pt-br/*"
- "pattern-categorization/es/*"

defaults:
run:
Expand All @@ -27,7 +28,7 @@ jobs:

strategy:
matrix:
folder: [".", "./gl", "./pt-br"]
folder: [".", "./gl", "./pt-br", "./es"]

steps:
- uses: actions/checkout@v4
Expand Down
5 changes: 2 additions & 3 deletions .github/workflows/i18n-consistency-checker.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ jobs:
runs-on: ubuntu-latest
strategy:
matrix:
language: [ja, zh, pt-br, gl]
language: [ja, zh, pt-br, gl, es]
steps:
- uses: actions/checkout@v4
with:
Expand All @@ -24,7 +24,7 @@ jobs:
id: check-consistency
run: |
# Declare the flags
declare -A flags=( ["ja"]=":jp: Japanese" ["zh"]=":cn: Chinese" ["pt-br"]=":brazil: Brazilian Portuguese" ["gl"]="Galician")
declare -A flags=( ["ja"]=":jp: Japanese" ["zh"]=":cn: Chinese" ["pt-br"]=":brazil: Brazilian Portuguese" ["gl"]="Galician" ["es"]=":es: Spanish" )

issue_title="${flags['${{matrix.language}}']}: Content Consistency Issue"

Expand Down Expand Up @@ -86,4 +86,3 @@ jobs:
fi
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

1 change: 1 addition & 0 deletions TRUSTED-COMMITTERS.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@ While they don't take all responsibilities of a Trusted Committer (yet), they do
* Chinese - [@WillemJiang](https://github.com/WillemJiang)
* Brazilian Portuguese - [@jrcosta](https://github.com/jrcosta), [@zilio](https://github.com/zilio)
* Galician - [@psanxiao](https://github.com/psanxiao)
* Spanish - [@ovas04](https://github.com/ovas04)

## Hall of Fame (aka Alumni)

Expand Down
5 changes: 5 additions & 0 deletions book/es/.gitbook.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
root : ./

structure:
readme: introduction.md
summary: toc.md
31 changes: 31 additions & 0 deletions book/es/contribute.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# Contribuir a este libro

¿Quieres mejorar este libro? ¡Eso es increíble!

El libro de InnerSource Patterns en sí es un [proyecto de código abierto][repo], y da la bienvenida a cualquier forma de contribución. ¡Nada es demasiado pequeño!

No importa si deseas ayudarnos a corregir la gramática/ortografía, mejorar el diseño o contribuir con patrones completamente nuevos basados en las experiencias de InnerSource que has tenido en tu lugar de trabajo. ¡Nos encanta todo eso! :)

Si nunca has hecho una contribución a un proyecto de código abierto antes, debes saber que la comunidad de InnerSource Patterns es un grupo de personas amigables y, con eso, un lugar seguro para intentarlo.

## Antes de comenzar

Las fuentes de los InnerSource Patterns y este libro se mantienen en un repositorio en GitHub. Por lo tanto, necesitarás una cuenta de usuario de GitHub para hacer ediciones y sugerencias a este libro. Si aún no tienes una, dirígete a [github.com](https://github.com) y crea una cuenta de forma gratuita.

## Diferentes formas de contribuir

Aquí hay algunas formas en las que puedes contribuir:

1. corregir errores ortográficos, de formato u otros fallos que notes en este libro
2. mejorar el contenido de un patrón existente (por ejemplo, agregando una breve descripción de cómo estás utilizando un patrón como una _Instancia Conocida_)
3. contribuir con un nuevo patrón, describiendo cómo has superado desafíos relacionados con InnerSource en tu organización

Para los puntos (1) y (2), simplemente puedes hacer clic en el enlace **Edit on GitHub** que ves en la parte superior de cada página de este libro. Esto te llevará directamente al archivo respectivo en nuestro repositorio de GitHub, donde puedes sugerir tus cambios.

Para el punto (3) necesitas clonar el repositorio de [InnerSourcePatterns][repo], y agregar un nuevo archivo con tu patrón sugerido. Al hacer contribuciones más grandes a este libro, por favor revisa nuestro [CONTRIBUTING.md](../../CONTRIBUTING.md) y también nuestro [Manual del Contribuidor](../../meta/contributor-handbook.md).

## Licencia de Contribuciones

El contenido de este repositorio está licenciado bajo [CC-BY-SA-4.0](../../LICENSE.txt). Al contribuir a este repositorio, nos otorgas (y a todos los demás, para el caso) el derecho de usar tu contribución de acuerdo con esa licencia.

[repo]: https://github.com/InnerSourceCommons/InnerSourcePatterns
19 changes: 19 additions & 0 deletions book/es/explore-patterns.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# Explorar Patrones

¡Cada vez más patrones son contribuidos a este libro por la comunidad de InnerSource Commons! ¡Eso es increíble!

¿Ahora cómo hacer que sea fácil para los lectores descubrir los patrones que pueden ayudarlos en su situación particular?

Para este propósito proporcionamos este mapa mental. **Categoriza los patrones en función de las diferentes fases de un Programa InnerSource**, y los desafíos que pueden aparecer en las respectivas fases.

![Mapa Mental de InnerSource Patterns](../../pattern-categorization/es/innersource-program-mind-map.png)

## Mejorar este Mapa Mental

Si notas algo en este mapa mental que parece incorrecto, por favor [abre un issue](https://github.com/InnerSourceCommons/InnerSourcePatterns/issues), describiendo el problema y la solución que debería hacerse.

Además, si tienes otras ideas para mejorar la capacidad de descubrimiento de estos patrones, o quieres mejorar este mapa mental, revisa la documentación de nuestro enfoque de [Categorización de Patrones](https://github.com/InnerSourceCommons/InnerSourcePatterns/blob/main/pattern-categorization/README.md), y también consulta cómo [contribuir a este libro](contribute.md).

## Referencias

La idea de categorizar patrones de esta manera se basa libremente en una descripción en [Pensamientos sobre un Lenguaje de Patrones InnerSource](https://drive.google.com/file/d/13AY8glCOdpLOVuz7cVD6QOB8d2xbHCS1/view) por Tim Yao, Bob Hanmer y Padma Sudarsan (2018). Para detalles específicos, vea la diapositiva 15 en ese conjunto de diapositivas.
Binary file added book/es/innersource-patterns-book-cover.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
65 changes: 65 additions & 0 deletions book/es/introduction.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
# Introducción

![InnerSource Patterns book](innersource-patterns-book-cover.jpg)

{% hint style="info" %}
Puedes ayudarnos a crear el mejor libro posible sobre InnerSource Patterns :).
Aprende cómo [contribuir a este libro](contribute.md).
{% endhint %}

Bienvenido al **Libro de InnerSource Patterns**.

Este libro recopila las mejores prácticas de InnerSource en un formato específico para que sea fácil de entender, evaluar y aplicar en tu contexto. Llamamos a este formato un **patrón**.

La [Comunidad InnerSource Commons](http://innersourcecommons.org) ha recopilado estos patrones durante muchos años, publicando los patrones más maduros en este libro, donde los miembros de la comunidad revisan cada patrón, con al menos una instancia conocida de uso del patrón.

En esta introducción explicamos [qué es InnerSource](#qué-es-innersource), [qué es un patrón](#qué-son-los-innersource-patterns) y [cómo usar estos patrones](#cómo-puedes-usar-los-innersource-patterns) en tu organización.

Si ya estás utilizando InnerSource en tu empresa y deseas contribuir con tus experiencias a este libro, nos encantaría [darle la bienvenida a tus contribuciones](contribute.md)!

## ¿Qué es InnerSource?

Definimos InnerSource como:

> El uso de principios y prácticas de código abierto para el desarrollo de software dentro de los confines de una organización.

InnerSource toma las lecciones aprendidas del desarrollo de software de código abierto y las aplica a la forma en que las empresas desarrollan software internamente. A medida que los desarrolladores se han acostumbrado a trabajar en software de código abierto de clase mundial, existe un fuerte deseo de llevar esas prácticas de vuelta dentro del firewall y aplicarlas al software que las empresas pueden ser reacias a publicar.

Para las empresas que construyen principalmente software de código cerrado, InnerSource puede ser una gran herramienta para ayudar a romper los silos, fomentar y escalar la colaboración interna, acelerar la incorporación de nuevos ingenieros e identificar oportunidades para contribuir con software al mundo del código abierto.

## ¿Qué son los InnerSource Patterns?

Los patrones son una forma de describir una solución repetible y probada a un problema dentro de un contexto. Los patrones siguen una forma simple que te ayuda durante la implementación de una solución a entender las restricciones del problema, comprender las resistencias que necesitas equilibrar y el contexto resultante: la situación creada al aplicar la solución.

Los patrones pueden proporcionar una forma para que los participantes de InnerSource Commons compartan información de manera concisa, mejorando la práctica de InnerSource. Los patrones se dividen en Título, Declaración del Problema, Contexto, Resistencias y Soluciones como sus secciones principales.

* [`¿Qué son los patrones?` Videos de Youtube](http://bit.ly/innersource_patterns_videos) - Mira un conjunto de videos de youtube de 2-5 min que explican los InnerSource Patterns
* [Webinar de Discusión de Patrones](https://youtu.be/i-0IVhfRVFU) - Realizamos un webinar el 16-03-2017 para discutir en vivo un patrón de donut (ve a 24:30 para la discusión). Esta es una ilustración del proceso de revisión que seguimos. También vea el [Webinar de O'Reilly sobre InnerSource Patterns del 1 de junio de 2017](http://www.oreilly.com/pub/e/3884).
* [Plantilla de Patrones](../../meta/pattern-template.md) - Ve un esqueleto de patrón de InnerSource para tener una idea de lo que se incluye en un nuevo patrón!
* [Introducción a los InnerSource Patterns (presentación del Fall Summit 2016)](https://drive.google.com/open?id=0B7_9iQb93uBQbnlkdHNuUGhpTXc) - *Tim Yao y Padma Sudarsan* (PDF). Antecedentes detallados del patrón y ejemplos -- Obtén una comprensión detallada de por qué y cómo interactuar con nuestros patrones. También vea la [Introducción a los InnerSource Patterns (Fall Summit 2017)](https://drive.google.com/open?id=0B7_9iQb93uBQWmYwMFpyaGh4OFU) *Tim Yao y Bob Hanmer* (PDF).

## ¿Cómo puedes usar los InnerSource Patterns?

Los patrones deben usarse con cuidado. No se pueden aplicar indiscriminadamente. En la mayoría de los casos, necesitarás adaptar la solución dada a tu situación; pero la información proporcionada en el patrón, que define el contexto (restricciones inamovibles) y las resistencias (restricciones que se pueden cambiar y equilibrar entre sí), debería ayudarte a hacerlo. Ten en cuenta que también necesitarás determinar si hay restricciones adicionales (contexto de la empresa y resistencias de la empresa) que se aplican a tu empresa/organización en particular y que deben agregarse al patrón (como una especie de filtro). Estas restricciones adicionales pueden requerir pasos adicionales de solución para ser aplicados.

La forma del patrón es útil para describir soluciones probadas, pero también puede usarse para *brainstorming de nuevas soluciones* donde los patrones aún no están establecidos. Esto se debe a que la anatomía de un patrón proporciona un marco para pensar en un problema de manera estructurada. También podrías crear un *patrón de donut* (rellenando los campos de problema, contexto, resistencias y contexto resultante pero dejando la solución en blanco) como una forma de pedir ayuda a la comunidad de InnerSource Commons (para encontrar una solución probada o para generar ideas sobre cosas para probar).

## ¿Cómo Contribuir?

Por favor, consulta: [Contribuir a este libro](./contribute.md)

## Créditos

Este libro es el resultado de muchos años de trabajo de innumerables [Contribuidores de Código Abierto](https://github.com/InnerSourceCommons/InnerSourcePatterns/graphs/contributors) de todo el mundo. Su disposición a compartir abiertamente los desafíos que enfrentaron en sus empresas y cómo InnerSource les ha ayudado a abordar esos desafíos, hacen que este libro sea un recurso tan valioso para otros en su viaje de InnerSource.

Queremos mencionar específicamente al Grupo de Trabajo de InnerSource Patterns. Han fomentado la calidad de los InnerSource Patterns y han ayudado a otros a contribuir. Por último, también compilaron una selección de patrones disponibles en este libro.

La imagen de portada de este libro fue creada por [Sebastian Spier](https://spier.hu) y adaptada de una imagen de [Tony Hisgett - Alhambra 6](https://www.flickr.com/photos/hisgett/29345405788/), disponible bajo [CC BY 2.0](https://creativecommons.org/licenses/by/2.0/).

**¡Gracias a todos los contribuyentes! Y feliz Día de InnerSource :)**

## Licencia

![Licencia Creative Commons](https://i.creativecommons.org/l/by-sa/4.0/88x31.png)

InnerSourcePatterns por [InnerSourceCommons.org](http://innersourcecommons.org) está licenciado bajo una [Licencia Creative Commons Attribution-ShareAlike 4.0 International](http://creativecommons.org/licenses/by-sa/4.0/).
Loading
Loading