157 lines
10 KiB
Markdown
157 lines
10 KiB
Markdown
<table>
|
|
<tr>
|
|
<!-- Do not translate this table -->
|
|
<td> Read these guidelines in </td>
|
|
<td><a href="/CONTRIBUTING.md"> English </a></td>
|
|
<td><a href="/docs/arabic/CONTRIBUTING.md"> عربي </a></td>
|
|
<td><a href="/docs/chinese/CONTRIBUTING.md"> 中文 </a></td>
|
|
<td><a href="/docs/portuguese/CONTRIBUTING.md"> Português </a></td>
|
|
<td><a href="/docs/russian/CONTRIBUTING.md"> русский </a></td>
|
|
<td><a href="/docs/spanish/CONTRIBUTING.md"> Español </a></td>
|
|
</tr>
|
|
</table>
|
|
|
|
# Pautas de Contribución
|
|
|
|
Hola 👋!
|
|
|
|
freeCodeCamp.org es posible gracias a miles de voluntarios amables como tú. Nos emocionamos por tus contribuciones y nos complace darte la bienvenida a bordo.
|
|
|
|
Cumplimos estrictamente nuestro ["Código de conducta"](https://www.freecodecamp.org/code-of-conduct). Tómate un momento para leerlo. No es muy largo.
|
|
|
|
Feliz contribución 🎉!
|
|
|
|
## Aquí hay algunas maneras divertidas en que puedes ayudar:
|
|
|
|
Puedes optar por contribuir a cualquier área de tu interés:
|
|
|
|
1. [Contribuir a este código de código fuente abierto.](#contribute-to-this-open-source-codebase)
|
|
|
|
Ayúdanos a crear o editar [artículos de guía](https://www.freecodecamp.org/guide), [desafíos de codificación](https://www.freecodecamp.org/learn) o corregir errores en la plataforma de aprendizaje.
|
|
|
|
2. Ayuda a los campistas en nuestro [foro público](https://www.freecodecamp.org/forum/):
|
|
|
|
- ❓ [Respondiendo a sus preguntas](https://www.freecodecamp.org/forum/?max_posts=1).
|
|
- 💬 [Dando retroalimentación](https://www.freecodecamp.org/forum/c/project-feedback?max_posts=1) a sus proyectos.
|
|
|
|
3. Ayúdanos a agregar subtítulos en nuestro [canal de YouTube](https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ/videos).
|
|
|
|
## Contribuye a esta base de código abierto
|
|
|
|
Tenemos una gran base de código abierto de los miles de [Desafíos de Codificación](https://www.freecodecamp.org/learn) y [Artículos de Guía](https://www.freecodecamp.org/guide). Estos desafíos y artículos conforman el contenido de aprendizaje disponible en la plataforma de aprendizaje de freeCodeCamp.org.
|
|
|
|
Puedes ayudarnos con:
|
|
|
|
- [📝 Investigar, escribir y actualizar nuestros artículos de guía.](#investiga-escribe-y-actualiza-nuestros-artículos-de-guía)
|
|
|
|
- [💻 Crear, actualizar y corregir errores en nuestros desafíos de codificación.](#crear-actualizar-y-corregir-errores-en-nuestros-desafíos-de-codificación)
|
|
|
|
- [🌐 Traducir artículos de guía y desafíos de codificación.](#traducir-artículos-de-guía-y-desafíos-de-codificación)
|
|
|
|
- [🛠 Ayúdanos a corregir errores en la plataforma de aprendizaje de freeCodeCamp.org.](#ayúdenos-a-corregir-errores-en-la-plataforma-de-aprendizaje-de-freeCodeCamp.org)
|
|
|
|
### Investiga, escribe y actualiza nuestros artículos de guía
|
|
|
|
**¿Qué son los artículos de Guía?**
|
|
|
|
Los artículos de guía te ayudan a comprender rápidamente un concepto de tecnología. Estas son explicaciones breves y sencillas que puedes leer antes de ir a recursos más profundos.
|
|
|
|
Puedes encontrar un [artículo de ejemplo sobre elementos HTML aquí](./client/src/pages/html/elements/index.md).
|
|
|
|
**¿Sobre qué puedo escribir un artículo?**
|
|
|
|
Agradecemos tu ayuda al escribir estos artículos. No tienes que ser un experto en un tema para escribir sobre él; toda esta Guía es de código abierto, por lo que incluso si cometes un error, otro colaborador lo corregirá.
|
|
|
|
Para obtener ayuda, busca un `esbozo de artículo` en nuestro [sitio web de la Guía](https://www.freecodecamp.org/guide), escribe el artículo y luego abre una solicitud para reemplazar el esbozo con tu artículo. Una solicitud o [pull request](https://help.github.com/articles/about-pull-requests/) es la forma en que sugerirán los cambios. Permite a otros conocer tus cambios, revisarlos y adóptarlos.
|
|
|
|
Si no puedes encontrar un esbozo sobre el tema que deseas escribir, puedes abrir un PR (pull request) que crea el esbozo e incluye tu borrador del artículo.
|
|
|
|
**Si deseas trabajar en ello, sigue estas pautas:**
|
|
|
|
#### [Cómo trabajar en los artículos de Guía.](/docs/how-to-work-on-guide-articles.md)
|
|
|
|
### Crear, actualizar y corregir errores en nuestros desafíos de codificación
|
|
|
|
Todos nuestros desafíos de codificación son curados por la comunidad, aportando conocimiento experto de voluntarios como tú.
|
|
|
|
Puedes ayudar a expandirlos y hacer que su redacción sea más clara. Puedes actualizar las historias de usuario para explicar mejor el concepto e incluso eliminar las redundantes. Es posible también que desees refactorizar las pruebas que no pasan con un código válido para las historias de usuario.
|
|
|
|
**Si deseas trabajar en ello, sigue estas pautas:**
|
|
|
|
#### [Cómo trabajar en desafíos de codificación.](/docs/how-to-work-on-coding-challenges.md)
|
|
|
|
### Traducir artículos de guía y desafíos de codificación
|
|
|
|
Puedes ayudarnos a traducir nuestros artículos de Guía y desafíos de codificación para un idioma que hables. Actualmente tenemos versiones traducidas en:
|
|
|
|
- [Chino (中文)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/chinese)
|
|
- [Ruso (русский)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/russian)
|
|
- [Árabe (عربى)](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/arabic)
|
|
- [Español](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/spanish)
|
|
- [Portugués](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/curriculum/challenges/portuguese)
|
|
|
|
La mayoría de estas versiones están traducidas automáticamente. Nos encantaría tu ayuda para mejorar la calidad de estas traducciones.
|
|
|
|
**Si deseas trabajar en ello, sigue estas pautas:**
|
|
|
|
**[POR HACER/TODO]** Estamos en el proceso de actualizar documentos para el flujo de trabajo de traducción. Siga [`#18313`](https://github.com/freeCodeCamp/freeCodeCamp/issues/18313) para ver el progreso.
|
|
|
|
### Ayúdanos a corregir errores en la plataforma de aprendizaje de freeCodeCamp.org
|
|
|
|
Nuestra plataforma de aprendizaje se ejecuta en una moderna pila de JavaScript. Tiene varios componentes, herramientas y bibliotecas, que incluyen pero no se limitan a Node.js, MongoDB, LoopBack, OAuth 2.0, React, Gatsby, Webpack y más.
|
|
|
|
En general,
|
|
|
|
- Tenemos un servidor de API basado en Node.js.
|
|
- Un conjunto de aplicaciones cliente basadas en React.
|
|
- Un script que usamos para evaluar nuestros proyectos Frontend.
|
|
|
|
Contribuir a esto requiere cierta comprensión de las API, la sintaxis de ES6 y mucha curiosidad.
|
|
|
|
Esencialmente, esperamos cierta familiaridad básica con algunas de las tecnologías citadas, herramientas y bibliotecas mencionadas anteriormente. Dicho esto, no es necesario que seas un experto en ello.
|
|
|
|
Siéntete libre de hacernos preguntas, en los hilos relacionados con problemas, y estaremos encantados de aclarar. En caso de duda, puede comunicarse con Mrugesh Mohapatra [`@raisedadead`](https://github.com/raisedadead) o Stuart Taylor[`@bouncey`](https://github.com/bouncey) desde nuestra equipo de desarrollo de la plataforma para ayudarte con esto.
|
|
|
|
**Si deseas trabajar en ello, siga estas pautas:**
|
|
|
|
#### [Cómo configurar freeCodeCamp localmente.](/docs/how-to-setup-freecodecamp-locally.md)
|
|
|
|
## Preguntas frecuentes
|
|
|
|
**¿Cómo puedo reportar un error, que no está a bordo?**
|
|
|
|
Si crees que has encontrado un error, primero lee el artículo ["Ayuda, he encontrado un error"](https://forum.freecodecamp.org/t/how-to-report-a-bug/19543) y sigue sus instrucciones.
|
|
|
|
Si estás seguro de que es un error nuevo, siga adelante y cree un nuevo problema o Issue en GitHub. Asegúrate de incluir la mayor cantidad de información posible para que podamos reproducir el error. Tenemos una plantilla de problemas predefinida para ayudarte a superar esto.
|
|
|
|
Ten en cuenta que cualquier problema que busques ayuda de codificación en un desafío se cerrará. El rastreador de problemas es estrictamente para los temas y discusiones relacionados con el código base. Deberías [buscar ayuda en el foro](https://www.freecodecamp.org/forum) antes de informar en caso de duda.
|
|
|
|
**¿Cómo puedo reportar un problema de seguridad?**
|
|
|
|
Por favor, no crees Issues de GitHub para problemas de seguridad. En su lugar, envíe un correo electrónico a `security@freecodecamp.org` y lo veremos de inmediato.
|
|
|
|
**Estoy atascado en algo que no está en esta documentación. ¿Cómo puedo obtener ayuda?**
|
|
|
|
Siéntete libre de pedir ayuda en:
|
|
|
|
- [La categoría "Colaboradores" en nuestro foro público](https://www.freecodecamp.org/forum/c/contributors).
|
|
- [La sala de chat de nuestros colaboradores públicos en Gitter](https://gitter.im/FreeCodeCamp/Contributors).
|
|
|
|
Nos emociona ayudarte a contribuir con cualquiera de los temas en los que le gustaría trabajar. Asegúrate de buscar tu consulta antes de publicar una nueva. Sé educado y paciente. Nuestros voluntarios y moderadores de la comunidad están siempre alrededor para guiarlo a través de sus consultas.
|
|
|
|
**Soy nuevo en GitHub y Open Source en general:**
|
|
|
|
Lee nuestra [Guía de cómo contribuir al Código Abierto](https://github.com/freeCodeCamp/how-to-contribute-to-open-source).
|
|
|
|
**¿Qué significan estas diferentes etiquetas, que están etiquetadas en los problemas?**
|
|
|
|
Nuestros moderadores de nuestra comunidad [evalúan](https://en.wikipedia.org/wiki/Software_bug#Bug_management) problemas y solicitudes según su prioridad, gravedad y otros factores. Puedes [encontrar un glosario completo de sus significados aquí](https://github.com/freecodecamp/freecodecamp/labels).
|
|
|
|
Debes revisar los problemas **`Help Wanted`** o **`first timers welcome`** para una búsqueda rápida de lo que está disponible para que trabajes. Estos están libres para todos y no necesita permisión antes de trabajar en ellos.
|
|
|
|
Si estos temas carecen de claridad sobre lo que debe hacerse, siéntete libre de hacer preguntas en los comentarios.
|
|
|
|
**Encontré un error tipográfico, ¿debo informar un problema antes de poder hacer un pull request?**
|
|
|
|
Para los errores tipográficos y otros cambios de redacción, puedes abrir directamente los pull request sin crear primero Issues. Los Issues son más bien para discutir problemas más grandes asociados con el código, o aspectos más estructurales del currículo.
|