Каковы статусные теги, например [build | минус]

Question

Может быть, хорошо известный вопрос, но на самом деле я спрашиваю об этом, потому что я не знаком с этими тегами.

Я видел подобные типы тегов в различных проектах GitHub, особенно в их README.md. Мои вопросы многообразны в этом отношении:

1. Какова цель этих тегов?
2. Как сгенерировать их?
3. Есть ли хорошая практика или документация, которая предполагает, какие типы меток могут использоваться или должны использоваться в проекте?
4. Когда проект можно определить жизнеспособным с помощью такого тега?

Answer 1

Какова цель этих тегов?

Эти изображения предоставляются внешними службами, часто continuous integration и используются для отображения интересующей информации о репозитории.

Например, первый значок, который вы показываете в своем примере, говорит, что сборка «проходит» (точное определение этого будет специфичным для сборки, но обычно это означает, что тесты проходят, и ничто не взорвалось в течение недавняя сборка).

Третий пример: покрытие: 12%, представляет собой отчет code coverage.

Как сгенерировать их?

Каждый сервис будет иметь свой собственный путь.

Второй значок в вашем примере от Scrutinizer, и, к сожалению, я не могу найти документацию о его значках. Но большинство систем бейджинга работают, предоставляя вам ссылку для каждого проекта или задания, которое вы можете использовать на своем веб-сайте или GitHub или что-то еще, и когда сборка происходит, внешний вид значка обновляется соответствующим образом.

Travis CI documentation содержит хороший пример.

Отвечая первым на вопросы, я думаю, что ваши последние два в значительной степени исчезают. Значки, которые могут быть полезны, определяются любыми сервисами, которые вы можете найти. Значки, которые должны быть использованы, полностью зависят от вас.