Skip to content

Commit c25ca4f

Browse files
authored
add es/community/ruby-core (#2708)
* add es/community/ruby-core * Remove blank line at the end of the file * Attend pr comments
1 parent 8f1aee2 commit c25ca4f

File tree

2 files changed

+183
-0
lines changed

2 files changed

+183
-0
lines changed

es/community/ruby-core/index.md

+136
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,136 @@
1+
---
2+
layout: page
3+
title: "Ruby Core"
4+
lang: es
5+
---
6+
7+
Ahora es un momento fantástico para seguir el desarrollo de Ruby.
8+
Con la mayor atención que Ruby ha recibido en los últimos años,
9+
existe una creciente necesidad de buenos talentos para ayudar a mejorar Ruby
10+
y documentar sus partes. Entonces, ¿por dónde empezar?
11+
{: .summary}
12+
13+
Los temas relacionados con el desarrollo de Ruby que se tratan aquí son:
14+
15+
* [Usando Git para rastrear el desarrollo de Ruby](#following-ruby)
16+
* [Mejorando Ruby, Parche por Parche](#patching-ruby)
17+
* [Nota sobre las ramas](#branches-ruby)
18+
19+
### Usando Git para rastrear el desarrollo de Ruby
20+
{: #following-ruby}
21+
22+
El repositorio principal actual del último código fuente de Ruby es
23+
[git.ruby-lang.org/ruby.git][gitrlo].
24+
También existe un repositorio [espejo en GitHub][7]. En lo general, usa el
25+
repositorio espejo, por favor.
26+
27+
Puedes obtener el último código fuente de Ruby usando Git.
28+
Desde tu línea de comandos:
29+
30+
{% highlight sh %}
31+
$ git clone https://github.com/ruby/ruby.git
32+
{% endhighlight %}
33+
34+
El directorio `ruby` ahora contendrá el último código fuente
35+
para la versión de desarrollo de Ruby (ruby-trunk).
36+
37+
Vease también [Cómo unirse a nuestro desarrollo como no contribuyente de código fuente][noncommitterhowto].
38+
39+
Si tienes permisos de contribución al código fuente y deseas empujar cambios,
40+
deberías usar el repositorio principal.
41+
42+
{% highlight sh %}
43+
$ git clone [email protected]:ruby.git
44+
{% endhighlight %}
45+
46+
### Mejorando Ruby, Parche por Parche
47+
{: #patching-ruby}
48+
49+
El equipo central mantiene un [rastreador de problemas][10] para enviar parches e
50+
informes de errores a Matz y al grupo. Estos informes también se envían a
51+
la [lista de distribución de Ruby-Core][mailing-lists] para discusión,
52+
así que puedes estar seguro que tu petición no pasará desapercibida.
53+
También puedes enviar tus parches directamente a la lista de
54+
distribución. De cualquier manera, te invitamos a formar parte de las
55+
discusiones siguientes.
56+
57+
Consulta la [Guía del redactor de Parches][writing-patches] para obtener algunos consejos,
58+
directamente de Matz, sobre cómo hacer que tus parches sean considerados.
59+
60+
En resumen, los pasos para crear un parche son:
61+
62+
1. Consulta una copia del código fuente de Ruby de GitHub.
63+
Por lo general, los parches para la corrección de errores
64+
o las nuevas funciones deben enviarse al tronco de la fuente de Ruby.
65+
66+
$ git clone https://github.com/ruby/ruby.git
67+
68+
Si estás solucionando un error que es específico de una sola rama de mantenimiento,
69+
revisa una copia de la rama respectiva.
70+
71+
$ git checkout ruby_X_X
72+
73+
X_X debe ser reemplazado por la versión que desees revisar.
74+
75+
2. Agrega tus mejoras al código.
76+
77+
3. Crea un parche.
78+
79+
$ git diff > ruby-changes.patch
80+
81+
4. Crea un ticket en el [rastreador de problemas][10] o envía tu parche
82+
a la [lista de distribución de Ruby-Core][mailing-lists] con un registro de ChangeLog
83+
describiendo tu parche.
84+
85+
5. Si no surgen problemas sobre el parche, los contribuyentes darán
86+
la aprobación para aplicarlo.
87+
88+
**Por favor ten en cuenta:** los parches deben enviarse como una [diferencia unificada][12].
89+
Para obtener más información sobre cómo se fusionan los parches, consulta [la referencia de diffutils][13].
90+
91+
La discusión sobre el desarrollo de Ruby converge en la
92+
[Lista de distribución de Ruby-Core][mailing-lists]. Entonces, si tienes curiosidad
93+
sobre si tu parche vale la pena o si deseas iniciar una discusión
94+
sobre el futuro de Ruby, no dudes en subir a bordo.
95+
Ten presente que las discusiones fuera de tema no se toleran en esta lista,
96+
el nivel de ruido debe ser muy bajo, los temas deben ser puntuales, bien concebidos y
97+
bien escritos. Ya que nos dirigimos al creador de Ruby, tengamos un poco de reverencia.
98+
99+
Ten en cuenta que muchos de los desarrolladores principales de Ruby viven en Japón y, aunque muchos
100+
hablan muy bien inglés, hay una diferencia de zona horaria significativa.
101+
También tienen un cuerpo completo de listas de desarrollo japonesas sucediendo
102+
junto a las contrapartes inglesas. Se paciente,
103+
si tu petición no se resuelve, se persistente, inténtalo de nuevo unos días más tarde.
104+
105+
106+
### Nota sobre las ramas
107+
{: #branches-ruby}
108+
109+
El código fuente de Ruby se había gestionado en el repositorio de Subversion hasta el 22 de abril de 2019.
110+
Por lo tanto, algunas ramas aún pueden administrarse bajo Subversion.
111+
Puedes ver el repositorio de SVN.
112+
113+
* [<URL:https://svn.ruby-lang.org/cgi-bin/viewvc.cgi?root=ruby>][svn-viewvc]
114+
115+
Sin embargo, no tienes que preocuparte por eso (a menos que seas un mantenedor de rama).
116+
Puedes consultar las ramas en tu copia de trabajo de Git.
117+
Por ejemplo, ejecuta el siguiente comando.
118+
119+
{% highlight sh %}
120+
$ git checkout ruby_X_X
121+
{% endhighlight %}
122+
123+
X_X debe ser reemplazado por la versión que desees revisar.
124+
125+
Si deseas modificar las ramas, por favor, abre una incidencia en nuestro [rastreador de problemas][10].
126+
Ver también la siguiente sección.
127+
128+
[gitrlo]: https://git.ruby-lang.org/ruby.git
129+
[mailing-lists]: /es/community/mailing-lists/
130+
[writing-patches]: /es/community/ruby-core/writing-patches/
131+
[noncommitterhowto]: https://github.com/shyouhei/ruby/wiki/noncommitterhowto
132+
[svn-viewvc]: https://svn.ruby-lang.org/cgi-bin/viewvc.cgi?root=ruby
133+
[7]: https://github.com/ruby/ruby
134+
[10]: https://bugs.ruby-lang.org/
135+
[12]: http://www.gnu.org/software/diffutils/manual/html_node/Unified-Format.html
136+
[13]: http://www.gnu.org/software/diffutils/manual/html_node/Merging-with-patch.html#Merging%20with%20patch
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
layout: page
3+
title: "Guía del redactor de Parches"
4+
lang: es
5+
---
6+
Sigue algunos consejos, directamente de Matz, sobre cómo hacer para que tus parches sean considerados.
7+
{: .summary}
8+
9+
Estas pautas fueron adoptadas de una [publicación hecha por Matz][ruby-core-post]
10+
en la lista de distribución de Ruby-Core:
11+
12+
* Implementa una modificación por parche
13+
14+
Este es el mayor problema para la mayoría de los parches diferidos. Cuando tú
15+
envias un parche que corrija varios errores (y agregue funciones) a la vez,
16+
tenemos que separarlos antes de aplicarlos. Es una tarea bastante difícil para nosotros,
17+
desarrolladores ocupados, por lo que este tipo de parches tiende a aplazarse.
18+
Por favor, no envies parches grandes.
19+
20+
* Agrega descripciones
21+
22+
A veces, un simple parche no describe suficientemente el problema que soluciona.
23+
Una mejor descripción (el problema que soluciona, las condiciones previas, la plataforma, etc.)
24+
ayudaría a un parche a aplicarse más rápido.
25+
26+
* Haz diff a la última revisión
27+
28+
Es posible que tu problema se haya solucionado en la última revisión. O el código
29+
podría ser totalmente diferente a estas alturas. Antes de enviar un parche, intenta recuperar
30+
la última versión (la rama `trunk` para la última versión de desarrollo,
31+
`{{ site.svn.stable.branch }}` para {{ site.svn.stable.version }})
32+
desde el repositorio de Subversion, por favor.
33+
34+
* Usa `diff -u`
35+
36+
Preferimos los parches de diferencias unificados de estilo `diff -u` a diferencia de `diff -c`
37+
o cualquier otro estilo de parches. Son mucho más fáciles de revisar.
38+
No envíes archivos modificados, no queremos hacer un diff por nosotros mismos.
39+
40+
* Proporciona casos de prueba (opcional)
41+
42+
Un parche que proporciona casos de prueba (preferiblemente un parche para `test/*/test_*.rb`)
43+
nos ayudaría a comprender el parche y su intención.
44+
45+
Podríamos pasar a un flujo de trabajo push/pull estilo Git en el futuro..
46+
Pero hasta entonces, seguir las pautas anteriores te ayudaría a evitar
47+
una frustración.

0 commit comments

Comments
 (0)