Release note のための英文テンプレート集 - pyopyopyo - Linuxとかプログラミングの覚え書き -
昨日 Changelogのための英文テンプレート集 - ぴょぴょぴょ？ - Linuxとかプログラミングの覚え書き - というエントリを書きましたが，その際 apple や microsoft が出すような Release note と，いわゆるオープンソースなプロジェクトが出す release note や changelog とでは英文の書き方が異なることに気が付きました．蛇足気味ですが，興味深かったので別エントリとしてまとめます． ポイント 不具合を，不具合と言わない bug，problem，fix といった単語は，他の言葉で言い換えます 旧製品も完璧だったが，新製品はもっと良い製品だよという言い回しが基本です．会社的に不具合を認めると面倒ですからね． 免責事項を強調 良く使う単語 issue (problem, bug の言い換え) update, improve, address
steps to phantasien t(2007-06-01) ChangeLog の作法 つづき
Subversion の開発者が ChangeLog について面白い記事を書いている. 記事の要旨はこうだ: ChangeLog (Subversion なので commit log) を書くのは面倒だよ, メーリングリストもあることだし書かなきゃダメ? ってよく訊かれる. 書きましょう. バグトラックもあるけど, 書きましょう.これらのツールは補完しあっている. メーリングリストはノイズが多いし, 変更を特定するには情報が足りない. バグトラックはバグの記録がメインだからコードの話を細々書くのは邪魔になる. 変更については ChangeLog に書くのがいい. プログラマは ChangeLog を読む. 記録を検索して, どの関数に何が起きたかを調べるものだ. この類の記録は ChangeLog を読まないとわからない. 逆に ChangeLog を書く時は, それを特定できるように省略
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
