メインコンテンツにスキップ
The Apache Software Foundation
Apache 20th Anniversary Logo

プロジェクト議長の委員会報告ガイドライン

Apacheのプロジェクト管理委員会(PMC)は、理事会に四半期ごとにプロジェクトの健全性と状況を報告する必要があります。PMCは独自に技術的な問題を管理していますが、プロジェクトが私たちの使命をサポートする、健全で、コミュニティ主導で、合意に基づくプロジェクトとして運営し続けることを確認するための監督を理事会が行います。 PMCの義務に関するFAQも参照してください。PMC議長とアパッチメンバーは常に毎月の理事会に出席できます。

内容

プロジェクト委員会報告書をいつ提出するか

PMCの各議長は、報告スケジュールに従って、理事会ごとに少なくとも1週間前にプロジェクトの報告書を四半期ごとに提出する責任があります。

https://svn.apache.org/repos/private/committers/board/committee-info.txt

以下に記載されているように、遅れて報告したり、そのスケジュールどおりでなかったりしても、このスケジュールは変更されません。たとえば、1月に報告することになっていたが、それを逃して2月に報告した場合、次の報告は依然として4月に提出する必要があります。委員会が適切に審査するのに十分な時間内に報告書を提出しない場合、翌月に再提出するように依頼されます。

ほとんどの場合、議長は他のPMCメンバーと協力して報告書を作成しますが、報告書の完成と提出は最終的には議長の責任です。委員会は議長とPMCのprivate@メーリングリストの両方に、この作業を思い出させる自動リマインダーをいくつか送信します。

例外:新しく卒業したPMCは、アパッチのインキュベーターを離れてから最初の3か月間、月に1回報告書を提出する必要があります。アパッチのインキュベーターにまだ残っているすべてのポッドリングは、インキュベーターポッドリングのステータスプロセスを使用して同様の報告書を作成します。

プロジェクト委員会報告書を提出する方法

委員会の月例会合の議題に報告内容を約束する必要があります。
Whimsy Agenda ツールまたは ComDev プロジェクトレポーターツールを使用します。これらは便利なフレームワークを生成します

https://whimsy.apache.org/board/agenda/
https://reporter.apache.org/
  1. Apache ID を使用してログインします
  2. プロジェクトのエントリを見つけて、下部にある青いレポートの投稿ボタンをクリックします
  3. 送信をクリックする前にレボートをリフローしてください
  4. 必要に応じて、送信後にレポートを編集できます

コマンドラインのユーザーは、既存の形式に従ってレポートをチェックインできます。そうすることで、自動ツールがそれらを解析できます

  https://svn.apache.org/repos/private/foundation/board/

ボードは、定期レポート以外に PMC が送信するレポートを歓迎します。レポートする重要な内容がある場合、またはフィードバックをリクエストする場合です。この場合、議長はレポートをアジェンダの最後に添付し、それに対応するコメントセクションを作成する場合があります

レポートの主な対象は取締役会ですが、レポートは会議後公開され、プロジェクトの年代順の履歴になることを覚えておいてください。コミュニティに知ってもらいたい情報を使ってレポートを作成し、将来レポートを閲覧する人にとって役立つ履歴になるようにすることをお勧めします

レポートの公開部分を、ユーザーリストまたはプロジェクトの Web サイトを通じてプロジェクトのコミュニティと共有することもできます

Apache 委員会レポーターツールを使用すると、レポートに使用するデータを簡単に集めることができます。ただし生成されたテンプレートを編集して、以下のポイントをカバーするために情報を追加する必要があります
レポートを送信するときは、TODO マーカーを残さないでください

ボードレポートでカバーするポイント

これらのポイントはテンプレートとは異なります。プロジェクトでは、これらの箇条書きをレポートに単純にコピー アンド ペーストしないでください。むしろ、これらはあなたのプロジェクトの健全さと状態を評価するためにボードが知りたいトピックです。すべてのトピックがすべてのレポートに関連するわけではありません。ただし、議長はレポートを作成するときにこれらの質問をそれぞれ検討する必要があります。

レポートに含めないこと

プライベート情報

まれに、プロジェクトはプライベートに理事会に何かを報告する必要がある場合がありますが、公開議事録に情報を掲載したくありません。Apache理事会レポートはすべて公開され、通常は理事会開催から1、2か月後であることを覚えておいてください。

そのような情報はレポートに含めても構いませんが、次のように含めてください。

<private>

</private>

マーカーは、それぞれが別々の行にあるようにしてください。そうすることで、公開議事録から何を省略するかを知ることができます。プライベートマーカーが機能していることを確認するには、レポを Whimsy に投稿して、ページを更新します。
適切にマークされたプライベートセクションは、グレーの背景で表示されます。

問題が非常に機密でプライバシーを非常に気にしている場合は、代わりにboard-private@または個々の理事会メンバーに直接メールを送信できます。理事会メンバーが情報を理事会に中継します。

レポートのその他の考慮事項

プロジェクトレポートは、理事会にプロジェクトのステータスと健全性を知ってもらうための重要な方法です。Apacheのプロジェクトの多様性により、これらのガイドラインではすべての状況に対応できません。プロジェクトについて重要なと思われる追加情報をレポートに遠慮なく含めてください。

特に、PMCの委員長や他のメンバーがプロジェクトに潜在的なものを含む「問題のある箇所」を見つけた場合、取締役会レポートに必ずメモをつけてください。取締役会が後に問題を発見する可能性があることよりも、レポートに懸念事項(またはPMCの一部の懸念事項)を含めた方がよいでしょう。

最後に、レポートを作成するのに十分なアクティビティがないように思えるプロジェクトが見つかった場合は、その事実を必ず報告してください。健全なプロジェクトは、アパッチアティックに向かっている場合に認識する必要があります。アティックに移動することは失敗ではありません。プロジェクトが成熟したり、漂ったり、他のテクノロジーに取って代わられたりした可能性があることを認識しているだけです。私たちはそれを認識する必要があります。

取締役会はプロジェクト委員長のレポートに依拠して、プロジェクトのステータスと健全性を理解しています。取締役会がプロジェクトの進行状況について十分に認識できない場合、近い将来フォローアップレポートをお送りします。

レポートに関する取締役会との対話

プロジェクトレポートは一方向のコミュニケーション形式ではありません。取締役会に参加する機会でもあります。プロジェクト委員長はゲストとして取締役会に出席してレポートについて話し合うことができます。また、取締役会に検討してほしい特定の問題を強調することもできます(レポート内またはアジェンダの広範な議題の項目を要求します)。

もちろん、委員長は報告期間の内外を問わず、いつでもBoard@メーリングリストでこれらの議論の機会を利用することもできます。

レポートを提出する必要があるたびに、ディレクターがプロジェクトレポートの「シェパード」としてランダムに割り当てられます。彼らは、レポートが遅れた場合のフォローアップ、重要なコメントや承認がない場合は会議中のレポートの説明、および会議後のPMCへのフォローアップメッセージまたはアクションの伝達を担当します。

ディレクターが会議に向けてレポートを見直すとき、彼らはレポートの横にアジェンダにコメントを追加することがあります。SVNのコミットを監視したり、Whimsy Agendaツールを使用したりして、プロジェクト委員長がその取締役会からのフィードバック(現在)をフォローし、実行可能な場合は会議の前に対応することをお勧めします。

取締役会は通常、このパターンに従います。

  1. 月の前半に、アジェンダが作成され、現在のサイクルで報告する必要があるプロジェクトにリマインダーが送信されます。
  2. 責任者は、会合の締め切り日まで、数週間にわたってアジェンダにレポートを追加します。
  3. ディレクターは提出されたレポートを都合の良い時にレビューし、懸念事項がない場合は「事前承認」としてマークします。彼らは、コメントや追加情報の要求を追加したり、明らかな修正のためにコンテンツを編集したりすることがあります。
  4. シェパードは会議の直前に割り当てられ、それらのプロジェクトレポートに詳しくなります。
  5. レポートの要約とコメントは、会議の24時間前に理事会のメーリングリストに送信されます。
  6. 会議中、取締役会長は「事前承認」を5つ以上取得し、重要なコメントがないレポートを次々と進めます。
  7. 重要なコメント、議論の項目、事前承認がないレポートは、シェパードに引き渡され、会議中に議論を促進し、さらなるアクションを推奨します。
  8. 理事会会議終了後に、すべてのコミッターに要約が送信され、主な成果が伝えられます。
  9. 承認されなかった、または不足していたプロジェクト レポートは翌月のリマインダー リストに追加されます。
  10. シェパードは、レポートに対する会議で生じた具体的なアクション事項をプロジェクト チェアに伝え、連絡を取ります。
  11. 書記は、会議終了後まもなく、取締役からのレポートに対するコメントをプロジェクトの private@ リストに送信します。会議からの簡単なフィードバックを提供し、質問に回答したりアドバイスを求めたりするために理事会と関わる機会が得られます。理事会にプロジェクトに関する質問がある場合は、全体に返信して質問に回答します
  12. レポートは、理事会の後続の月例会議で承認された場合、議事録の一部として公開されます。

ご覧のとおり、レポートを期日までに受け取り、必要な詳細がすべて含まれ、コメントに対処することで、理事会会議の進行状況が大幅に向上します。理事会会議では毎月 80 以上のプロジェクト レポートとポッドリング レポートに加えて、他の業務分野を含める必要があります。