大杉のJAWS-UG CLI支部開催回数w #ssmjp
2021-08-10 19:20:01以前にいた部署内で自分を含む各メンバーが手順書を作成してた頃、色々な人が作成した手順書のレビュー時の指摘事項が、「てにおは」や(レビュアー好みの)文章表現など、本質とはあまり関係ない指摘(レベル0?)が中心だった。 あれは結構うんざりした。なつかしい。 #ssmjp
2021-08-10 19:23:37github、コードのプルリクは聞くけど、ドキュメントのプルリクって多いのかな。ドキュメントのみのリポジトリならそうしかないけど。。。 #ssmjp
2021-08-10 19:23:50設計思想(波多野さんの) 1. 低コンテキスト 2. 個別手順の独立性を高める 3. 個別手順は、可能な範囲で同じ構造とする。 #ssmjp
2021-08-10 19:24:56手順を低コンテキストにする。 途中で失敗しても、その手順で完結できるように。 前の手順どこまで戻る?みたいなのは避ける。 前の手順が前提になると、ちょっと手順が変わった(触る対象の仕様が変わったとか)の時に崩壊が始まるんですよね。。。 #ssmjp
2021-08-10 19:25:25ssmonline #14 に参加を申し込みました! ssmjp.connpass.com/event/219635/?… #ssmjp
2021-08-10 19:28:29手順書にできる作業って定常運用が大半ですよね。。。非定常作業まではなかなか手が出せない。 非定常運用の前処理(切り分け)と後処理(終息判定)はアウトライン化しておくといいですね。 #ssmjp
2021-08-10 19:30:52本番と検証環境差異あるのつら。。。開発環境も分けておくといいんですけどね。最近はクラウドでその辺も対応できるようになったんで便利。 #ssmjp
2021-08-10 19:33:46SIer, 手順書を作ろうとするとフォーマットがガチガチで、更新されなくて賞味期限切れする。 5年間、全く更新しない前提でもの作ってるの多いですからね。 「標準化だ!」という言葉の元、塩漬けが加速する。 ある程度、形態はシステムに合わせていきたいけどきついと思うオペが多いかな... #ssmjp
2021-08-10 19:37:04手順書のメンテに誰もコストを割こうとしないのよね… #ssmjp
2021-08-10 19:37:33手順書、えらい人がレビューするために word や excel になる。 wordやexcelは、手順書のメンテが辛いからきつい。。。 #ssmjp
2021-08-10 19:40:17「手順書コピーして書き直しもれ」→テンプレートしておく→承認もらうとかリリースまで遠くて修正が間に合ってなくて事故る、それなあ。。。(꒪⌓꒪) #ssmjp
2021-08-10 19:40:35