github-reporadar 0.8.0 → 0.10.0

package/README.md

@@ -161,9 +161,11 @@ npx github-reporadar --org example-company --watch 1m
 
 初回の同期では何も出しません。溜まっていた分を一斉に出すと、新しく起きたことが埋もれるためです。画面のバッジと通知は次の版で入ります。
 
-出す順は「誰が止まっているか」で3つに分け、同じ組の中では組織のrepoを先に置きます。個人のrepoは下にまとまります。依存更新のPRのように、botが起こしたレビュー依頼は「他人を待たせている」には入れません。人は止まっていないためです。
+出す順は「誰が止まっているか」で分け、同じ組の中では組織のrepoを先に置きます。Confluenceの更新は「Wikiの更新」として独立した組にし、「あなたの番」の下、「知らせ」の上に置きます。GitHubの知らせと同じ組に混ぜると、他人が直したデザインルールが数十行の下に沈んで見えなくなります。個人のrepoは下にまとまります。依存更新のPRのように、botが起こしたレビュー依頼は「他人を待たせている」には入れません。人は止まっていないためです。
 
-読んだものはその場で一覧から消えます。1件ずつの「既読」と、リンクを開いたときの既読があり、どちらもその1件だけを消します。それより古い未読は残ります。「すべて既読」は時刻で一気に消します。消えたものは「履歴」で見られます。
+一覧は「何が起きたか」ではなく「どこで起きたか」で1行にします。同じPRにレビューが7回付いても1行で、見出しは最新のもの、残りは「ほか6」と添えます。1つのPRを7行に割ると、1行ずつ既読にしても同じPRの別の行が残り、読んでも減らないように見えるためです。
+
+読んだものはその場で一覧から消えます。1件ずつの「既読」と、リンクを開いたときの既読があり、どちらもその行にまとまっている出来事をまとめて消します。それより古い未読は残ります。「すべて既読」は時刻で一気に消します。消えたものは「履歴」で見られます。
 
 ### 平日の勤務時間だけ動かす(macOS)
 
@@ -240,10 +242,14 @@ launchdは対話シェルの`PATH`を継がないので、`install.sh`が実行
 
 ### Confluenceとの齟齬を出す(Atlassian連携)
 
-ページを書いたあとに実装が進んだものを「Wiki要確認」として出します。自分が関わったページを取り、本文と題に出てくるrepo名を拾い、そのrepoのpushがページ更新より新しければ挙げます。
+ページを書いたあとに実装が進んだものを「Wiki要確認」として出します。本文と題に出てくるrepo名を拾い、そのrepoのpushがページ更新より新しければ挙げます。自分が関わったページと、見張っているフォルダの配下が対象です。他人が書いたページには「他人のページ」と添えます。
 
 前提はこうです。値そのものは実装が正で、ページはその意図と使い方を書く場所です。だから食い違いが出たときに直す先はページのほうです。押すとそのページが開きます。
 
+1ページ1行です。1枚のページが4つのrepoに触れていれば、repoは遅れの大きい順に並べて「ほか3」と添えます。repoごとに行を割ると、同じ題が何度も並びます。
+
+「確認」を押すとその行は消え、数が減ります。押した時点でいちばん新しかったpushを覚えていて、そのあとに実装が進めばまた出ます。スプリントの記録のように一度読んだら読み直さない文書には「もう見ない」を使います。こちらはpushが来ても二度と出しません。Wikiのページは閉じることがなく残り続けるので、GitHubのPRのように「解決したら終わり」になりません。だから人が見て「いまは直さない」と決めたものを数から外せるようにしています。消したものは「履歴」で見られます。
+
 トークンはファイルに置かず、macOSのキーチェーンから実行時に取ります(`gh`と同じ考え方)。JiraとConfluenceは同じサイトと同じトークンを使います。
 
 ```bash