新しいコンテンツや機能の提案

MDN Web Docs のための新しいコンテンツや機能の提案について、コミュニティの皆さんからのご意見に常に関心を持っています。ただし、提案を受け付けているとはいえ、以下のことを念頭に置いておく必要があります。

  • MDN Web Docs は、小規模な内部チームによって運営・管理されています。また、MDN Web Docs をウェブ開発者のための最高のリソースとして維持するために、私たちはパートナーやコミュニティに大きく依存しています。そのため、新しいコンテンツや機能を長期的に維持することができないことを理由に、新しいコンテンツや機能をお断りしなければならない場合もあります。
  • MDN Web Docs は、オープンなウェブ標準を文書化することに重点を置いているので、コンテンツによってはうまく適合しないものもあるかもしれません。これはアイデアやコンテンツがよくないということではなく、MDN Web Docs がそのコンテンツにとって最適な場所ではないということです。

このことを念頭に置いて、もしあなたが MDN Web Docs のコンテンツや機能を提案したいのであれば、下記の手順に従ってください。

コンテンツの提案や機能の提案の課題を開く

新しい課題 (issue) を開こうとすると、"New content or feature suggestions "というテンプレートがあります。これは、新しいコンテンツや機能を提案するときに使用する課題テンプレートです。その課題テンプレートは、かなり多くの情報を必要としますが、とても意図的なものです。

  1. これにより、提案を検討するために必要なすべての情報を、何度もやりとりすることなく、確実に収集することができます。
  2. フォームを記入する際に、提案内容をよく考えることができるようになります。

フォームを完全に入力してその課題を送信すると、提案の複雑さにもよりますが、1 週間から 2 週間以内にコアチームメンバーから返信があります。

ディスカッションに参加し、承認を待つ

もし、その提案が良いものだと感じたら、私たちは MDN community の discussions リポジトリーでディスカッションを始めるでしょう。これは、私たちのパートナーやより広いコミュニティから意見を取得するためです。私たちは、あなたがディスカッションを監視し、必要に応じて参加することをお勧めします。

課題を開く

ここで、これは私たちが追加したいコンテンツである、あるいは構築したい機能であるという合意が得られたとします。その場合、適切なリポジトリーに対して、元の提案とディスカッションを参照するための課題を開き、その課題が明確に実行可能であるように、あらゆるギャップを埋めていきます。

作業の割り当て

この点で、作業の優先順位が決められ、確実に実装し、レビューを行うための責任者が割り振られることになります。

プルリクエストを開く

作業がレビューできるようになったら、プルリクエストを開き、その際に提案、ディスカッション、その課題を再び参照するようにします。これは、私たちが常にその作業の完全なコンテキストを保有していることを保証するものです。最後に、必要な人が割り当てられ、レビュープロセスが始まります。

作業のレビューとマージ

ここでも、コンテンツや機能の複雑さによって、レビューの段階が長くなることがあります。忍耐強く、適切な関与を続けていただくようお願いします。少なくとも 2 人の内部メンバーから承認が得られたら、プルリクエストをマージする準備が整います。

これですべてのプロセスが終了し、コンテンツや機能は MDN Web Docs で利用できるようになります。