-
Notifications
You must be signed in to change notification settings - Fork 10
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
Translated chapter 2 to Spanish. #44
Conversation
Added a link to the spanish version of chapter 2.
Hi @Alux6 and sorry for the delay ! It's a very good work, we will check it as soon 🙏 |
Deleted a wrong line break
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi, I add comments, but it's a good job and thanks to contribute on this project ! 🙏
@@ -0,0 +1,71 @@ | |||
# Preparar tu proyecto para que sea de código abierto. | |||
|
|||
En un [artículo anterior](Link to previous article/Link al artículo anterior), te ayudamos a presentar tu primera contribución. ¿Quieres lanzar tu propio proyecto de Código Abierto pero no sabes qué hacer antes de permitir que todo el mundo vea tu código? No te preocupes, en este artículo te daremos todos los requisitos previos que necesitas para lanzar tu proyecto. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
En un [artículo anterior](Link to previous article/Link al artículo anterior), te ayudamos a presentar tu primera contribución. ¿Quieres lanzar tu propio proyecto de Código Abierto pero no sabes qué hacer antes de permitir que todo el mundo vea tu código? No te preocupes, en este artículo te daremos todos los requisitos previos que necesitas para lanzar tu proyecto. | |
En un [artículo anterior](Link to previous article/Enlace al artículo anterior), te ayudamos a presentar tu primera contribución. ¿Quieres lanzar tu propio proyecto de Código Abierto pero no sabes qué hacer antes de permitir que todo el mundo vea tu código? No te preocupes, en este artículo te daremos todos los requisitos previos para lanzar tu proyecto con toda serenidad. |
|
||
## Requisitos previos | ||
|
||
Si quieres que tu proyecto tenga contribuciones necesitas escribir al menos alguna documentación. Hay cuatro archivos esenciales: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Si quieres que tu proyecto tenga contribuciones necesitas escribir al menos alguna documentación. Hay cuatro archivos esenciales: | |
Si quieres que tu proyecto tenga contribuciones necesitas escribir un mínimo de documentación. Hay cuatro archivos esenciales: |
|
||
Mike McQuaid teorizó sobre ["contributor funnel" de Código Abierto](https://mikemcquaid.com/2018/08/14/the-open-source-contributor-funnel-why-people-dont-contribute-to-your-open-source-project/) y cómo conseguir contribuyentes en tus proyectos de Código Abierto. Necesitas proporcionar información para todos los tipos de visitantes (_usuarios_, _contribuyentes_, _mantenedores_) en tu readme. | ||
|
||
La descripción de tu proyecto y los primeros párrafos de tu readme deberían ser un resumen simple de tu proyecto y contener todas las palabras clave que la gente va a buscar. -- [Andrey Petrov](https://medium.com/code-zen/how-to-maintain-a-successful-open-source-project-aaa2a5437d3a) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
La descripción de tu proyecto y los primeros párrafos de tu readme deberían ser un resumen simple de tu proyecto y contener todas las palabras clave que la gente va a buscar. -- [Andrey Petrov](https://medium.com/code-zen/how-to-maintain-a-successful-open-source-project-aaa2a5437d3a) | |
La descripción de tu proyecto y los primeros párrafos de tu readme deberían ser un resumen rapido del proyecto y, sobretodo, contener todas las palabras clave que la gente va a buscar. -- [Andrey Petrov](https://medium.com/code-zen/how-to-maintain-a-successful-open-source-project-aaa2a5437d3a) | |
|
||
La descripción de tu proyecto y los primeros párrafos de tu readme deberían ser un resumen simple de tu proyecto y contener todas las palabras clave que la gente va a buscar. -- [Andrey Petrov](https://medium.com/code-zen/how-to-maintain-a-successful-open-source-project-aaa2a5437d3a) | ||
|
||
Para empezar, nadie puede leerte la mente. Deberías explicar los objetivos de tu proyecto. No tiene que ser un ensayo, una sola frase es lo suficientemente buena, como en [El readme de Conference Hall’s](https://github.com/bpetetot/conference-hall): |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Para empezar, nadie puede leerte la mente. Deberías explicar los objetivos de tu proyecto. No tiene que ser un ensayo, una sola frase es lo suficientemente buena, como en [El readme de Conference Hall’s](https://github.com/bpetetot/conference-hall): | |
Para empezar, ten en cuenta que nadie puede leerte la mente. Deberás explicar los objetivos de tu proyecto claramente. No tiene que ser un ensayo, una sola frase impactante puede ser suficiente , como en [El readme de Conference Hall’s](https://github.com/bpetetot/conference-hall): |
|
||
Para empezar, nadie puede leerte la mente. Deberías explicar los objetivos de tu proyecto. No tiene que ser un ensayo, una sola frase es lo suficientemente buena, como en [El readme de Conference Hall’s](https://github.com/bpetetot/conference-hall): | ||
|
||
> Conference Hall es una plataforma abierta del tipo Software Como Servicio (SaaS) para administrar Convocatorias A Publicar (CFP) y presentaciones del ponente para tus conferencias y meetups. Como ponente escribes una charla una vez y la presentas en cada evento que quieras, dentro de la plataforma. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
> Conference Hall es una plataforma abierta del tipo Software Como Servicio (SaaS) para administrar Convocatorias A Publicar (CFP) y presentaciones del ponente para tus conferencias y meetups. Como ponente escribes una charla una vez y la presentas en cada evento que quieras, dentro de la plataforma. | |
> Conference Hall es una plataforma abierta,tipo Software Como Servicio (SaaS), para administrar Convocatorias A Publicar (CFP) y presentaciones del speaker/presentador.a para tus conferencias y meetups. El objectivo es centralizar para los speakers la presentacion de sus conférencias/talks, escribirlas una sola vez y postular a multiples CFP en Conference Hall. |
|
||
Antes hablamos sobre "El 'contributor funnel' de código abierto" en nuestro readme. Dimos documentación para ayudar a los _usuarios_ para instalar y utilizar tu proyecto. Ahora nos centraremos en los _contribuyentes_. La guía de contribución está diseñada para dar instrucciones a cualquiera que quiera participar en tu proyecto. | ||
|
||
La mayoría de las contribuciones las hacen los usuarios que encuentran un problema usando tu proyecto. Está bien añadir instrucciones sobre cómo reportar un bug o sugerir nuevas características. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
La mayoría de las contribuciones las hacen los usuarios que encuentran un problema usando tu proyecto. Está bien añadir instrucciones sobre cómo reportar un bug o sugerir nuevas características. | |
La mayoría de las contribuciones las hacen los usuarios que encuentran un problema usando tu proyecto. Te recomendamos añadir instrucciones sobre cómo reportar un bug o sugerir nuevas características. |
|
||
La mayoría de las contribuciones las hacen los usuarios que encuentran un problema usando tu proyecto. Está bien añadir instrucciones sobre cómo reportar un bug o sugerir nuevas características. | ||
|
||
Si quieres que la gente contribuya al código necesitas proveer todos los detalles de cómo configurar el entorno de desarrollo del proyecto y cómo enviar contribuciones. la [guía de contribución de Moncha](https://github.com/mochajs/mocha/blob/master/.github/CONTRIBUTING.md#shoe-contributing-code-step-by-step) es un buen ejemplo de instrucciones dadas paso por paso para fusionar tus contribuciones. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Si quieres que la gente contribuya al código necesitas proveer todos los detalles de cómo configurar el entorno de desarrollo del proyecto y cómo enviar contribuciones. la [guía de contribución de Moncha](https://github.com/mochajs/mocha/blob/master/.github/CONTRIBUTING.md#shoe-contributing-code-step-by-step) es un buen ejemplo de instrucciones dadas paso por paso para fusionar tus contribuciones. | |
Si quieres que la gente contribuya al código, necesitas proveer todos los detalles de cómo configurar el entorno de desarrollo del proyecto y cómo enviar contribuciones. la [guía de contribución de Moncha](https://github.com/mochajs/mocha/blob/master/.github/CONTRIBUTING.md#shoe-contributing-code-step-by-step) es un buen ejemplo de instrucciones dadas paso por paso para fusionar tus contribuciones. |
|
||
## Código de conducta | ||
|
||
Tener un CODE_OF_CONDUCT.md en tus repositorios públicos permite saber por adelantado a los potenciales _contribuyentes_ qué trato esperar por parte de la comunidad y los _mantenedores_. -- [Michael Jolley](https://dev.to/michaeljolley/using-a-contributing-codeofconduct-to-assist-others-in-contributing-to-public-repositories-1l90) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Tener un CODE_OF_CONDUCT.md en tus repositorios públicos permite saber por adelantado a los potenciales _contribuyentes_ qué trato esperar por parte de la comunidad y los _mantenedores_. -- [Michael Jolley](https://dev.to/michaeljolley/using-a-contributing-codeofconduct-to-assist-others-in-contributing-to-public-repositories-1l90) | |
Tener un CODE_OF_CONDUCT.md en tus repositorios públicos informa de ante mano a los potenciales _contribuyentes_ como la communida funciona y que esperar de los _mantenedores_. -- [Michael Jolley](https://dev.to/michaeljolley/using-a-contributing-codeofconduct-to-assist-others-in-contributing-to-public-repositories-1l90) |
|
||
El código de conducta de tu proyecto es un documento que protege a cada participante. Ayuda a crear una comunidad acogedora. | ||
|
||
Una buena adición a tu código de conducta es una explicación sobre cómo planeas hacer que se cumpla. Es importante demostrar que te lo tomas en serio para que todos puedan saber qué medidas se tomarán en caso de que lo infrinjan. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Una buena adición a tu código de conducta es una explicación sobre cómo planeas hacer que se cumpla. Es importante demostrar que te lo tomas en serio para que todos puedan saber qué medidas se tomarán en caso de que lo infrinjan. | |
Una buena idea es agregar a tu código de conducta una explicación sobre cómo aseguras que el codigo se aplique. Es importante demostrar que te lo tomas en serio para que todos puedan saber qué medidas se tomarán en caso de que lo infrinjan. |
|
||
El código de conducta más famoso es el ["Contributor Covenant"](https://www.contributor-covenant.org/). Lo usan miles de proyectos de código abierto. Si tu proyecto está en GitHub puedes añadir directamente el "Contributor Covenant" o el ["Citizen Code of Conduct"](http://citizencodeofconduct.org/) mediante tu interfaz de repositorios. Tienes que ir a `Insights > Community > Code of conduct`, haciendo click en el botón de añadir y eligiendo el código de conducta, creará un commit por ti. | ||
|
||
Tu proyecto está ahora preparado para ser de código abierto. ¡Puedes empezar a promocionarlo y conseguir tus primeras contribuciones! |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Tu proyecto está ahora preparado para ser de código abierto. ¡Puedes empezar a promocionarlo y conseguir tus primeras contribuciones! | |
Tu proyecto está ahora listo para ser Open Source. ¡Puedes empezar a promocionarlo y conseguir tus primeras contribuciones! |
This PR is linked to the issue #40