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

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 が表示されます。

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

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

アプリをリストするときに、必須の 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 でのアプリの製品スクリーンショットの例のスクリーンショット。

この記事で