手順書を作る側と使う側からの作成術

手順書を作る側と使う側からの作成術第１回手順書Night　めぐみ 1

今宵のLTの内容 1. 使う側の視点 2. 作る側の視点 3. まとめ 4. おまけ 2

使う側

使う側としての視点 • 使う側として手順書を読むまたは使う場合 ◦ 誰がやっても同じ結果になる ◦ 自分が必要な情報にたどり着きたい（検索性と見出しと階層構造が大事） ◦ 更新頻度は必要に応じて高いほうがありがたい ◦
作成者には気づいた点を共有する、フィードバックを行う 4

作る側

手順書作成のフロー 1. 作成依頼・更新依頼が届くまたは更新したい箇所が発生する 2. 作成する・共同編集する、できれば作成するメンバーでコメントベースでのレビューを行う 3. レビュー係に手順書をPDFで渡す 4. レビューからの指摘と修正箇所の訂正の繰り返し
5. 校了 6. 判定・承認 7. 公開や展開および共有の手続き 6

手順書の作成と更新の違い • 作成･･･０から作る場合 ◦ 手順書の最低限のルールを作成して誰でも簡単にかけるようにする ▪ バージョン管理のルール決め ▪ ファイルの命名規則決め ◦
目次および階層構造をつくる(複数人で検討するほうがよい) ◦ 読み手や対象（管理者・利用者）の検討、粒度を読み手によって変更する • 更新･･･途中から引き継ぐ場合 ◦ 前任者の癖を把握し、書き手の癖を出さない ◦ 読みにくい読み進めにくいところは容赦なくリライトする ◦ 踏襲しつつも変更を躊躇わない ◦ 新規・追加事項は挿入場所をよく検討する、手順の流れを止めない 7

手順書を作成する５つの技術

手順書を作成する技術　１～３１なるべくシンプルにする ◦ 一文二義まで、できれば一文一義 ◦ 文と画像は１対１対応 ◦ 不要な文は削ぎ落とす２付録をつける ◦
CSV書式一覧、リンク集など３文書ソフトの表をうまく使う ◦ ひとつの表でコピーペーストが必要なものをまとめる ◦ コマンドラインを背景黒で（印刷しない手順書前提）表示する ◦ 行頭を揃えたいものを無色の表で揃える 9

コピーペーストしてもらいたいなにか揃えたいなにか CPU ※※ OS Windows >ipconfig /all コンソールでの作
業だとわかる抜粋したほうが扱いやすいインデントを揃えやすく 10

手順書を作成する技術　４～５４言葉がぶれないようにする ◦ 用語集を作成する（書き手の共通言語、俗語や省略語も正式名に） ◦ 開発者や技術者が使うことばを専門用語から一般用語へ落とし込む（例：デフォルト→初期設定や初期値） ◦ 固有名詞や専門用語は必ず初出のときに補足を書く５文書ソフト・アプリの機能を使いたおす
◦ 文や単語を揃える・目次挿入などは機能をうまく使う ◦ 見出し機能や検索や置換は人の目や手に頼らない、正規表現を使えるとなおよし。 11

まとめ

手順書を作る側でありながら、使い手にインタビューを行い、改訂時にフィードバックを活かす使う側の視点があるからこそ、作る側はもっといい手順書をつくることができる 13

おまけ

おまけ（作り手としてしんどいこと） • ユーザーインターフェースや細部のボタンなどが変更になった際の画面差し替え（工数がかなりかかる、腱鞘炎の原因になりうる） • コマンドが古くなった際の変更（裏付けを取る工数が地味にかかる） • 繁忙期の現場業務と手順書作成の納期が同じ期間にある場合の両立 • 具体策のない改善要望（汲み取るのが難しい、その人固有の考え方であ
ることが少なくない） • 意図が読み取りにくい指摘事項（指摘する側も基本的な文章添削能力がないと陥りやすい） 15

おまけ（手順書を作るにあたって学んだこと） • ブックリスト一般財団法人テクニカルコミュニケーター協会 (2016)『日本語スタイルガイド(第3版)』, テクニカルコミュニケーター協会出版事業部髙橋慈子(2018)『技術者のためのテクニカルライティング入門講座』 ,翔泳社
芦屋広太(2020)『エンジニアのための文章術再入門講座新版状況別にすぐ効く！文書・文章作成の実践テクニック』,翔泳社樋口恵一郎(2021) 『良いFAQの書き方──ユーザーの「わからない」を解決するための文章術』 ,技術評論社 • オンライン Google Technical Writing Courses https://developers.google.com/tech-writing 16

手順書を作る側と使う側からの作成術

手順書を作る側と使う側からの作成術

hutegmin

Other Decks in Technology

Featured

Transcript