この文書では、 MDN でフルタイムで作業するプロのライターが、始めるにあたって知っておくべきトピックについて説明します。気軽な態度で MDN に協力する場合は、気にする必要はありません。いきなり始めることができます。また、興味があるのであれば暇な時に読んでいただいても構いません。
MDN web docs とは
- Mission and vision (英語)
- Mozilla's MDN staff team (英語)
ガイドライン
以下は、プロのライターが一般的に新しい環境で働き始める前に知りたいと思うことです。
MDN wiki の基本的な使い方
以下の記事は、 MDN でコンテンツの作成を始めるのに必要な基本的な情報を説明しています。
- アカウントの作成 — 連携組織の従業員の場合は、従業員であることが分かるメールアドレスを使用して登録することを推奨します。
- API リファレンスの書き方
- MDN エディター UI の利用
- ソースモードの使い方
- ページの種類
- ページのタグ付け方法
- マクロの使用
- よく使われるマクロ
- トラブルシューティング
高度な使い方
以下の記事では、 MDN wiki の機能のうち、すぐには必要ないかもしれませんが、最終的には遭遇する可能性のある機能について説明しています。
- コード例を追加する方法
- 文書の構造
- ブラウザーの互換性情報: Github ベースの JSON またはef="/ja/docs/MDN/Contribute/Structures/Old_compatibility_tables">旧形式のページ内の表
- 画像の添付と添付ウィジェットの使用 — SVG 画像を添付するには特殊な権限が必要です。詳しくは Mozilla の MDN スタッフメンバーに問い合わせてください。
- QuickLinks によるサイドバー
- ページの移動
- ページの翻訳
- MDN に関するアドオン
プロセスとコミュニケーション
この節では、 MDN コミュニティで使用されているチャンネルや、 Mozilla MDN スタッフチームで使用されているプロセスについて解説します。
- Mozilla MDN staff team processes
- Public meetings
- MDN に関するコミュニケーションチャンネル
- MDN ディスカッションフォーラムに参加し、自己紹介をして、どのような作業をしようとしているのかを伝えてください。
- Kuma (MDN wiki プラットフォーム) への改良提案の方法:
- bugzilla.mozilla.org に、 Github ログインを使用してアカウントを作成してください。
- MDN feedback form を使用して、バグレポートを解こうしたり、機能や機能改善のリクエストを行ってください。
- (任意) 次の MDN Dev Triage meeting に参加してください。毎週 18:30 UTC です。
- コミュニティ内の作業
- 仕様書内の情報の探し方