インフラエンジニアの毒舌な妹(むつきつぐみ)@日曜東V07a
@infra_imouto
肯定か否定かが重要な文脈で、体言止めをするとそれがあやふやになる 例)日本語で作業海洋を記述 #ssmjp
2021-08-10 19:42:34
kazzpapa3
@kazzpapa3
■定常運用→発生予想が可能 →変動要因が 内部→→定時作業 外部→→申請作業 ■非定常運用 →発生予想が不可能→変動要因が外部 →手順化が →→可能 →緊急対応 →→不可能→属人対応 ※緊急対応でも前処理(切り分けまで)、終息判定の基準になる後処理については手順化可能かつ有効 #ssmjp
2021-08-10 19:42:41
98lerr
@98lerr
手順書。 「タイトル、大見出し、中見出しは端的に内容を示す」 わかる!これができてない時点で、やりたいことが整理できてない感じある。 コード書くにしても、クラスもメソッドも内容わかるようにするのと同じですね。 #ssmjp
2021-08-10 19:43:15
kanata📖コマンドラインの黒い画面が怖いんです。4/19発売 予約受付中!
@kanata201612
あぁ~この日本語の話は設計書でもレポートでも全部同じだ~ #ssmjp わかりやすい日本語を書くのってすごい難しい…
2021-08-10 19:44:36
98lerr
@98lerr
「手順書で、一文は100文字以内」 ひたすら長い文書く人、確かにいる。 textlint でも、確か「、」3つ以上書くとチェックされたような。 md手順書で、linter入れるのは有効なのかなー。 長い文見ると、特許じゃないんだからと思う。 #ssmjp
2021-08-10 19:46:00
98lerr
@98lerr
「わかってる人にしかわからないドキュメントを書く」 これ、どこまで?ってありますね。 バイトでもわかるように書け、実際言われたことあります。 人の入れ替えが激しいから基礎から書けとなり、そこまで書くと手順書書ききれなくなり... 別教育にした方が楽じゃないかと思うことも。 #ssmjp
2021-08-10 19:49:27
笑われ男
@Waraware_man
なるべく純粋に手順だけを記述した手順書を作ったら、上司が「その手順の趣意を入れろ」と言われて、手順書がどんどん厚くなって分かりづらくなった経験はあります。 #ssmjp
2021-08-10 19:51:09