インフラエンジニアの綺麗で優しい手順書の書き方

PostgreSQLのロール管理とその注意点（Open Source Conference 2022 Online/Osaka 発表資料）

[kiyokura]

手離れよく退職するためにもこういうの必要()

[sonots]

手順書内で完結スゴイけど、それはツラい…って気持ちもある。同じような手順書書くのが二回目の時とか

[arisane]

“ちなみに 弊社で手順書を書いてるツールは Confluenceです” Excel以外にも手順書を書く手段があるのか(血涙)

[hokorobi]

あえて誤字を入れてるのかな。大事なことなので二度書いてあります？

[decoy2004]

SoftwareDesign 記事はコードに「図1」連番振ってある。Markdown はクロスリファレンスや脚注書くと番号合わせが面倒。 org-mode は楽。

[masayoshinym]

ルー語はそこそこ理解できるのでそんな悪者扱いしなくても。

[yujiorama]

"手順書は優しさです" "手順書内完結を目指す"

[jojo800]

まぁでも作業の度に手順書量産するの辛い…

[regularexception]

手順書は見やすいのかもしれないが、このスライドは読みにくい

[yancy1969]

度合いによるけどワースケースシナリオとロールバックプランも書いた方がいい

[northlight]

いいこと書いてるなあ・・・

[naga_sawa]

手順書の書き方/インフラエンジニアに限らず

[pmakino]

「手順書を書いてるツールはConfluence」「図の製作はCacooがおすすめ」

[winterfall]

sionじゃん

[kumaroku]

Excelに画像コピペの話だとばっかり…

[zia_glass]

手順書の書き方

[tetzl]

Confluence使ってるとのこと。手順書の手順書というか。手段を目的化しないという意味で「手順書のあり方」をちゃんと定義する必要あるよなーとか思った。

[HF_frt1623]

手順書の書き方とても大事。現在の同僚のためにも、未来の私のためにも。読む人にやさしいマニュアル、手順書を書きたいものです。

[nilab]

同じ手順なら目次や内容をそっくりに。コードブロックにはsyntaxハイライト。rootのプロンプトも$で(コメントアウトと見誤る)。コマンド毎に説明。基本ググらせない、手順書内で完結。手順書内で行ったり来たりしない。

[yasuharu519]

手順書

[yhys07]

社内で何度書式を統一させようとしたことか…

[seikenn]

いいね

[dekasasaki]

手順書は優しさ！

[gin0606]

いい人っぽい。

[Sean_SF]

“ちなみに 弊社で手順書を書いてるツールは Confluenceです”

[bunnyhop]

sionだ/アトラシアンなら実施毎にJIRAのほうがマークアップ同じだしclone辿れるし良いと思う/もっというとレビュー的にGitで管理してプルリのフローに乗っけたほうが良い

[yetch]

めげる。

[FunnyBunnyDizzy]

レビュー観点の一覧になってて素晴らしいな

[kiyo1961]

なるほど

[sion_cojp]

誤字や重複行（ページ）を修正しました！皆様ご指摘ありがとうございます

[sopra]

新卒でもわかるは大事。コンフルはテンプレートが作れるので上手く利用すれば手順書書くのが楽になる。 ロールバック手順を章を分けるか別文書にするかはいつも迷う。

[bps_tomoya]

当たり前のことだと思いつつも「手順書で簡潔している（ググらせるな）」というのが常に意識できてるかなァと改めて振り返らせられた。

[naqtn]

"図は線は太く少なく、文字も太く見やすく"

[yoshi-shigano]

confluenceか。ちょっと興味ある。