何らかの文書をまとめる準備をしている場合、その情報をMDNに置くかどうか決めたりするかもしれません。リポジトリ内のreadmeファイルに置いたりすることを検討しているかもしれません。この記事の目的は、あなたのコンテンツにとって、これらのオプションのどれが正しいのかを決めるのに役立つ事です。sites.MDNに含まれるトピックは?MDNでは驚くほど色々な種類の中身をカバーしています。一般に、オープンなWebが直面するテクノロジーである場合、これをMDNにて文書化します。直接的なものはMDNに含まれなかったり、判断が難しいことも少しあります。この節では、MDNをあなたの文書化のホームとするのに適しているかを理解するのに役立ちます。これは、我々がカバーしている一部を味見したものです。完全なリストではありませんが、あなたに見解をもたらすでしょう。これはつまり、複数ブラウザで実装され、標準として受け入れられるものや、標準化に向けて前進しているものを意味します。第一の重点箇所は、フロントエンドwebテクノロジーです。バックエンドテクノロジーには、別の文書化の場所があり、MDNはこれにとって変わるつもりはありません。バックエンドテクノロジーには、別の文書化の場所があり、MDNはこれにとって変わるつもりはありませんが、いくつかの例外はあります。製品このカテゴリの文書には、Mozilla製品に対して開発者として作業する方法と、これらのオープンソースプロジェクトに貢献する方法との、両方があります。Mozilla製品の文書が大量にありますが、新規コンテンツ開発の重点はオープンウェブに置いています。MDNにMozilla製品の文書を新規作成するのは推奨されません。話して、その製品の文書化の道を議論してください。platformGeckoSpiderMonkeyなどMDNに含まれないトピックは?MDN用のトピックとしてふさわしくない例は次の通り:Webに公開されていないテクノロジーだが、Mozilla以外のブラウザに固有のものWebにもMozilla製品にも関係しないテクノロジーエンドユーザ向けドキュメント。siteに入っています。そのため、もしドキュメントが「どのように使うか」や「どのように動作するか」(「どの」とは下記で記述されている特定のカテゴリのことです)ならMDNを参照しましょう。「誰が開発したか」や「開発プランについて」などはMDNにふさわしくありません。参照するとよいでしょう。仕様書や標準プロモーション材料や、広告や、個人情報[*]MDNに文書化するメリットもしあなたがあなたが書きたいドキュメントがMDNのコンテンツとして適切かどうかを決定したい場合、また、そのドキュメントを投稿するのにMDNが一番良い場所かどうかを確信していない場合、この記事を読みましょう。ここにはたくさんのMDNにドキュメントを作成するためのメリットが載っています。コミュニティは大きいです。MDNの中身を作成、維持することに参加している人がたくさんいます。ライターとエディターが全ての大陸(南極にはいないかも、それ以外で)にいて、ライターが多数いる価値があります。コアなボランティアコミュニティがあり、あなたを手助けするかなりの量のコンテンツに貢献しています。チームは、あなたの文書化プロジェクトに十分人を配置することを保証すべく、一緒に作業してくれます。コミュニティは大量に貢献します。タイポの修正からコンテンツの編集レビューまで、助けてくれます。チャネルでは、ライターコミュニティに話してアドバイスを得る場や、コンテンツ作成や維持を助ける人を採用する場を提供します。全世界に貢献者がいるため、問題を見ていたり直したりする人がいつも周りにいます。ボランティアコミュニティには、多くの言語へ翻訳する人がいて、あなたの文書のローカライズを手伝っています。あなたの開発チームが、文書作成に全責任を負うことを望みますか?その場合はおそらく他の場所で文書を維持するべきでしょう。infrastructure.他の場所に文書化する場合MDN以外のどこかに成果を文書化するのを考える理由も少しあります。その理由のいくつかと、デメリットを示します。これはとても簡単なことです。wiki的な文書化システムが提供されています。文書をそこに作成するチームもあります。あなたを手助けできません。一般的に我々はMDN以外の文書作業には加わりしません。例外はあるものの、まれです。あなたの文書と、関連する他の素材をクロスリンクするのは、困難だったり、不可能になるかもしれません。コンテンツが他の文書と一貫したスタイルが持てなくなります。文書の外にあるため、文書の発見しやすさが失われます。この事項に困らなかったり、問題ない場合もあります。文書をチーム自身で書いたり維持したりしても構わなかったり、文書の必要性が最低限なコードに関わる場合。inbox.現在、ニュースレターは英語でのみ提供されています。従って私の個人情報を扱うことに同意します。