Skip to content

Commit d2a97eb

Browse files
ovas04Oscar Lobatonrmarting
authored
Translation of the book to Spanish (#785)
* Add Spanish templates for README and CONTRIBUTING documentation * Add Spanish translations and resources for all patterns * Update GitHub Action workflows * Generate TOC for Spanish * Regenerate HTML and PNG file for Spanish mindmap --------- Co-authored-by: Oscar Lobaton <[email protected]> Co-authored-by: Jose Roman Martin Gil <[email protected]>
1 parent 968c22e commit d2a97eb

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

45 files changed

+3278
-7
lines changed

.github/CODEOWNERS

+2
Original file line numberDiff line numberDiff line change
@@ -20,3 +20,5 @@
2020
/translation/gl/ @psanxiao
2121
/book/gl/ @psanxiao
2222
/pattern-categorization/gl/ @psanxiao
23+
/translation/es/ @ovas04
24+
/book/es/ @ovas04

.github/workflows/book.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ jobs:
1515

1616
strategy:
1717
matrix:
18-
language: [en, ja, zh, pt-br, gl]
18+
language: [en, ja, zh, pt-br, gl, es]
1919

2020
steps:
2121
- uses: actions/checkout@v4

.github/workflows/generate-mindmap.yml

+2-1
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ on:
1212
- "pattern-categorization/package.json"
1313
- "pattern-categorization/gl/*"
1414
- "pattern-categorization/pt-br/*"
15+
- "pattern-categorization/es/*"
1516

1617
defaults:
1718
run:
@@ -27,7 +28,7 @@ jobs:
2728

2829
strategy:
2930
matrix:
30-
folder: [".", "./gl", "./pt-br"]
31+
folder: [".", "./gl", "./pt-br", "./es"]
3132

3233
steps:
3334
- uses: actions/checkout@v4

.github/workflows/i18n-consistency-checker.yaml

+2-3
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ jobs:
1515
runs-on: ubuntu-latest
1616
strategy:
1717
matrix:
18-
language: [ja, zh, pt-br, gl]
18+
language: [ja, zh, pt-br, gl, es]
1919
steps:
2020
- uses: actions/checkout@v4
2121
with:
@@ -24,7 +24,7 @@ jobs:
2424
id: check-consistency
2525
run: |
2626
# Declare the flags
27-
declare -A flags=( ["ja"]=":jp: Japanese" ["zh"]=":cn: Chinese" ["pt-br"]=":brazil: Brazilian Portuguese" ["gl"]="Galician")
27+
declare -A flags=( ["ja"]=":jp: Japanese" ["zh"]=":cn: Chinese" ["pt-br"]=":brazil: Brazilian Portuguese" ["gl"]="Galician" ["es"]=":es: Spanish" )
2828
2929
issue_title="${flags['${{matrix.language}}']}: Content Consistency Issue"
3030
@@ -86,4 +86,3 @@ jobs:
8686
fi
8787
env:
8888
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
89-

TRUSTED-COMMITTERS.md

+1
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ While they don't take all responsibilities of a Trusted Committer (yet), they do
2626
* Chinese - [@WillemJiang](https://github.com/WillemJiang)
2727
* Brazilian Portuguese - [@jrcosta](https://github.com/jrcosta), [@zilio](https://github.com/zilio)
2828
* Galician - [@psanxiao](https://github.com/psanxiao)
29+
* Spanish - [@ovas04](https://github.com/ovas04)
2930

3031
## Hall of Fame (aka Alumni)
3132

book/es/.gitbook.yaml

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
root : ./
2+
3+
structure:
4+
readme: introduction.md
5+
summary: toc.md

book/es/contribute.md

+31
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Contribuir a este libro
2+
3+
¿Quieres mejorar este libro? ¡Eso es increíble!
4+
5+
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!
6+
7+
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! :)
8+
9+
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.
10+
11+
## Antes de comenzar
12+
13+
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.
14+
15+
## Diferentes formas de contribuir
16+
17+
Aquí hay algunas formas en las que puedes contribuir:
18+
19+
1. corregir errores ortográficos, de formato u otros fallos que notes en este libro
20+
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_)
21+
3. contribuir con un nuevo patrón, describiendo cómo has superado desafíos relacionados con InnerSource en tu organización
22+
23+
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.
24+
25+
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).
26+
27+
## Licencia de Contribuciones
28+
29+
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.
30+
31+
[repo]: https://github.com/InnerSourceCommons/InnerSourcePatterns

book/es/explore-patterns.md

+19
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Explorar Patrones
2+
3+
¡Cada vez más patrones son contribuidos a este libro por la comunidad de InnerSource Commons! ¡Eso es increíble!
4+
5+
¿Ahora cómo hacer que sea fácil para los lectores descubrir los patrones que pueden ayudarlos en su situación particular?
6+
7+
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.
8+
9+
![Mapa Mental de InnerSource Patterns](../../pattern-categorization/es/innersource-program-mind-map.png)
10+
11+
## Mejorar este Mapa Mental
12+
13+
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.
14+
15+
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).
16+
17+
## Referencias
18+
19+
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.
298 KB
Loading

book/es/introduction.md

+65
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
# Introducción
2+
3+
![InnerSource Patterns book](innersource-patterns-book-cover.jpg)
4+
5+
{% hint style="info" %}
6+
Puedes ayudarnos a crear el mejor libro posible sobre InnerSource Patterns :).
7+
Aprende cómo [contribuir a este libro](contribute.md).
8+
{% endhint %}
9+
10+
Bienvenido al **Libro de InnerSource Patterns**.
11+
12+
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**.
13+
14+
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.
15+
16+
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.
17+
18+
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)!
19+
20+
## ¿Qué es InnerSource?
21+
22+
Definimos InnerSource como:
23+
24+
> El uso de principios y prácticas de código abierto para el desarrollo de software dentro de los confines de una organización.
25+
26+
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.
27+
28+
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.
29+
30+
## ¿Qué son los InnerSource Patterns?
31+
32+
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.
33+
34+
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.
35+
36+
* [`¿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
37+
* [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).
38+
* [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!
39+
* [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).
40+
41+
## ¿Cómo puedes usar los InnerSource Patterns?
42+
43+
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.
44+
45+
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).
46+
47+
## ¿Cómo Contribuir?
48+
49+
Por favor, consulta: [Contribuir a este libro](./contribute.md)
50+
51+
## Créditos
52+
53+
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.
54+
55+
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.
56+
57+
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/).
58+
59+
**¡Gracias a todos los contribuyentes! Y feliz Día de InnerSource :)**
60+
61+
## Licencia
62+
63+
![Licencia Creative Commons](https://i.creativecommons.org/l/by-sa/4.0/88x31.png)
64+
65+
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/).

0 commit comments

Comments
 (0)