You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: _articles/best-practices.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -112,7 +112,7 @@ If you receive a contribution you don't want to accept, your first reaction migh
112
112
113
113
Don't leave an unwanted contribution open because you feel guilty or want to be nice. Over time, your unanswered issues and PRs will make working on your project feel that much more stressful and intimidating.
114
114
115
-
It's better to immediately close the contributions you know you don't want to accept. If your project already suffers from a large backlog, @steveklabnik has suggestions for [how to triage issues efficiently](http://words.steveklabnik.com/how-to-be-an-open-source-gardener).
115
+
It's better to immediately close the contributions you know you don't want to accept. If your project already suffers from a large backlog, @steveklabnik has suggestions for [how to triage issues efficiently](https://words.steveklabnik.com/how-to-be-an-open-source-gardener).
116
116
117
117
Secondly, ignoring contributions sends a negative signal to your community. Contributing to a project can be intimidating, especially if it's someone's first time. Even if you don't accept their contribution, acknowledge the person behind it and thank them for their interest. It's a big compliment!
118
118
@@ -188,7 +188,7 @@ If you need to step away from your project, either on hiatus or permanently, the
188
188
189
189
If other people are enthusiastic about its direction, give them commit access or formally hand over control to someone else. If someone forked your project and is actively maintaining it elsewhere, consider linking to the fork from your original project. It's great that so many people want your project to live on!
190
190
191
-
@progrium[found that](http://progrium.com/blog/2015/12/04/leadership-guilt-and-pull-requests/) documenting the vision for his project, [Dokku](https://github.com/dokku/dokku), helped those goals live on even after he stepped away from the project:
191
+
@progrium[found that](https://progrium.com/blog/2015/12/04/leadership-guilt-and-pull-requests/) documenting the vision for his project, [Dokku](https://github.com/dokku/dokku), helped those goals live on even after he stepped away from the project:
192
192
193
193
> I wrote a wiki page describing what I wanted and why I wanted it. For some reason it came as a surprise to me that the maintainers started moving the project in that direction! Did it happen exactly how I'd do it? Not always. But it still brought the project closer to what I wrote down.
Have you ever been to a (tech-) event where you didn't know anyone, but everyone else seemed to stand in groups and chat like old friends? (...) Now imagine you want to contribute to an open source project, but you don't see why or how this is happening.
60
60
<pmarkdown="1"class="pquote-credit">
61
-
— @janl, ["Sustainable Open Source"](http://writing.jan.io/2015/11/20/sustainable-open-source.html)
61
+
— @janl, ["Sustainable Open Source"](https://writing.jan.io/2015/11/20/sustainable-open-source.html)
62
62
</p>
63
63
</aside>
64
64
@@ -152,7 +152,7 @@ For example, here's how [Rubinius](https://github.com/rubinius/rubinius/) starts
Your leaders will have different opinions, as all healthy communities should! However, you need to take steps to ensure the loudest voice doesn't always win by tiring people out, and that less prominent and minority voices are heard.
154
154
<pmarkdown="1"class="pquote-credit">
155
-
— @sarahsharp, ["What makes a good community?"](http://sarah.thesharps.us/2015/10/06/what-makes-a-good-community/)
155
+
— @sarahsharp, ["What makes a good community?"](https://sarah.thesharps.us/2015/10/06/what-makes-a-good-community/)
156
156
</p>
157
157
</aside>
158
158
@@ -254,7 +254,7 @@ If a conversation clearly isn't going anywhere, there are no clear actions to be
Guiding a thread toward usefulness without being pushy is an art. It won't work to simply admonish people to stop wasting their time, or to ask them not to post unless they have something constructive to say. (...) Instead, you have to suggest conditions for further progress: give people a route, a path to follow that leads to the results you want, yet without sounding like you're dictating conduct.
Copy file name to clipboardExpand all lines: _articles/es/best-practices.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -110,7 +110,7 @@ Si recibes una contribución que no deseas aceptar, tu primera reacci&oacu
110
110
111
111
No dejes abierta una contribución no deseada porque te sientas culpable o quieras ser amable. Con el tiempo, tus issues sin respuesta y PRs hará que trabajar en tu proyecto se sienta mucho más estresante e intimidante.
112
112
113
-
Es mejor cerrar de inmediato las contribuciones que sabes que no quieres aceptar. Si tu proyecto ya sufre de un gran backlog o lista de funcionalidades a implementar, @steveklabnik tiene sugerencias para [cómo elegir issues de manera eficiente](http://words.steveklabnik.com/how-to-be-an-open-source-gardener).
113
+
Es mejor cerrar de inmediato las contribuciones que sabes que no quieres aceptar. Si tu proyecto ya sufre de un gran backlog o lista de funcionalidades a implementar, @steveklabnik tiene sugerencias para [cómo elegir issues de manera eficiente](https://words.steveklabnik.com/how-to-be-an-open-source-gardener).
114
114
115
115
En segundo lugar, ignorar las contribuciones envía una señal negativa a tu comunidad. Contribuir a un proyecto puede ser intimidante, especialmente si es la primera vez de alguien. Incluso si no aceptas su contribución, reconocer a la persona detrás de ella y agradecerles por su interés. ¡Es un gran cumplido!
116
116
@@ -186,7 +186,7 @@ Si necesitas alejarte de tu proyecto, ya sea por un tiempo o permanentemente, no
186
186
187
187
Si otras personas son entusiastas acerca de la dirección del proyecto, dales permiso para relizar commits o formalmente entrégale el control a alguien más. Si alguien realizó un fork de tu proyecto y lo está manteniendo activamente en otro lugar, considera enlazar el fork desde tu proyecto original. ¡Es genial que tantas personas quieran que tu proyecto crezca!
188
188
189
-
@progrium[encontró que](http://progrium.com/blog/2015/12/04/leadership-guilt-and-pull-requests/) documentar la visión de su proyecto, [Dokku](https://github.com/dokku/dokku), ayudó a esos objetivos a perdurar, incluso después de que se alejó del proyecto:
189
+
@progrium[encontró que](https://progrium.com/blog/2015/12/04/leadership-guilt-and-pull-requests/) documentar la visión de su proyecto, [Dokku](https://github.com/dokku/dokku), ayudó a esos objetivos a perdurar, incluso después de que se alejó del proyecto:
190
190
191
191
> Escribí una página wiki describiendo lo que quería y por qué lo quería. ¡Por alguna razón me sorprendió que los mantenedores comenzaran a mover el proyecto en esa dirección! ¿Sucedió exactamente cómo lo haría? No siempre. Pero aún así acercó el proyecto a lo que quería.
192
192
@@ -205,7 +205,7 @@ Hacer fork de un proyecto no tiene por qué ser una cosa mala. Ser capaz d
205
205
</aside>
206
206
207
207
Lo mismo se aplica a un usuario que realmente quiere una solución que simplemente no tienes el alcance para construir. Ofrecer APIs y hooks personalizables puede ayudar a otros a satisfacer sus propias necesidades, sin tener que modificar la fuente directamente.
208
-
@orta[encontró que](http://artsy.github.io/blog/2016/07/03/handling-big-projects/) alentando plugins para CocoaPods llevó a "algunas de las ideas más interesantes":
208
+
@orta[encontró que](https://artsy.github.io/blog/2016/07/03/handling-big-projects/) alentando plugins para CocoaPods llevó a "algunas de las ideas más interesantes":
209
209
210
210
> Es casi inevitable que una vez que un proyecto se hace grande, los mantenedores tienen que ser mucho más conservadores sobre cómo introducir nuevo código. Te vuelves bueno en decir "no", pero muchas personas tienen necesidades legítimas. Por lo tanto, en su lugar terminas convirtiendo tu herramienta en una plataforma.
211
211
@@ -228,7 +228,7 @@ Si agregas testing, asegúrate de explicar cómo funcionan en su arc
Creo que las pruebas son necesarias para todo código en el que la gente trabaja. Si el código era totalmente y perfectamente correcto, no necesitaría cambios - sólo escribimos código cuando algo está mal, ya sea "Se bloquea" o "Falta tal o cual característica". Independientemente de los cambios que estés haciendo, las pruebas son esenciales para capturar cualquier regresión que pueda introducir accidentalmente.
230
230
<pmarkdown="1"class="pquote-credit">
231
-
— @edunham, ["Automatización de la comunidad de Rust"](http://edunham.net/2016/09/27/rust_s_community_automation.html)
231
+
— @edunham, ["Automatización de la comunidad de Rust"](https://edunham.net/2016/09/27/rust_s_community_automation.html)
¿Alguna vez viste un evento (técnico) en donde no conozcas a nadie, pero todos los demás parece que se encuentran en grupos y conversan como viejos amigos? (...) Ahora imagínate queriendo contribuir con un proyecto de código abierto, pero no distingues porqué o cómo esto está sucediendo.
@@ -153,7 +153,7 @@ Por ejemplo, así es como [Rubinius](https://github.com/rubinius/rubinius/
153
153
Los líderes tendrán diferentes opiniones, como debería ocurrir en todas las comunidades saludables. De todos modos, necesitas tomar algunas medidas para asegurar que las voces más potentes no ganen siempre por haber cansado a los demás, y que también se escuchen las voces menos potentes y minoritarias.
154
154
155
155
<pmarkdown="1"class="pquote-credit">
156
-
— @sarahsharp, ["What makes a good community?"](http://sarah.thesharps.us/2015/10/06/what-makes-a-good-community/)
156
+
— @sarahsharp, ["What makes a good community?"](https://sarah.thesharps.us/2015/10/06/what-makes-a-good-community/)
157
157
</p>
158
158
</aside>
159
159
@@ -169,7 +169,7 @@ Observa si puedes encontrar maneras de compartir la propiedad de tu comunidad ta
169
169
170
170
* Si tienes una comunidad considerable, **envía un boletín o escribe un post en un blog** agradeciendo a los colaboradores. Rust's [This Week in Rust](https://this-week-in-rust.org/) y Hoodie's [Shoutouts](http://hood.ie/blog/shoutouts-week-24.html) son dos buenos ejemplos.
171
171
172
-
***Da a cada colaborador permiso para hacer commit.**@felixge encontró con esto que las personas [se entusiasmaran por pulir sus parches](http://felixge.de/2013/03/11/the-pull-request-hack.html), e incluso encontró nuevas personas para mantener proyectos en los que no había trabajado hace tiempo.
172
+
***Da a cada colaborador permiso para hacer commit.**@felixge encontró con esto que las personas [se entusiasmaran por pulir sus parches](https://felixge.de/2013/03/11/the-pull-request-hack.html), e incluso encontró nuevas personas para mantener proyectos en los que no había trabajado hace tiempo.
173
173
174
174
175
175
* Si tu proyecto está alojado en GitHub, **mueve tu proyecto desde tu cuenta personal hacia una [Organización](https://help.github.com/articles/creating-a-new-organization-account/)** y agrega al menos un administrador de respaldo. Las Organizaciones hacen que sea más fácil trabajar en proyectos con colaboradores externos.
@@ -221,7 +221,7 @@ Tu README es [más que un conjunto de instrucciones](../starting-a-project
221
221
222
222
Algunos proyectos utilizan un proceso de votación para tomar decisiones importantes. Si bien parece sensato a primera vista, la votación pone hincapié en una "respuesta", más que en escuchar y tratar las preocupaciones de cada uno.
223
223
224
-
La votación se puede volver política, cuando los miembros de la comunidad se sienten presionados para hacerse favores entre ellos o a votar de determinada manera. No todos votan, si existe una [mayoría silenciosa](http://ben.balter.com/2016/03/08/optimizing-for-power-users-and-edge-cases/#the-silent-majority-of-users) en tu comunidad, o existen usuarios que no se enteraron que se estaba llevando a cabo una votación.
224
+
La votación se puede volver política, cuando los miembros de la comunidad se sienten presionados para hacerse favores entre ellos o a votar de determinada manera. No todos votan, si existe una [mayoría silenciosa](https://ben.balter.com/2016/03/08/optimizing-for-power-users-and-edge-cases/#the-silent-majority-of-users) en tu comunidad, o existen usuarios que no se enteraron que se estaba llevando a cabo una votación.
225
225
226
226
Algunas veces, la votación se vuelve un desempate necesario. La mayoría de las veces, sin embargo, pone énfasis en la ["búsqueda de concenso"](https://en.wikipedia.org/wiki/Consensus-seeking_decision-making) más que en concensuar.
227
227
@@ -257,7 +257,7 @@ Si la conversación claramente no va a ningún lado, no existen acci
Guiar un tópico hacia algo útil sin ser agresivo es un arte. No funcionará simplemente con llamar la atención a las personas para impedir que continúen perdiendo tiempo, ni pedirles que no publiquen a menos que tengan algo constructivo que decir. (...) En su lugar, debes sugerir condiciones para continuar progresando: brinda a las personas una ruta, un camino a seguir que los lleve al resultado que quieres, pero sin aparentar que les estás dictando una conducta.
Para una vista más profunda sobre cómo comunicar tu mensaje, puedes ver el ejercicio en Mozilla ["Personas and Pathways"](http://mozillascience.github.io/working-open-workshop/personas_pathways/) para el desarrollo de personas usuario.
36
+
Para una vista más profunda sobre cómo comunicar tu mensaje, puedes ver el ejercicio en Mozilla ["Personas and Pathways"](https://mozillascience.github.io/working-open-workshop/personas_pathways/) para el desarrollo de personas usuario.
37
37
38
38
## Ayuda a las personas a encontrar y seguir tu proyecto
39
39
@@ -71,13 +71,13 @@ Ahora que ya tienes un mensaje para tu proyecto, y una manera sencilla para que
71
71
72
72
El alcance en línea es una gran manera de compartir y diseminar la palabra rápidamente
73
73
74
-
Saca ventaja de las comunidades en línea existentes y sus plataformas para alcanzar tu audiencia. Si tu proyecto es de codigo abierto es un proyecto de software, probablemente puedas encontrar tu audiencia en [Stack Overflow](http://stackoverflow.com/), [reddit](http://www.reddit.com), [Hacker News](https://news.ycombinator.com/), o [Quora](https://www.quora.com/). Encuentra los canales donde pienses que las personas obtendrán los mayores beneficios o se sentirán más entusiasmadas acerca de tu trabajo.
74
+
Saca ventaja de las comunidades en línea existentes y sus plataformas para alcanzar tu audiencia. Si tu proyecto es de codigo abierto es un proyecto de software, probablemente puedas encontrar tu audiencia en [Stack Overflow](https://stackoverflow.com/), [reddit](https://www.reddit.com), [Hacker News](https://news.ycombinator.com/), o [Quora](https://www.quora.com/). Encuentra los canales donde pienses que las personas obtendrán los mayores beneficios o se sentirán más entusiasmadas acerca de tu trabajo.
Cada programa tiene funciones muy específicas, que solamente una fracción de los usuarios encontra útil. No envíes masivamente correo a todas las personas posibles. En su lugar, enfoca tus esfuerzos en comunidades que se beneficiarán de conocer sobre tu trabajo.
79
79
<pmarkdown="1"class="pquote-credit">
80
-
— @pazdera, ["Marketing for open source projects"](http://radek.io/2015/09/28/marketing-for-open-source-projects-3/)
80
+
— @pazdera, ["Marketing for open source projects"](https://radek.io/2015/09/28/marketing-for-open-source-projects-3/)
81
81
</p>
82
82
</aside>
83
83
@@ -97,7 +97,7 @@ Si nadie presta atención o responde a tu alcance inicial, ¡no te desanim
97
97
98
98
Los eventos fuera de línea son una manera popular de promocionar nuevos proyectos. Es una gran manera de alcanzar una audiencia comprometida y de construir conexiones personales más profundas, especialmente si estás interesado en llegar a los desarrolladores.
99
99
100
-
Si no tienes [experiencia para hablar en público](http://speaking.io/), comienza por encontrar una comunidad local de personas que estén relacionados con el lenguaje o ecosistema de tu proyecto.
100
+
Si no tienes [experiencia para hablar en público](https://speaking.io/), comienza por encontrar una comunidad local de personas que estén relacionados con el lenguaje o ecosistema de tu proyecto.
0 commit comments