2016-02-22 37 views
7

Potrebbe essere una domanda ben nota, ma in realtà sto chiedendo questo, perché non ho familiarità con questi tag.Quali sono i tag di stato, come [build | passaggio]

status tags

Ho visto simili tipi di tag nei vari progetti Github, specialmente nella loro README.md. Le mie domande sono molteplici riguardo a queste:

  1. Qual è lo scopo di questi tag?
  2. Come generarli?
  3. Esiste qualche buona pratica o documentazione che suggerisce quali tipi di tag possono essere utilizzati o dovrebbero essere utilizzati in un progetto?
  4. Quando un progetto può essere determinato utilizzabile utilizzando tale tag?
+1

Queste sono solo immagini da servizi di terze parti. – SLaks

risposta

14

Qual è lo scopo di questi tag?

Queste immagini sono fornite da servizi esterni, spesso continuous integration e sono utilizzati per mostrare informazioni interessanti sul repository.

Ad esempio, il primo badge mostrato nell'esempio dice che la build è "passante" (la definizione esatta di questo sarà specifica per la build, ma in genere significa che i test passano e che nulla è saltato durante il più build recente).

Il terzo esempio, copertura: 12%, è un rapporto code coverage.

Come generarli?

Ogni servizio avrà la sua strada.

Il secondo badge nel tuo esempio è da Scrutinizer e sfortunatamente non riesco a trovare la documentazione sui suoi badge. Ma la maggior parte dei sistemi di badging funziona fornendoti un link per ogni progetto o lavoro che puoi utilizzare sul tuo sito web o su GitHub o qualsiasi altra cosa, e quando una build avviene, l'aspetto del badge viene aggiornato di conseguenza.

Il Travis CI documentation contiene un buon esempio.

Rispondendo alle prime domande, penso che le tue ultime due siano in gran parte scomparse. I badge che possono essere utilizzati per sono determinati dai servizi che puoi trovare. I distintivi che devono essere utilizzati sono interamente a discrezione di.

+4

Vale menzionare [shields.io] (http://shields.io) che è come un _bazaar_ per i badge. –