web-dev-qa-db-ja.com

[ビルド|通過]

よく知られている質問かもしれませんが、これらのタグに慣れていないので、実際に私はこれを尋ねています。

status tags

さまざまなGithubプロジェクト、特にREADME.mdで、同様のタイプのタグを見てきました。これらに関する私の質問は多種多様です:

  1. これらのタグの目的は何ですか?
  2. それらを生成する方法は?
  3. プロジェクトで使用できる、またはプロジェクトで使用する必要があるタグのタイプを示唆する優れたプラクティスまたはドキュメントはありますか?
  4. そのようなタグを使用してプロジェクトが実行可能であると判断できるのはいつですか?
30
Mayeenul Islam

これらのタグの目的は何ですか?

これらのイメージは外部サービス、多くの場合 継続的統合 サービスによって提供され、リポジトリに関する興味深い情報を示すために使用されます。

たとえば、例に表示する最初のバッジは、ビルドが「合格」であることを示しています(これの正確な定義はビルド固有ですが、通常、テストに合格し、最新のビルド中に何も故障しなかったことを意味します)。

3番目の例、coverage:12%は コードカバレッジ レポートです。

それらを生成する方法は?

各サービスには独自の方法があります。

あなたの例の2番目のバッジは Scrutinizer からのものであり、残念ながら、そのバッジに関するドキュメントは見つかりません。ただし、ほとんどのバッジシステムは、WebサイトやGitHubなどで使用できるプロジェクトまたはジョブごとにリンクを提供し、ビルドが発生すると、それに応じてバッジの外観が更新されます。

Travis CIドキュメント は良い例を含んでいます。

最初の質問に答えたので、最後の2つはほとんど消えたと思います。 使用できるバッジは、あなたが見つけることができるサービスによって決まります。 使用すべきバッジは完全にあなた次第です。

31
Chris