Las etiquetas son una característica genial de GitHub que te permiten filtrar problemas y solicitudes de extracción. Ayudan a encontrar algo divertido para trabajar que se ajuste a tu nivel de experiencia.
En el caso de nuestros repositorios, la adición de etiquetas nuevas a los problemas está a cargo del equipo central de Blockly, para garantizar que los elementos no terminen en el lugar equivocado.
Tamaño
Algunos problemas son breves y atractivos, mientras que otros pueden tardar semanas en derrotarlos. Estas etiquetas te ayudan a saber cuánto trabajo llevará un problema.
- Buen primer problema: Estos problemas son excelentes para las personas que son nuevas en el repositorio. Requieren menos de medio día de trabajo y deben estar familiarizados con el código base. Puedes comenzar a trabajar en estos problemas de inmediato, sin la aprobación del equipo.
Jurisdicción
Trabajar en un repositorio muy usado puede ser un proceso sensible, y algunos problemas pueden ser más sensibles que otros. Estas etiquetas te ayudan a saber qué problemas están abiertos para contribuir y cuáles evitar.
- Se necesita ayuda: Estos problemas están reservados para los colaboradores. A menudo, son características que el equipo central cree que serían útiles, pero que no tienen tiempo para implementar. Es posible que necesiten una conversación o implementación, así que verifica la etiqueta de estado para ver qué trabajo se necesita. 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 análisis especial. Es mejor mantenerse alejados de esto porque la situación que los rodea podría cambiar rápidamente.
- Ninguna: Los colaboradores y los miembros del equipo principal pueden solucionar los problemas que no tienen ninguna etiqueta. Si ves un problema sin etiquetar que te parece interesante, aprovéchalo.
Estado
Algunos problemas (en particular, las solicitudes de funciones) pasan por unas etapas diferentes antes de que se puedan considerar “cerrados”. Estas etiquetas te indican en qué etapa se encuentra un problema, para que puedas saber qué se debe hacer a continuación.
- Debate: Estos problemas se encuentran en la fase de debate, lo que significa que aún hay preguntas que se deben responder antes de la implementación. Si tienes algún comentario relacionado con este tema, no dudes en dejar un comentario. Siempre buscamos más información.
- Implementación: Estos problemas ya se analizaron lo suficiente y ahora están definidos con claridad, y pasaron a la fase de implementación. Están esperando la implementación o ya se están implementando. Si te interesa trabajar en una de ellas, lee todo el problema y, luego, deja un comentario en el que indiques en qué parte quieres trabajar. Luego, continúa y profundiza.
- Ninguna: Los problemas que no tienen ninguna etiqueta pueden estar en cualquier estado. Si tienes una opinión sobre cómo se debe implementar el problema, deja un comentario. Como alternativa, si estás interesado en trabajar en el problema, es mejor dejar un comentario en el que se pregunte si está lista para implementarse.
Tipo
Diferentes problemas requieren respuestas distintas. Algunos solo requieren editar unas pocas líneas de código, mientras que otros necesitan mucho diseño y análisis. Estas etiquetas te indican qué tipo de acción requerirá un problema.
- Error: Estos problemas documentan un inconveniente con la base de código. Por lo general, es necesario realizar una depuración para diagnosticar la causa del problema, pero algunos problemas se solucionan con solo un guiño. Si te gusta investigar en profundidad para conocer el funcionamiento del código, estos serán grandes problemas para ti. Para ayudar, puedes corregir el error o investigar el problema y escribir una explicación clara de la causa raíz.
- Solicitud de función: Estos problemas documentan una función que alguien querría agregar. Esto se puede aplicar al repositorio en su totalidad o a un proyecto individual. Si te gusta complementar ideas de diseño y agregar funcionalidades nuevas, 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 para desarrolladores, pero si encuentras una pregunta que te podría ayudar, no dudes en responderla.
Categoría
Este repositorio contiene diferentes tipos de proyectos con distintos tipos de usuarios objetivo. Si te apasionan los instructivos o 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 la funcionalidad de Blockly.
Proyecto
Si quieres obtener información aún más detallada, también existen etiquetas para proyectos individuales. Por lo general, se crean para complementos, que suelen tener más problemas relacionados, pero también se pueden crear para codelabs y ejemplos. Si tienes un proyecto en particular que te interese, estas etiquetas pueden ayudarte a encontrar problemas relacionados con ese proyecto.
Además, ten en cuenta que se agregan nuevos proyectos con frecuencia, por lo que esta lista podría quedar desactualizada. Consulta la lista completa de etiquetas si no ves una entrada para el proyecto que te interesa.
- Herramientas para desarrolladores: Estos problemas se relacionan con el paquete de herramientas para desarrolladores, una biblioteca de utilidades comunes para el desarrollo de extensiones de Blockly.
- Fecha del campo: Estos problemas se relacionan con el paquete de campo de fecha, un campo de selector de fecha que usa el selector de fecha de Cierre de Google.
Otra opción
Como con cualquier colección de cosas, hay algunas curiosidades que también debes conocer. Es posible que estas etiquetas no sean tan útiles cuando buscas un problema en el que trabajar, pero aun así pueden ser informativas.
- Evaluación: El equipo central aún no ha etiquetado correctamente estos problemas. Es posible que los problemas con esta etiqueta ya incluyan 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 está cubierta por otro problema. Con esta etiqueta, se indica que no debes responder al problema original, sino que debes responder al original.