Las etiquetas son una función interesante de GitHub que te permite filtrar problemas y solicitudes de extracción. Te ayudan a encontrar algo divertido para trabajar que se adapte a tu nivel de experiencia.
En el caso de nuestros repositorios, el equipo principal de Blockly se encarga exclusivamente de agregar etiquetas nuevas a los problemas para garantizar que todo quede en el lugar correcto.
Tamaño
Algunos problemas son pequeños y hermosos, mientras que otros podrían tardar semanas en resolverse. Estas etiquetas te ayudan a saber cuánto trabajo probablemente requerirá un problema.
- Good first issue: Estos problemas son ideales para las personas que son nuevas en el repositorio. Deberían llevar menos de medio día de trabajo y requerir una familiaridad limitada con la base de código. Puedes comenzar a trabajar en estos problemas de inmediato, sin la aprobación del equipo.
Jurisdicción
Trabajar en un repo muy utilizado puede ser un proceso delicado, y algunos problemas pueden ser más delicados que otros. Estas etiquetas te ayudan a saber qué problemas están abiertos para recibir contribuciones y de cuáles debes mantenerte alejado.
- Se necesita ayuda: Estos problemas están reservados para los colaboradores. A menudo, son funciones que el equipo principal cree que serían útiles, pero no tiene tiempo para implementar. Es posible que necesiten debate o implementación, por lo que debes verificar la etiqueta de estado para ver qué trabajo se necesita. Este es un buen lugar para encontrar proyectos creativos divertidos.
- Internos: Estos problemas están reservados para los miembros del equipo principal. A menudo, son errores sensibles o complejos que requieren un debate especial. Es mejor mantenerse alejado de ellos, ya que la situación a su alrededor podría cambiar rápidamente.
- Ninguna: Los colaboradores y los miembros del equipo principal pueden corregir los problemas que no tienen ninguna etiqueta. Si ves un problema sin etiquetar que te parece interesante, ¡no dudes en tomarlo!
Estado
Algunos problemas (en especial, las solicitudes de funciones) pasan por varias etapas diferentes antes de que se puedan considerar "cerrados". Estas etiquetas te indican en qué etapa se encuentra un problema, para que sepas qué debes hacer a continuación.
- Discusión: Estos problemas se encuentran en la fase de discusión, lo que significa que aún hay preguntas que deben responderse antes de la implementación. Si tienes alguna idea relacionada con este problema, no dudes en dejar un comentario. Siempre buscamos más opiniones.
- Implementación: Estos problemas se analizaron lo suficiente como para definirlos claramente y pasaron a la fase de implementación. Están en espera de implementación o ya se están implementando. Si te interesa trabajar en uno de estos problemas, lee todo el problema y, luego, deja un comentario en el que indiques en qué parte quieres trabajar. Luego, ¡comienza a trabajar!
- Ninguna: Los problemas que no tienen ninguna etiqueta pueden estar en cualquiera de los dos estados. Si tienes una opinión sobre cómo se debería implementar el problema, deja un comentario. Como alternativa, si te interesa trabajar en el problema, lo mejor es dejar un comentario preguntando si está listo para implementarse.
Tipo
Los diferentes problemas requieren respuestas diferentes. Algunas solo requieren editar algunas líneas de código, mientras que otras necesitan mucho diseño y debate. Estas etiquetas te indican qué tipo de acción requerirá un problema.
- Error: Estos problemas documentan un problema con la base de código. A menudo, requieren cierta depuración para diagnosticar la causa del problema, pero algunos se pueden solucionar en un abrir y cerrar de ojos. Si te gusta investigar a fondo para saber cómo funciona el código, estos serán problemas excelentes para ti. Puedes ayudar a corregir el error o a investigar para comprender el problema y escribir una explicación clara de la causa raíz.
- Solicitud de función: En estos problemas, se documenta una función que alguien desea que se agregue. Esto se puede aplicar al repositorio en su totalidad o a un proyecto individual. Si te gusta desarrollar ideas de diseño y agregar nuevas funciones, estos podrían ser los problemas perfectos para ti.
- Pregunta: Estos problemas documentan una pregunta que alguien tiene sobre la base de código. Por lo general, estas preguntas se redireccionan al foro de desarrolladores, pero si ves una pregunta con la que crees que puedes ayudar, no dudes en intervenir y responder.
Categoría
Este repositorio contiene varios tipos de proyectos, con diferentes tipos de públicos objetivo. Si te apasionan los instructivos o te encanta trabajar en complementos, estas etiquetas pueden ayudarte a encontrar los problemas que te interesan.
- Codelab: Estos problemas se relacionan con los codelabs de Blockly, un conjunto de instructivos interactivos.
- Ejemplo: Estos problemas se relacionan con los ejemplos de Blockly, un conjunto de demostraciones independientes que muestran cómo incluir y extender Blockly.
- Complemento: Estos problemas se relacionan con los complementos de Blockly, una colección de extensiones que agregan funcionalidad a Blockly.
Proyecto
Y si deseas un control aún más preciso, también hay etiquetas para proyectos individuales. Por lo general, se crean para los complementos, que suelen tener más problemas relacionados, pero también se pueden crear para los codelabs y los ejemplos. Si tienes un proyecto en particular que te interesa, estas etiquetas pueden ayudarte a encontrar problemas relacionados con él.
Para ver si hay una etiqueta para el proyecto que te interesa, consulta la lista completa de etiquetas:
Otro
Al igual que con cualquier colección de elementos, también hay algunos casos atípicos que debes conocer. Estas etiquetas pueden no ser tan útiles cuando buscas un problema en el que trabajar, pero pueden ser informativas.
- Triaje: El equipo principal aún no etiquetó correctamente estos problemas. Los problemas con esta etiqueta ya pueden incluir otra etiqueta simple, como error o solicitud de función, pero es probable que se agreguen más etiquetas pronto.
- Duplicado: Estos problemas documentan un problema, una solicitud o una pregunta que ya se abordaron en otro problema. Esta etiqueta indica que no debes responder a este problema, sino al problema original.