github - tab - git tags best practices

¿Cuáles son las etiquetas de estado, como

Question

Puede ser una pregunta bien conocida, pero en realidad estoy preguntando esto, porque no estoy familiarizado con estas etiquetas.

He visto tipos de etiquetas similares en varios proyectos de Github, especialmente en su README.md . Mis preguntas son múltiples con respecto a esto:

1. ¿Cuál es el propósito de estas etiquetas?
2. ¿Cómo generarlos?
3. ¿Hay alguna buena práctica o documentación que sugiera qué tipos de etiquetas se pueden usar o se deben usar en un proyecto?
4. ¿Cuándo se puede determinar que un proyecto es viable usando tal etiqueta?

Answer 1

¿Cuál es el propósito de estas etiquetas?

Estas imágenes son proporcionadas por servicios externos, a menudo servicios de integración continuos , y se utilizan para mostrar información interesante sobre el repositorio.

Por ejemplo, la primera insignia que muestra en su ejemplo dice que la construcción está "pasando" (la definición exacta de esto será específica de la construcción, pero comúnmente significa que las pruebas pasan y nada explotó durante la compilación más reciente).

El tercer ejemplo, cobertura: 12%, es un informe de cobertura de código .

¿Cómo generarlos?

Cada servicio tendrá su propio camino.

La segunda insignia en su ejemplo es de Scrutinizer , y desafortunadamente no puedo encontrar documentación sobre sus insignias. Pero la mayoría de los sistemas de credenciales funcionan al proporcionarle un enlace para cada proyecto o trabajo que puede usar en su sitio web o GitHub o lo que sea, y cuando ocurre una compilación, la apariencia de la insignia se actualiza en consecuencia.

La documentación de Travis CI contiene un buen ejemplo.

Después de responder las primeras preguntas, creo que tus dos últimos desaparecieron en gran medida. Las insignias que se pueden usar están determinadas por los servicios que pueda encontrar. Las insignias que se deben usar son totalmente de usted.