MDN web docs: How-to ガイド

このページでは、日本語訳されたサブページの一覧を表示しています。英語版に存在していても、日本語訳されていないページは表示されません。日本語訳にご協力ください。

ここにある記事は、MDN に貢献する際に具体的な目標を達成するためのステップごとのガイドを提供するものです。

MDN の問題を報告する

時々、 MDN を使っていて問題にぶつかることがあるでしょう。それがサイトの仕組みの問題であっても、文書の内容に関する誤りであっても、自分自身で修正を試みるか、問題を報告することができます。前者が好ましいのですが、後者が管理できる限界である場合もありますし、それでも構いません。

SEO を考慮して MDN Web Docs を書く方法

このガイドでは、ユーザーが必要なものに簡単にアクセスできるように、検索エンジンがコンテンツを簡単に分類して索引付けできるようにするための標準的なプラクティス、推奨事項、およびコンテンツの要件について説明します。

インタラクティブな練習問題の作成方法

ウェブを学ぶとき、アクティブラーニングコンテンツに頼ることが重要です。このようなコンテンツは、積極的に何かを学ぶことを支援するために作られます。練習問題、ハック可能なライブの例、実行すべきタスク、評価などです。要するに、誰かが何かを能動的に理解するのを助けることができるものなら何でもいいのです。

ウェブのエラーを文書化する方法

MDN JavaScript error referenceDeveloper Console で発生するエラーについて、ウェブ開発者を手助けすることを目的とした新しいプロジェクトです。

コードサンプルを「ライブ」に変換するには

MDN には「ライブサンプル」システムがあり、ここではコードサンプルが、そのサンプルの出力を直接表示するのに使われます。しかし、既存の記事にはこのシステムをまだ使っていないコードサンプルが多々あり、変換する必要があります。

ブラウザーの互換性データを追加もしくは更新する方法

ウェブ機能のブラウザー互換性に関する情報がある場合、もしくは調査や実験を行う意思と能力がある場合は、MDN の Browser Compatibility Data (BCD) の更新を手伝うことができます。

ページを作成および編集する方法

この記事では、新しい協力者に既存ページの編集と、新規ページを作成する手順を紹介します。

外部コンテンツを MDN Web Docs に移行する方法

他の場所から MDN Web Docs に移行することに意味のある既存のコンテンツが見つかることがあります。この記事では、どのような種類のコンテンツを移行することが意味のあることなのか、コンテンツを移行すべきかどうか、移行を行うためにどのようなワークフローを使用すべきかについて説明します。

用語集の項目を書いたり参照したりする方法

この記事では、 MDN Web Docs の用語集に項目を追加したりリンクしたりする方法について説明します。 また、用語集の項目のレイアウトと内容に関するガイドラインも提供します。 用語集には、ウェブやウェブ開発に関する MDN コンテンツを読む際に出くわすであろうすべての用語、専門用語、略語、頭字語の定義が記載されています。

適切にタグづけする方法

記事のタグは、ユーザーが役立つコンテンツに触れるための重要な方法です。コンテンツを分類するために、それぞれのページは通常いくつかのタグを持っています。このページでは、読者が情報を見つけやすく、また私たち自身が整理しやすくするために、ページにタグ付けする最良の方法を説明します。