用語集の文書化状況

このページは MDN の用語集の章における翻訳作業を追跡するものです。気軽に協力してください。

現在の優先度

技術レビュー

技術レビューのフラグが付いた記事がたくさんあります。技術的に正しいかをチェックして、修正したり適切であればフラグを外したりしてください。

編集レビュー

正しい書式化やスペルチェックが必要な記事です。正しく書式化された項目の例はこちらです。

長い記事の短縮

記事が長すぎる場合、こちらのガイドラインに従って短縮する必要があります。長い記事が特によく書けたために保存したい場合は、 MDN discussion forum で議論してください。 MDN 上で独自の場所がふさわしい場合は、適切なエリアに移動することがあります。

完成度の一般的なチェック

たくさんの記事があります。必要な内容があって適切にタグ付けされているかを確認する必要があります。

用語集のマクロを使用する

用語集エリアの記事、学習エリア、 MDN の一般の記事では用語集のマクロを（適切な場所に）使用します。用語集のマクロはこちらで調べることができます。

コンテンツを改善するには

タグ付け標準

• ページがある技術に関連する場合は、その技術名をタグ付けしてください。
• 何らかの作業が必要なページについては、 "Need*" タグを追加してください。

用語集へのリンク

MDN を閲覧したり編集したりする際、 Glossary マクロを使用することで任意の用語を用語集へ簡単にリンクすることができます。

以下のように3つまでの引数を取ることができます。

1. リンクする用語（なお、用語に大文字・小文字の区別はありません）
2. 表示する代替テキスト（その用語と同等の表現、複数形、など）
3. リンクを通常のリンクとして表示するか (1)、ソフトリンクとして表示するか (0、既定値)

用語定義の執筆

用語定義のページは、3つの章を作る必要があります。

1. 用語を定義する短い概要（多くは1～2文）
2. その用語がカバーする範囲を理解するために必要な詳細を提供するための深い定義
3. この用語がカバーする範囲を深堀するための様々なリンクを提供するための「詳細情報」の章

用語定義のコンテンツは、その用語や使い方について特別な知識を持っていない読者を想定して書いてください。シンプルで直接的な言葉を使用してください。できるだけ専門用語を避けてください（常に可能な訳ではありませんが、シンプルな表現を心掛けてしてください）。

他のサイトから情報を集めることは良いことですが、そこから表現（または文全体）をコピー＆ペーストすることは良くありません（リンクを張るだけにしましょう）。

もっと詳しい情報は、 "how to write a new entry in the glossary" の記事を参照して下さい。