Seamonkey 技術者向けバイブル
【訳注：原文は、聖書の雰囲気を出すためこのように書かれています。ここでは、野獣を Seamonkey、無神論者を有名なブラウザと読み替えれば雰囲気がつかめます。「マタイ伝 8：21」といったところでしょう。】巻き起こる復讐の嵐のなか野獣は進み来る。無神論者たちの棲家は押しつぶされ、焼き払われて土へと帰す。その者たちの証は最後の日までその居場所を野獣に知らせ続ける。
出典：『もじら伝』 第 12 章 10 節
エンジニアと、その仕事、さらに開発の過程での多くの努力に敬意を払えば、上で述べたことが起こります。
短時間で行われる、広範囲なプラットフォームにまたがる開発では多くのコミュニケーションが必要で、また激務を強いられます。このドキュメントでは、効率的に協力を行い、またプロジェクトに参加する他のメンバーの生産性を維持するために必要なことを説明します。何らかの問題が生ずると、影響を受けるプロジェクト参加者の範囲は、時間の経過に伴って広がっていくことを忘れないでください。
バグの分析と特定
- 他のエンジニアに作業を依頼する前に何らかの解析作業を行ってください。
- バグに対する適切なデータを添付し、可能な限り迅速かつ効果的に、適切なエンジニアにバグの解析を委託します。
- 管理者、他のメンバーに相談して、バグのリストに優先順位を付けてもらい、さらにそのバグに付けた優先順位が妥当であるか確認してもらいます。
- 早い段階でバグのリストに優先順位を付け、定期的に見直します。自身と、他のプロジェクト参加者、そして製品使用者に影響を与える最も重要な問題の優先順位を常に上位に設定します。
- バグを修正したアップデートをチェックインする場合は、変更を行った部分にテスト範囲を広げるために必要なコメントを提出してください。
チェックイン前の段階における連絡と計画 (この時点で問題による影響を受けるのは自身だけです)
- コードレビューを行います。 また第三者のチェックを受け、可能な限りミスを取り除きます。
- ブランチと、個々の改版を安全にリリースするための対策を練ります。
- 数々の助言を受けて、コードに反映していきます。多くの人の目でチェックを受け、集まる助言を反映していきます。
- 全体的なバグ出しのためのテストを実施します。さらに変更部分のテストを行います。チェックインを行う前後のツリーの状況を確認します。
- チェックインの前にヘルプを用意しておきます。
- 新しいファイルを追加する場合には必要な変更をすべて行ったか確認してください。
- ツリーへの変更が何らかの影響を与える場合には、チェックイン前に通知メッセージを送信してください。
- 変更したファイルすべてをチェックインしてください。このとき、先に新しいファイルを追加してから古いファイルを削除します。
- チェックイン終了を通知するための確認メッセージを送信します。
- ツリーが赤い場合には緑になるまでチェックインを行わないでください。
ツリーが赤い場合にどうしてもチェックインが必要で、変更個所が現状の問題に影響を与えず、
新たな問題の元にならないことが確実なときには、現状の問題にかかわっている当事者に
メールを送り、変更について当事者間で打ち合わせを行います。
検証を前にしたビルド段階における連絡と計画 (問題が発生すると自身に影響が及びます。多くの関係者がかかわっていて、また誰でも関係者になれます。)
- チェックインをすることで関係者となり、ツリーの状態に対する責任が発生します。
- 変更、その他によってビルドに問題が生じていないか tinderbox を監視します。
- チェックインが完了後は、すべてのツリーが緑色になるまで、いつでも対応ができる状態を保ってください。
- 変更によって問題が生じた場合の対応は次のとおりです。
-
- 問題について責任がある旨の通知を受け取ります。
- 緑色にするまでの時間を見積もります。
- 将来同様の問題が発生することを防ぐために、記録を残して経験を共有します。
- 誰かに迷惑をかけた場合には必ず礼を尽くしましょう。
- ビルドの検証が始まる翌朝までの期間は、使用可能に準じた状態になります。
- 当事者としてかかわっている間に問題を解決します。
検証段階における連絡と計画 (問題が発生すると上記の関係者に加え、ビルドチームと品質保証・受け入れ試験の担当者にも影響が及びます。)
- ビルドの検証が終わるまで、いつでも対応できる状態を保ってください。また、ビルドや簡易試験で生じた問題をビルドチームが解析する際にも関係する責任があります。
- ビルドに関する問題と、簡易試験の妨げになるバグに対して対応を行い、できるだけ速やかに解決します。
完成段階における連絡と計画 (問題が発生すると上記の関係者に加え、品質保証の受入検査以外のスタッフ、40000 人の Mozilla テスター、マイルストーン tarball をダウンロードする 1500 人の人々に影響が及びます。)
- 変更部分に関係するバグについてフィードバックデータがないか監視します。
- ニュースグループで知らされるパッチや提案に従うことで、モジュールの改善を行います。