Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Hacktoberfest es un evento anual en todo el mundo que se realiza durante el mes de octubre. El evento anima a los desarrolladores de código abierto a contribuir en los repositorios a través de solicitudes de incorporación de cambios (PR). GitHub hospeda muchos repositorios de código abierto que contribuyen al contenido de Microsoft Learn. Algunos de los repositorios participan activamente en el evento Hacktoberfest. En este artículo, aprenderá a descubrir qué repositorios aceptan solicitudes de incorporación de cambios y qué puede esperar como colaborador.
Búsqueda de un repositorio
Para detectar si un repositorio de Microsoft Learn participa en Hacktoberfest, verá el tema Hacktoberfest en el proyecto.
Para filtrar todos los repositorios de Microsoft Learn y .NET que tengan el tema Hacktoberfest, vea Temas de GitHub: Hacktoberfest.
Como alternativa, un repositorio puede optar por usar la etiqueta Hacktoberfest
en su lugar. Esta etiqueta es práctica para filtrar problemas. Para obtener más información, vea Filtrado de problemas y solicitudes de incorporación de cambios por etiquetas.
Sugerencia
Si es administrador del repositorio y quiere permitir que el repositorio participe en Hacktoberfest, agregue el tema hacktoberfest
al repositorio. Para obtener más información, consulte Clasificación del repositorio con temas.
Colaboración
Para contribuir en un repositorio de código abierto, primero debe configurar su cuenta para contribuir en Microsoft Learn. Si nunca antes ha completado este proceso, empiece por registrarse para obtener una cuenta de GitHub. También debe registrar un perfil para realizar un seguimiento de su trabajo. Consulte Hacktoberfest.
Una vez configurada la cuenta, empiece por leer y cumplir el archivo CONTRIBUTING.md que se encuentra en la raíz del repositorio en el que quiere contribuir. Estos archivos sirven como guía a la hora de contribuir. Estas son algunas guías de colaborador de ejemplo de algunos repositorios de Microsoft Learn populares:
Además del archivo Markdown de contribución, si un repositorio tiene un archivo CODE_OF_CONDUCT.md, es un requisito cumplir el comportamiento esperado en la comunidad. De nuevo, estos son algunos ejemplos comunes:
Para obtener más información, vea Hacktoberfest: Participación.
Elija un problema
Para encontrar un problema en el que trabajar en un repositorio participante, filtre los problemas con las etiquetas de GitHub up-for-grabs
o help-wanted
. Aunque puede abordar otros problemas, es más fácil centrarse en aquellos que tienen un ámbito bien definido y son independientes. Además de los repositorios de Microsoft Learn, puede usar los siguientes sitios para principiantes:
- Awesome for beginners (Estupendo para principiantes)
- Up for grabs (Disponible)
- First timers only (Solo para primerizos)
Para obtener más información, vea Hacktoberfest: Principiantes.
Expectativas de calidad
Para contribuir correctamente en un repositorio de código abierto de Microsoft Learn, cree una solicitud de incorporación de cambios significativa y con impacto. Los ejemplos siguientes del sitio oficial de Hacktoberfest se consideran contribuciones de baja calidad:
- Solicitudes de incorporación de cambios que se automatizan (por ejemplo, PR de apertura con script para quitar espacios en blanco, corregir errores tipográficos u optimizar imágenes).
- Solicitudes de incorporación de cambios que son perjudiciales (por ejemplo, tomar la rama o confirmaciones de otra persona y realizar una PR).
- Solicitudes de incorporación de cambios que un mantenedor del proyecto considera como un obstáculo frente a la ayuda.
- Un envío que es claramente un intento de simplemente sumar uno al recuento de solicitudes de solicitud de incorporación de cambios de octubre.
Por último, una solicitud de incorporación de cambios para corregir un error tipográfico está bien, pero cinco para quitar un espacio en blanco perdido no lo están.
Para obtener más información, vea Hacktoberfest: Valores.
Apertura de una solicitud de incorporación de cambios
Una solicitud de incorporación de cambios proporciona una manera cómoda para que un colaborador proponga un conjunto de cambios. Al abrir una PR, especifique en el comentario original que está pensada para contribuir en el Hacktoberfest. Las solicitudes de incorporación de cambios correctas tienen estas características comunes:
- La solicitud de incorporación de cambios agrega valor.
- El colaborador es receptivo a los comentarios.
- Los cambios previstos están bien articulados.
- Los cambios están relacionados con un problema existente.
Si va a proponer una solicitud de incorporación de cambios sin un problema correspondiente, cree primero un problema. Para obtener más información, consulte GitHub: Acerca de las solicitudes de incorporación de cambios.