Skip to main content

このバージョンの GitHub Enterprise サーバーはこの日付をもって終了となりました: 2024-09-25. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの向上、新機能の向上を図るために、最新バージョンの GitHub Enterprise サーバーにアップグレードしてください。 アップグレードに関するヘルプについては、GitHub Enterprise サポートにお問い合わせください

概念的コンテンツ タイプ

概念コンテンツは、ユーザーが何か新しいことを学ぶときに最もよく使われます。

概念コンテンツは、ユーザーが機能またはトピックを理解するのに役立ち、明確な概要、機能またはトピックが自分の体験にどのように役立つかの説明、ユース ケースや例などのコンテキストが提供されます。

その他の記事内では概念記事と概念セクションを作成します。 ほとんどの主な製品、機能、または件名には、独自の概念に関する記事があります。

概念コンテンツを記述する方法

概念コンテンツ テンプレートについては、「テンプレート」をご覧ください。

  • 機能、製品、またはトピックとは何かをわかりやすい言葉で説明します。
  • その目的と、閲覧者にとって便利な理由について説明します。
  • ユース ケースまたは例を共有します。
  • 関連する場合は、機能またはトピックのしくみを説明します (対象ユーザーと技術的な詳細を調べるのに適した場所に留意してください)。
  • 機能を使用するために閲覧者が知っておく必要がある詳細をすべて強調表示します。
  • 機能の使用を開始するための次の手順を含めます (参考資料のリンクと記事自体内のコンテンツのいずれを使用するかにかかわらず)。

概念コンテンツのタイトル

  • 概念記事または概念セクションのヘッダーは、「[件名] について」で始まります。
  • 名詞を使用して件名を記述します。
    • 使用する: 「code scanning について」
    • 避ける: 「コードの脆弱性のスキャンについて」

概念コンテンツの例