アプリのリスト説明を書く

メモ

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

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

命名とリンク

リスト名

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

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

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

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

"ごく短い説明" の長さ

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

"ごく短い説明" の内容

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

        **実施内容:** GitHub の課題を管理するための軽量プロジェクト管理

          **すべきではないこと:** GitHub でプロジェクトと課題を管理する (GitHubでプロジェクトと課題を管理しないでください)


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

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

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


        **やってはいけないこと:** Skycap はコンテナーネイティブの継続的インテグレーション ツールです

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

文を作るときには必ず文頭のみを大文字にしてください。最初の文字と固有名詞だけを大文字にします。
短い説明の終わりには句読点を付けません。短い説明には完全文を含めず、なおかつ1文以上にしてはいけません。

固有名詞だけを大文字にします。次に例を示します。

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


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

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

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

        **すること:** 組織内の個人向けに課題を自動的に作成する


        **しないこと:** 組織のユーザー向けに課題を自動的に作成する。

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

        **実施事項:** GitHub から離れずに使用できるアジャイルタスクボード、見積もり、レポート

          **すべきではないこと:** GitHub の UI を離れずにアジャイル タスク ボード、見積もり、レポートを使用すること

カテゴリ

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

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

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

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

ロゴのガイドライン

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

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

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

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

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

一覧表示の詳細

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

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

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

          **[Read more](詳細を読む)** をクリックすると、[Detailed description](詳細説明) が表示されます。

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

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

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

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

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

概要説明は、必ずアプリケーション名から始めます。
説明と価値提案は、必ず能動態で書くようにします。

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

バリュープロポジションでは、英文字表記は固有名詞に使用し、大文字小文字は常に正しく使ってください。最初の文字と固有名詞だけを大文字にします。
説明では句点を使用します。感嘆符は避けてください。
バリュープロポジションのタイトルの終わりには句読点を付けません。バリュープロポジションのタイトルを完全文では書かないようにし、複数文は避けてください。
各バリュープロポジションには、タイトルとそれに続く説明があります。 Markdown を使って、タイトルにレベル 3 ヘッダーの書式を設定します。次に例を示します。

必要なスキルを学ぶ

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

固有名詞だけを大文字にします。
リストには常にシリアルコンマを使います。

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

        **すること:** 組織内の個人向けに課題を自動的に作成する


        **しないこと:** 組織のユーザー向けに課題を自動的に作成する。

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

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

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

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

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

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

この記事で