文書の構造

MDN 全体で見ると、MDNの記事内で統一的な情報の提示を行うために、繰り返し使われている様々な文書の構造があります。ここにあるのは、それらの構造について述べた記事です。これは文書を書いたり、編集したり、翻訳したりするのにふさわしい構造であると、MDN の執筆者であるあなたが気づき、適用し、そして変更できるものです。

(訳注:下位の各ページを和訳すると、ここに表示されます)

クイックリンク
MDN はページへのクイックリンクの追加に対応しています。これらのボックスは、 MDN 上の他のページやサイト外のページへの階層的なリストを含むことができます。この記事では、クイックリンクボックスの生成方法を解説します。
コードサンプル
MDN では、ウェブプラットフォームの機能の使い方を示すために、ページ中に数多くのコードサンプルが挿入されています。この記事では、ページにコードサンプルを追加するためのさまざまな仕組みと、どのような場合にどのような仕組みを使うべきかについて説明します。
バナーと通知
場合によっては、記事に特別な通知が必要になることがあります。これは、プロダクションコードで使用すべきではない古い技術やその他の資料がページに含まれている場合に発生する可能性があります。この記事では最も一般的なケースについて説明します。
ページの種類
MDN に繰り返し使用されるいくつかの種類のページがあります。この記事では、これらのページの種類とその目的、および新しいページを作成するときに使用するそれぞれのテンプレートの例と使用方法について説明します。
マクロの使用
MDN が動作している Yari プラットフォームは、幅広い作業の自動化を可能にする強力なマクロシステムである KumaScript を提供しています。この記事は MDN のマクロを記事中で呼び出す方法について情報を提供します。
ライブサンプル
MDN は、記事に表示されているサンプルコードを、実際に見ている実行可能なサンプルに変換することをサポートしています。これらのライブサンプルには、HTML、CSS、JavaScript を任意の組み合わせで含めることができます。
互換性一覧表とブラウザー互換性データリポジトリ (BCD)
MDN には、オープンなウェブ文書のための互換性一覧表の標準形式があります。これは、すべてのブラウザーにわたって共有される DOM, HTML, CSS, JavaScript, SVG などの技術の文書で使用されます。この記事は、作成した互換性一覧表をデータベースにどのように追加して維持するか、また、一覧表を記事に統合する方法についての「始め方」のガイドです。
仕様書表
MDN 上のすべてのリファレンスページでは、 API または技術が定義されている仕様書に関する情報を提供するようにしてください。この記事ではこれらの表の外見を示し、構築方法を説明します。
構文の節
MDN リファレンスページの構文の節には、機能が持つ正確な構文を定義する構文ボックスがあります (例えば、どのような引数が受け入れられるか、どれがオプションかなど)。この記事では、リファレンス記事の構文ボックスの書き方を説明します。