覚書

TicketやIssueにSlackの情報を含める場合はURLを貼るだけじゃなくて引用するかサマライズするとよい

Slackで議論した内容やオペレーションの記録などをTicketやIssueに含めるということは結構あると思う。このとき、URLを貼るだけじゃなくて引用するかサマライズした方がよいという話。 特に、スレッドで結構長く議論したり調査やオペレーションした記録をTicketやIssueに含める時にURLだけ貼ると、後から見た時にコンテキストを理解することが非常に難しい。タイムラインの頭から最後まで読まないといけないからだ。なので、URLを開かなくてもコンテキストがわかるようにサマライズすると後から見た時や他の人が見たときに理解しやすくなる。URLを開く手間も省ける。単発の投稿のURLの場合は投稿内容を引用しておく。 URLを貼ること自体は議論のソースを確認するために必要なものだ。しかし、そのTicket・Issueの内容はTicketのDescriptionを読めばわかるようになっているのがよいTicket・Issueだと僕は考えている。多くの場合、後からSlackのURLを開いてみてもいまいちコンテキストがわからなないんだよな…自分が議論していたスレッドですらそう。