手引き
MDN Web Docs 執筆ガイドラインのこのセクションでは、MDN Web Docs に協力する際に特定のタスクを達成するための手順を詳細に説明しています。マークダウンの使用方法、用語集に項目を追加する方法、ページの移動や削除方法などです。
協力の方法についての詳細は、協力ガイドラインをご覧ください。
以下の記事では、あなたが協力ガイドラインをすべて読み、mdn/content リポジトリーの使い方をよく理解し、git と GitHub の使用方法を知っていることを想定しています。
- API リファレンスの書き方
このガイドでは、 MDN で API リファレンスを書くために必要なすべてのことを説明します。
- CSS プロパティの記事の作成方法
CSS 標準が進化するにつれて、新しいプロパティが常に追加されています。MDN の CSS リファレンスは、これらの開発に合わせて最新の状態に維持する必要があります。この文書では、CSS プロパティのリファレンスページを作成するためのステップごとの手順を説明します。
- HTTP ヘッダーの記事の作成方法
ハイパーテキスト転送プロトコル (HTTP) のリクエストおよびレスポンスメッセージのヘッダーセクションについては、HTTP ヘッダーリファレンスで説明しています。 この記事では、HTTP ヘッダーの新しいリファレンスページを作成する方法を説明します。
- Markdown の書き方
このページでは、MDN Web Docs のドキュメントを Markdown で書く方法を説明します。 ベースラインとして GitHub-Flavored Markdown (GFM) を選択し、MDN で必要な機能を実現するために拡張機能を追加しています。
- ウェブのエラー記事の作成方法
MDN の JavaScript エラーリファレンス は 開発者コンソールで発生するエラーについて、ウェブ開発者を手助けすることを目的としたプロジェクトです。このプロジェクトでは、メッセージが発生するツールへのリンクを追加できるように、 MDN Web Docs でより多くのエラー文書を書く必要があります。この記事ではウェブエラーの文書化について説明します。
- コンテンツのセクションを掲載終了する方法
この記事では、MDN Web Docs のコンテンツの特定のセクション全体を掲載終了するプロセス、いわゆる掲載終了について説明します。掲載終了は、個々のページの削除や移動とは異なります。これは、セクション全体がもはや積極的に保守されていなかったり、関連性がなくなったり、MDN の目標に沿わなくなったりした場合に適用され、計画的かつ透明性のある方法で掲載終了する必要があります。掲載終了したコンテンツは完全に削除されるわけではなく、常に MDN Museum リポジトリーにアーカイブされます。
- ページの作成、編集、移動、削除方法
この記事はページを作成、移動、削除、編集する方法を記述しています。 これらの場合、執筆ガイドラインを調べ、必要な措置があるかどうかを判断した上で、MDN Web Docs のコミュニケーションチャネルのいずれかを通じてチームと相談して進めることをよい考えとしてお勧めします。
- 技術の調査方法
訳注: MDN Web Docs では、日本語版の記事を最初から作成するのではなく、まず英語版の記事を作成してから日本語訳するようにしてください。
- 構造化データの使用方法
MDN は可能な限り、明確に定義された構造でデータを格納します。この情報は一元化され、一度の更新で多くの場所で使用することができます。
- 用語集の項目を追加する方法
訳注: MDN Web Docs では、日本語版の記事を最初から作成するのではなく、まず英語版の記事を作成してから日本語訳するようにしてください。
- 画像、メディア、資産の追加方法
このページでは、 MDN で文書内のページに画像やメディアを追加する方法について記述しています。