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

Translated chapter 2 to Spanish. #44

Closed
wants to merge 4 commits into from

Conversation

Alux6
Copy link

@Alux6 Alux6 commented Oct 30, 2021

This PR is linked to the issue #40

@jeanphi-baconnais
Copy link
Member

Hi @Alux6 and sorry for the delay ! It's a very good work, we will check it as soon 🙏

Copy link
Member

@jeanphi-baconnais jeanphi-baconnais left a 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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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):
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> 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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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!
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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!

@Alux6 Alux6 closed this May 19, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants