QandA of QandA Project

FreeBSD QandA プロジェクトにおける査読作業の中で、よくある質問と How To をまとめました。

査読したはずなのに、コメント扱いされてるみたいなんだけど。
あらゆる査読は、Subjectに [QandA xxx] を含まないといけません。登録済 QandA の更新や削除をするつもりで、
　Subject: [Update xxx]
　Subject: [DEL xxx]
としても、このメールは意味を持ちません。また、以下の点をチェックしてみてください。
- 査読部分を ---cut here--- で囲んでいるか。
- ジャンル指定を行っているか (新規QandAの場合。登録済QandAの更新時はジャンル指定は省略できます)。
- ジャンル指定で、存在しないジャンル名を指定していないか。 →ジャンル一覧
- 「Q. 」、「A. 」という文字列があるか。
新しい QandA が送られてきたので、査読したい。
　To: QandA-work@jp.FreeBSD.org
　Subject: [QandA xxx]
として、査読結果を送ってください。
要は、Subject に [QandA 査読したい QandA の番号] が入っているメールを QandA-work 宛に送ればよいです。
登録済 QandA の更新案が送られてきたので、査読したい。
　To: QandA-work@jp.FreeBSD.org
　Subject: [QandA xxx] [Update yyy]
です。[QandA xxx] は更新案の番号を、[Update yyy] は更新したい登録済 QandA の番号を指定します。
登録前 (あるいは査読中) の QandA を削除したい。
　To: QandA-work@jp.FreeBSD.org
　Subject: discard [QandA xxx]
とすると即座に削除されます。査読は必要ありません。ですから削除したい QandA の番号を絶対に間違えないようにしてください。
登録済 QandA を削除したい。
　To: QandA@jp.FreeBSD.org
　Subject: [DEL xxx]
としてください。
複数の登録済 QandA を統合したい。
　To: QandA@jp.FreeBSD.org
　Subject: [Update xxx]
で、一方を更新した後に、
　To: QandA@jp.FreeBSD.org
　Subject: [DEL yyy]
で、もう一方を削除してください。
いったん査読したものを、訂正したい。
前に送ったものが承認されていないら、前回送った査読と同じく、
　To: QandA-work@jp.FreeBSD.org
　Subject: [QandA xxx]
として、訂正した査読結果を送りなおしてください。これは同時に複数の人が、同じ QandA に対して査読した場合、後のものが採用されることを意味します。
査読結果が既に承認/登録されてしまったなら、
　To: QandA@jp.FreeBSD.org
　Subject: [Update yyy]
で最初から出し直してください。
未登録 (あるいは査読中) の QandA に対してコメントを付けたい。
何も考えず、普通にリプライして下さい。
QandA の CVS リポジトリを取得してローカルで作業したい。
日本国内の CVSup サーバから jp-QandA コレクションを CVSup してください。例えば以下のような supfile を用意して cvsup を実行すれば /home/cvs に CVS リポジトリが作成されます。
```
---begin
*default host=cvsup.jp.FreeBSD.org
*default base=/home
*default prefix=/home/cvs
*default release=cvs
*default delete use-rel-suffix
*default compress

jp-base
jp-QandA
---end
```
次に適当なディレクトリで cvs -d /home/cvs co QandA として作業を始めてください。QandA/data ディレクトリに QandA の生データがありますので、これを利用すれば少しは楽に作業できます。なお、 QandA/Makefile はローカルで HTML ファイルを生成することができますので、テスト用に使えると思います。

make init
作業用ディレクトリの準備
make update
全ての HTML 及び TEXT ファイルを再生成
make 2
管理番号 2 の HTML 及び TEXT ファイルを再生成
make clean
`make update' により再生成可能な全ファイルを削除
make clobber
不要な全ディレクトリを削除
ジャンル変更だけ行いたい
普通に更新査読を行なってもかまいませんが、 QandA-work で相談して頂ければ管理者サイドで対応できます。可能であればパッチ形式で流して頂くと対応が楽になります。パッチは CVSup や CVSweb などを利用してダウンロードしたファイルを元に、Unified diff (diff -u) で差分を取ってください。CVS リポジトリがローカルにあれば、 cvs diff -u Qanda/data > file などとすれば良いでしょう。
QandA や QandA-work 宛にメールを送ったのに、 QandA 更新履歴に載っていないみたい。
HTML メール (Content-type: text/html) なメールを送っていませんか? HTML メールはメーリングリスト参加者には届きますが、spam 対策のため更新履歴の CGI では表示されないようになっています。メーラーの設定を見直して、プレインテキストのメールを送信して下しさい。