リビジョン間の差分をlivt URI単位で読む

ストーリールール提案中のルールテストが自動化している具体例疑問点ユビキタス言語

表示

リビジョン間の差分をlivt URI単位で読む→

ルール

#R-01

差分は、リビジョンを渡したビルドのときだけ現れる

livt: build_diff_test.go:3 livt: compare_test.go:4 livt: range_test.go:3

#EX-01

リビジョンを渡さないビルドは、これまでと同じサイトを出す

livt: build_diff_test.go:43

#EX-02

2つのリビジョンを渡すと差分のページが増える

livt: build_diff_test.go:68

#EX-03

リビジョンが1つなら、そのリビジョンと手元の作業ツリーの差分になる

livt: compare_test.go:389 livt: range_test.go:49

#EX-04

gitリポジトリでない場所や解決できないリビジョンを渡すと、ビルドはその場で失敗する

livt: range_test.go:113

#R-02

差分の単位はlivt URIで、リソースの種類ごとにまとまって並ぶ

livt: build_diff_test.go:4 livt: compare_test.go:5

#EX-01

ルールの文言が変わると、そのルールのURIが1件として並ぶ

livt: compare_test.go:101

#EX-02

ルールが1件増えると、そのURIが1件として並び、親の実例マッピングは重ねて並ばない

livt: compare_test.go:118

#EX-03

オポチュニティからユビキタス言語の用語まで、どの種類のURIも同じように並ぶ

livt: compare_test.go:145

#EX-04

どちらのリビジョンでも変わっていないURIは並ばない

livt: build_diff_test.go:181 livt: compare_test.go:134

#EX-05

ルール・具体例・疑問点は、属する実例マッピングの下にまとまる

livt: build_diff_test.go:141

#EX-06

実例マッピングの下では、ルールも具体例もIDの順に並ぶ（ファイルに書いた順ではないので、同じルールの廃止と追加が並んで読める）

livt: compare_test.go:240

#R-03

差分は追加・変更・廃止の3通りで、git diffの赤緑で読める。ただし赤緑が言うのはファイルではなく決定

#EX-01

追加されたURIは緑、廃止されたURIは赤で並ぶ

#EX-02

文言が変わったURIは、変わった行だけが赤と緑の対で並ぶ

livt: compare_test.go:267

#EX-03

変わっていない行は、前後の地として同じ場所に残る

#EX-04

ページの先頭に、追加・変更・廃止がそれぞれ何件かが出る

#EX-05

ファイルごと消えたものも退役したものも、同じ廃止として読める（読む側にはどちらも「もう合意されていない」で同じ）

#EX-06

1つの付箋に付く印は1つだけ（退役は機械的にはstatusの変更だが、その付箋に起きたことは廃止のひとつ）

#EX-07

廃止された項目は、記録上どう書かれていても赤い「-」で並ぶ（退役はファイル上「退役」の行が増えるが、決定としては削除と同じく「この文が無くなった」）

livt: build_diff_test.go:320 livt: compare_test.go:299

#EX-08

退役したことを書いた行そのもの（「退役」やstatusの変更）は出ない。それは廃止という印が言っている。後継だけが残る

#R-04

ボードが隠している変更も、差分には映る

livt: compare_test.go:6

#EX-01

ルールが退役すると廃止として並び、そのURIは解決し続ける（ボードから消えても、IDは解放されていない）

livt: compare_test.go:281

#EX-02

提案中のルールが合意されると、statusの1行の変更として並ぶ

livt: compare_test.go:328

#EX-03

どちらのリビジョンでも退役したままの項目は、差分に出ない

livt: compare_test.go:344 livt: compare_test.go:624

#R-05

差分とそのURIのページは、互いに辿れる

#EX-01

追加・変更されたURIは、そのURIが着地するページへ辿る

livt: range_test.go:73

#EX-02

ファイルごと消えたURIは、辿る先を持たない

livt: build_diff_test.go:165

#EX-03

変わったURIのページにはその場で印が付き、差分の該当箇所へ着地する

livt: build_diff_test.go:92

#EX-04

差分はサイドバーに項目を持たない（リソースの種別ではなく、リソースに付く注釈だから）

livt: build_diff_test.go:79

#EX-05

廃止された付箋は、提案中のルールと同じ淡い破線で戻され、廃止の印が付く

livt: build_diff_test.go:246

#EX-06

ページごと無くなったものは、それが載っていた一覧が件数で告げる

#R-06

差分はYAMLの綴りではなく、ルールや具体例の言葉で読める

livt: build_diff_test.go:5 livt: compare_test.go:7

#EX-01

ルール・具体例・疑問点・用語の本文は、キーを伴わずその文だけが並ぶ

livt: compare_test.go:416

#EX-02

状態や自動化のようなlivtが持つ項目は、サイトが使っている言葉で並ぶ

livt: build_diff_test.go:192

#EX-03

文言が変わった行は、行のどこが変わったかが中で際立つ

livt: compare_test.go:429

#R-07

集めたレポートの変化は、引用されたルールや具体例の変更として差分に映る

livt: range_test.go:138

#EX-01

テストが新たに引用したルールや具体例には、それを自動化した実装リポジトリの行が緑で増える

livt: compare_test.go:539

#EX-02

ある実装リポジトリからの引用がすべて消えると、その行が赤で並ぶ

livt: compare_test.go:569

#EX-03

rev・生成時刻・revから組むURLのように、走査のたびに動くものは差分に出ない

livt: compare_test.go:591

#EX-04

テストの移動や改名、同じ実装リポジトリの中で引用するテストが増減しただけでは差分に出ない（PRを出すかを決めるのと同じく、引用の集合で比べる）

livt: compare_test.go:607

疑問点

#Q-01 差分を載せたサイトを公開するか（いまのサイトはGitHub Pagesへ公開される。差分はレビューのあいだだけのものなので、同じ出力先に出していいか）

#Q-02 レビュアーは手元でビルドを走らせるのか、PRから差分に辿り着けるべきか（後者ならCIとプレビューの公開が要る）

#Q-04 付箋の並び替えだけの変更を差分として映すか（livt URIは変わらないが、ボードの見えは変わる）

#Q-05 ルールにも具体例にも付かない引用（解決しないURIなど）が増減したとき、差分にどう映すか（付く先が無いので映らず、レポートのPRが開いても差分は空になりうる）

ユビキタス言語

livt URI→ livtリポジトリ→ 実装リポジトリ→ 実例マッピング→