FreeBSD 障害報告の書き方

Smørgrav Dag-Erling [FAMILY Given]

寄稿:

Linimon Mark [FAMILY Given]

改訂: 43184
法律上の通知
2013-11-13 : hrs.
概要

この記事では、明瞭な障害報告 (Problem Report: PR) を FreeBSD プロジェクトに提出する方法を解説します。

[ 分割版 / 単一版 ]

目次
1. はじめに
2. いつ障害報告を提出すればよいのか
3. 準備
4. 障害報告の書き方
5. フォローアップ
6. 問題が起きたら
7. さらなる読みもの
索引

1. はじめに

ソフトウェアの利用者として経験するもっともいらただしいことの一つは、 それはバグじゃないひどい障害報告だ などのようなそっけなく理解の役に立たない説明によって、 障害報告があっさり片付けられてしまうことです。 同様に、ソフトウェア開発者が経験するもっともいらだたしいことの一つは、 実際は障害報告ではない単なるサポート要求や 何が問題でどのように再現するかについての情報が 乏しいまたは欠落している障害報告が殺到することです。

この記事のねらいは、上手な障害報告の書き方について説明することです。 上手な障害報告とはどういうものでしょうか? そうですね、単刀直入に要点を言えば、 上手な障害報告とは、迅速に解析を進め処理を行うことができ、 利用者と開発者がお互いに満足できるものです。

この記事では主として FreeBSD の障害報告に焦点を絞っていますが、 他のソフトウェアプロジェクトでも多くの部分が当てはまるでしょう。

この記事はテーマ別に整理されており、順番に読めるようにはなっていません。 そのため、段階を踏んだチュートリアルとして利用するのではなく、 障害報告を提出する前に全体を通して読むべきです。

本文書、および他の文書は ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/ からダウンロードできます。

FreeBSD に関する質問がある場合には、 ドキュメント を読んだ上で <questions@FreeBSD.org> まで (英語で) 連絡してください。

本文書に関する質問については、 <doc@FreeBSD.org> まで電子メールを (英語で) 送ってください。