MDNに組み込まれた WYSIWYG エディターは、記事やサイト内のほとんどの作成、編集、改良ができるだけ楽になるように設計されています。エディターウィンドウには、8つのキーエリアがあります。このページは、全ての編集環境の使い方がわかるように、各セクションの情報を提供します。

我々は常に MDN を改良していて、このためこの文書やスクリーンショットがやや時代遅れになる事もあります。しかし、定期的にこの文書を更新して、使い物にならないほど遅れるのを防ぎます。

Screenshot of the editor UI (August 2017) with each section labeled

エディター UI は下記の部分からなっていて、上にも示されています。エディターの各部分については、下記のリンクをクリックして読んでください。

リビジョンコメント

記事を編集した後、あなたのリビジョン(変更)にコメントを追加することを強く推奨します。これはページのリビジョン履歴に表示され、同様にあなたのRevision Dashboardにも表示されます。これは他の人が後でレビューする時に、あなたの変更の説明や正当化になります。リビジョンコメントを追加するには、ページ最上部か最下部の公開ボタンを押す前にコメントボックスにコメントを入力するだけです。

これが役立つ理由がいくつかあります:

  • 変更が不明瞭な場合、他の人へ理由の説明をつけることができます。
  • 変更が技術的に複雑なら、ロジックの背景を説明することも出来ます。例えば、もっとたくさんの情報を参照できるよう、バグナンバーを含めることも出来ます。
  • 変更に大量のコンテンツの削除が含まれる場合、削除への正当化になります (例えば "記事Xにコンテンツを移動した")

レビュー要求

MDNコミュニティはMDNコンテンツの監視やクオリティの向上の為にレビューを使用しています。これは記事にフラグを設定することで動作し、この記事がレビューを必要としているということを知らせます。あなたは How to ガイドで技術レビュー や編集レビューについて学ぶことができます。

作業している記事にレビューを求めるには、必要なレビューの隣のチェックボックスをトグルします。技術レビューは、技術的なものの動作についての説明について変更した場合に要求されるべきで、一方編集レビューはあなたが変更をし終えて、記述とスタイル選択について誰かのレビューが欲しい時に、良いアイデアでしょう。

レビューチェックボックスの選択で記事が要技術レビュー要変更レビューのリストに追加されても、誰かがすぐに記事をレビューする事は保証されません。技術レビューでは、関連する技術部門の主題のエキスパートに直接連絡を取るのが良いでしょう。編集レビューでは、MDN discussion forum (英語) に投稿して、あなたの変更箇所を誰かにレビューするのを求めることができます。

あなたのレビューリクエストを適用する為に、チェックを入れた後に必ず発行ボタンのどれかを押してください。

関連項目

ドキュメントのタグと貢献者

このページの貢献者: wbamberg, Uemmra3, lv7777
最終更新者: wbamberg,