ガイドライン
これらのガイドは MDN の文書がどのように書かれ、整形されるべきかの詳細を説明します。同様に、コードのサンプル、その他の素材をどのように示したら良いかについても説明します。 これらのガイドに従うならば、あなたの成果物はきれいなものであり、すぐに使えるものとなります。
- Code example guidelines
- This document series outlines the coding guidelines and best practices we use for writing demos, code snippets, interactive examples, etc, for use on MDN.
- MDN Web Docs に掲載するものであるかどうか
- この記事では、ある主題やコンテンツの種類を MDN Web Docs に載せるべきかどうかを決定する方法について説明します。
- MDN のコンテンツで使われるクラスとスタイルのガイド
- MDN には数多くの組み込みのグローバルスタイルがあって、記事のスタイル付けやレイアウトの際に使用することができ、この記事では利用可能なクラスとその使用方法を説明します。
- MDN の慣習と定義
- この記事では MDN で使用されている慣習や定義、特に文書化する際に人によっては忘れがちなものを紹介します。
- MDNのビデオコンテンツ
- MDNのWeb Docsは動画が多いサイトではありませんが、ビデオコンテンツを記事の一部として使用することに意味がある場所がいくつかあります。この記事では、MDNの記事に動画を含めることが適切な場合について説明し、シンプルだが効果的なビデオを予算内で作成するためのヒントを提供します。
- 執筆スタイルガイド
- 整理され、標準化され、読みやすい書き方でドキュメンテーションを示すために、 MDN Web Docs スタイルガイドはテキストがどのような体系、表記、書式などに従うべきかを説明します。これらは厳密な規則というのではなくガイドラインです。
- 編集方針
- この記事では、Mozilla MDN のスタッフが MDN Web ドキュメントのコンテンツを管理するために設定したポリシーについて説明します。