アプリケーションのリストの説明を書く

GitHub Marketplace でアプリをリストするには、GitHub のガイドラインに従ってアプリの説明を書き、画像を指定する必要があります。

この記事の内容

注: この記事は、GitHub Marketplace でのアプリの公開にのみ適用されます。 GitHub Marketplace での GitHub Actions の公開について詳しくは、「GitHub Marketplaceでのアクションの公開」をご覧ください。

ドラフト リストの Listing description セクションに入力する必要があるフィールドについてのガイドラインは以下のとおりです。

リスト名

リストの名前は GitHub Marketplace ホームページに表示されます。 名前は255文字を上限とし、アプリケーションの名前と異なっていても構いません。 名前が自分自身のユーザー名または組織名である場合を除き、GitHub 上の既存のアカウントと同じ名前をリストに使うことはできません。

リストについてのごく短い説明

コミュニティには、GitHub Marketplace ホームページのアプリ名の下に "ごく短い" 説明が表示されます。

GitHub Marketplace でのアプリに関する簡単な説明のスクリーンショット。

"ごく短い説明" の長さ

簡単な説明は、40～80文字にとどめることをお勧めします。 それ以上の文字数を使うこともできますが、説明は簡潔なほうが顧客に読みやすく、わかりやすくなります。

"ごく短い説明" の内容

  • アプリケーションの機能を説明します。 このスペースを操作の指示には使用しないでください。 次に例を示します。

    良い例: GitHub の issue に関する軽量のプロジェクト管理

    悪い例: Manage your projects and issues on GitHub (GitHub でプロジェクトと issue を管理する)

    ヒント: アクションの呼び出しで動詞の末尾に "s" を追加して、許容できる説明に変換します: Manages your projects and issues on GitHub

  • 説明でアプリケーション名は繰り返さないようにします。

    良い例: コンテナーネイティブの継続的インテグレーション ツール

    悪い例: Skycap はコンテナーネイティブの継続的インテグレーション ツールです

"ごく短い説明" のフォーマット

  • 英文字表記は固有名詞に使用し、大文字小文字は常に正しく使ってください。 大文字で始めて英文字表記するのは固有名詞だけです。

  • 短い説明の終わりには句読点を付けません。 完全文では書かないようにし、複数文は絶対に避けてください。

  • 大文字で始めて英文字表記するのは固有名詞だけです。 次に例を示します。

    良い例: Web 開発者向けのワンクリック配信自動化

    悪い例: Web Developers 向けのワンクリック配信自動化

  • リストには常にシリアル コンマを使います。

  • GitHub コミュニティを "ユーザー" と呼ぶことは避けます。

    良い例: 組織内の個人向けに issue を自動的に作成する

    悪い例: 組織のユーザー向けに issue を自動的に作成する

  • 略語は一般的な場合 (APIなど) を除いて使用しないでください。 次に例を示します。

    良い例: GitHub を離れることなく使用できるアジャイル タスク ボード、見積もり、レポート

    悪い例: GitHub の UI を離れることなく使用できるアジャイル タスク ボード、見積もり、レポート

Categories

GitHub Marketplaceのアプリケーションはカテゴリ別に表示できます。 [Primary category](プライマリ カテゴリ) ドロップダウンでアプリの主な機能を端的に表すカテゴリを選び、必要に応じてアプリに適した [Secondary category](セカンダリ カテゴリ) を選びます。

サポートされている言語

アプリケーションが特定の言語でのみ動作する場合は、アプリケーションがサポートしている言語を最大10まで選択します。 選択した言語はアプリケーションのGitHub Marketplaceリストページに表示されます。 このフィールドは省略可能です。

URLのリスト

必須 URL

  • Customer support URL (カスタマー サポートの URL): 顧客がテクニカル サポート、製品、またはアカウントについて問い合わせるためにアクセスする Web ページの URL。
  • Privacy policy URL (プライバシーポリシーのURL): アプリのプライバシー ポリシーが表示される Web ページ。
  • インストール URL: このフィールドは OAuth apps の場合にのみ表示されます。 (GitHub Apps では、GitHub App の設定ページの省略可能な [セットアップ URL] を代わりに使うため、この URL は使いません)。顧客は、OAuth app を購入してインストールした後は、GitHub によってインストール URL にリダイレクトされます。 OAuth 認可フローを開始するために、顧客を https://github.com/login/oauth/authorize にリダイレクトする必要があります。 詳細については、「新しい購入や無料トライアルの処理」を参照してください。 GitHub App の一覧を表示している場合は、このフィールドをスキップします。

Optional URLs (省略可能な URL)

  • Company URL (会社の URL): あなたの会社の Web サイトへのリンク。
  • Status URL (ステータス URL): アプリのステータスを表示する Web ページのリンク。 ステータスページには、現在および履歴のインシデントレポート、Webアプリケーションの稼働時間ステータス、およびメンテナンスのスケジュールが記載されます。
  • Documentation URL (ドキュメントの URL): 顧客にアプリの使用方法を説明するドキュメントのリンク。

ロゴと機能カード

GitHub Marketplaceには、アプリケーションを視覚的に区別するために、円形のバッジの中に四角いロゴ画像の付いたリストが表示されます。

GitHub Marketplace ロゴとバッジの画像のスクリーンショット。

機能カードは、アプリケーションのロゴ、名前、およびブランドの個性を捉えた顧客の背景画像で構成されます。 アプリが、ホームページの上部にランダムに表示されている 4 つのアプリの 1 つである場合、GitHub Marketplace にこのカードが表示されます。 各アプリケーションのごく短い説明が、機能カードの下に表示されます。

OctocatApp の機能カードのスクリーンショット。 アプリの名前とモナのアイコンが、"United we code" という説明の上にピンクの背景で表示されています。

画像をアップロードして色を選択すると、GitHub Marketplaceのドラフトリストに、ロゴと機能カードのプレビューが表示されます。

ロゴのガイドライン

ロゴ用として、カスタム画像をアップロードする必要があります。 バッジには、背景色を選択します。

  • リストを公開するときにアップスケールしなくて済むように、アップロードするロゴ画像は200×200ピクセル以上にしてください。
  • ロゴは正方形にトリミングされます。 ロゴが中央にある正方形の画像ファイルをアップロードすることをお勧めします。
  • 最適な結果を得るには、透明な背景のロゴ画像をアップロードしてください。
  • 継ぎ目がないようにバッジを表示するには、ロゴ画像の背景色 (または透明) と一致する色をバッジの背景として選択します。
  • 単語や文章が含まれるロゴ画像の使用は避けてください。 文字が含まれる画像は、小さい画面で適切に縮小されません。

機能カードのガイドライン

機能カード用として、カスタム背景画像をアップロードする必要があります。 アプリケーションの名前には、文字色を選択します。

  • カードを視覚的に区別しやすいように、またGitHub Marketplaceホームページの暗い背景に対して目立つように、背景画像にはパターンまたはテクスチャを使用します。 機能カードには、アプリケーションのブランドの個性を取得する必要があります。
  • 背景画像の大きさは、幅965ピクセル x 高さ482ピクセルです。
  • アプリケーション名の文字色には、背景画像に対してはっきり見える色を選択してください。

一覧表示の詳細

アプリケーションのランディングページにアクセスするには、GitHub Marketplaceホームページまたはカテゴリページからアプリケーションの名前をクリックします。 ランディングページページには、アプリケーションの長い説明が表示されます。説明は「概要説明」と「詳細説明」の2部で構成されています。

「概要説明」は、アプリケーションのGitHub Marketplaceランディングページの上部に表示されます。

GitHub Marketplace の概要説明のスクリーンショット。

Read more をクリックすると、Detailed description が表示されます。

説明の記述は、以下のガイドラインに従ってください。

"概要説明" と "詳細説明" の長さ

アプリをリストするときに、必須の Introductory description フィールドには、150 から 250 文字の長さで 1、2 文の概要を入力することをお勧めします。 それ以上の文字数を使うこともできますが、概要は簡潔なほうが顧客に読みやすく、わかりやすくなります。

オプションの「詳細説明」フィールドに情報を追加することもできます。 アプリのランディング ページで概要説明の下にある Read more をクリックすると、この説明が表示されます。 詳細説明は、3 つから 5 つの価値提案と、それぞれを説明する 1、2 文から構成されます。 この説明には、最大1,000文字まで使用できます。

"概要説明" と "詳細説明" の内容

  • 概要説明は、必ずアプリケーション名から始めます。

  • 説明とバリュープロポジションは、必ず能動態で書きます。

"概要説明" と "詳細説明" のフォーマット

  • バリュープロポジションでは、英文字表記は固有名詞に使用し、大文字小文字は常に正しく使ってください。 大文字で始めて英文字表記するのは固有名詞だけです。

  • 説明では句点を使用します。 感嘆符は避けてください。

  • バリュープロポジションのタイトルの終わりには句読点を付けません。 バリュープロポジションのタイトルを完全文では書かないようにし、複数文は避けてください。

  • 各バリュープロポジションには、タイトルとそれに続く説明があります。 Markdown を使って、タイトルにレベル 3 ヘッダーの書式を設定します。 次に例を示します。

必要なスキルを学ぶ

GitHub Skills は、GitHub の使用、Markdown とのより効果的なやり取り、マージ競合の処理などの方法を学習するのに役立ちます。

  • 大文字で始めて英文字表記するのは固有名詞だけです。

  • リストには常にシリアル コンマを使います。

  • GitHub コミュニティを "ユーザー" と呼ぶことは避けます。

    良い例: 組織内の個人向けに issue を自動的に作成する

    悪い例: 組織のユーザー向けに issue を自動的に作成する

  • 略語は一般的な場合 (APIなど) を除いて使用しないでください。

製品のスクリーンショット

アプリケーションのランディングページで表示されるように、アプリケーションのスクリーンショット画像を5つまでアップロードできます。 スクリーンショットごとに状況がわかるキャプションをオプションとして追加します。 スクリーンショットをアップロードすると、ランディングページに表示したい順序でドラッグできます。

スクリーンショットのガイドライン

  • 画像は高解像度 (幅1200px以上) でなければなりません。
  • 画像を次から次へのクリックしたときにページが移動するのを避けるために、すべての画像は高さと幅 (アスペクト比) を等しくする必要があります。
  • アプリケーションの動作が見えるように、ユーザーインターフェースはできるだけ多く表示してください。
  • ブラウザーでアプリケーションのスクリーンショットを取得するときには、ディスプレイウィンドウの内容のみを含めるようにします。 アドレスバー、タイトルバー、ツールバーのアイコンは含めないでください。小さい画面で適切に縮小されません。
  • GitHub では、アップロードしたスクリーンショットは、アプリのランディング ページのボックス内に表示されるので、スクリーンショットの周囲にボックスや枠線は必要ありません。
  • キャプションは、短く簡潔なほうが効果があります。

GitHub Marketplace でのアプリの製品スクリーンショットの例のスクリーンショット。