Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
ドキュメント、その前に。
Search
Tsumu-gu
February 15, 2025
0
770
ドキュメント、その前に。
Tsumu-gu
February 15, 2025
Tweet
Share
Featured
See All Featured
Sharpening the Axe: The Primacy of Toolmaking
bcantrill
43
2.4k
It's Worth the Effort
3n
184
28k
Statistics for Hackers
jakevdp
799
220k
VelocityConf: Rendering Performance Case Studies
addyosmani
330
24k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
252
21k
For a Future-Friendly Web
brad_frost
179
9.8k
How to Think Like a Performance Engineer
csswizardry
24
1.7k
Into the Great Unknown - MozCon
thekraken
39
1.9k
Why Our Code Smells
bkeepers
PRO
337
57k
Optimizing for Happiness
mojombo
379
70k
Designing Dashboards & Data Visualisations in Web Apps
destraynor
231
53k
Imperfection Machines: The Place of Print at Facebook
scottboms
267
13k
Transcript
ドキュメント、 その前に。 2025.2.15 (土) JBUG 広島 #15 by つむ ※
この⾊の⽂字が、イベント後 追補した記述です
つ む 1978 年 広島市安佐南区生まれ。 広島市安佐南区育ち 広島市安佐南区在住。少しは外へ出ろ。 20年近くFrameMakerとFlashのDTPオペレーターに従事。 40歳になるのを機に元々憧れだったWeb 業界へ潜り込む。
約1年後に無謀にもフリーランスへ。 「つむ」は屋号の「紡ぐ」から。 もとは「つむつむ」という名だったが、 あまりにも「ディズニーツムツム好きなんですか?」と 問われるため、「つむ」にこっそり改名…。 なお、ディズニーツムツムは一度もしたことありません。 X (@gu_tsumu) フリーランス フロントエンドエンジニア / ディレクター
ドキュメント、その前に。 ド。〜その前にあるものは?〜
突然ですが 質問です 1 / 32
2 / 77 ドキュメント作成、スムーズに進んでいますか? みなさんのチームでは
3 / 77 「ドキュメントを作っても使ってもらえない」とか
4 / 77 「ドキュメントを作った⼈にしかわからない」とか
5 / 77 みんなが好きなように作りすぎて いてなにがなんだかもうわからな い。など、てんやわんやになって しまったことはないでしょうか?
6 / 77 H o w ? H o w
m u c h ? W h o m ? W h i c h ? W h y ? W h o ? W h e n ? ドキュメントを作成する際、「どう書くか」「どのツールを使うか」「誰が管理するか」 といった点に注⽬されがちですが、それ以前に …
7 / 77 心理的安全性 の 確保 H o w ?
H o w m u c h ? W h o m ? W h i c h ? W h y ? W h o ? W h e n ?
8 / 77 心理的安全性とは メンバーが、 と信じていること 無知 無能 ネガティブ 邪魔だと思われる可能性のある行動をしても
このチームなら大丈夫だ ⼀⾔で⾔うと、 「チーム内で、互いに、率直であることが許される」 ということ。
9 / 77 心理的安全性とは Amy Edmondson Administrative Science Quarterly Project
Aristotle Psychological Safety and Learning Behavior in Work Teams
10 / 77 心理的安全性が確保されているか? 具体的に、どのような職場環境が⼼理的安全性を確保されているといえるのか、考えてみます。
11 / 77 Case 1 生返事 目は画面 忙しそう! 邪魔なのかな… 「どうしたの?」
例えば、質問に対し、 仕事の⼿を⽌めずに返事をする。
12 / 77 Case 1 そのほかにも、1 on 1の場で、最初に 「よく来てくれたね」と告げる。 当たり前のことを省略せずに伝えます。
「相⼿が今、ここにいる」ことを 承認するわけです。 これを「存在の承認」といいます。 ⾃分はここにいても良いのだ、と、 相⼿に感じてもらうことが⼤切です。
13 / 77 Case 2 余計だったかな… 「担当以外の作業?」 ⾃らの⼯数を使⽤して、マニュアルを作った部下に対して どう⾔葉をかけますか?
14 / 77 Case 2 必要のないマニュアルだったかもしれません。 しかし、チームのことを考えてマニュアルを作ったことに変わりはありません。 ですので、まずは、「マニュアルを作ったんだね」と、⾏動そのものを認めます。 その⼈それぞれの「精⼀杯の⾏動」を 認める。結果の良し悪しに関わらず。
これを「⾏動の承認」といいます。 トライしても良いのだ、 という安⼼感が⽣まれます。
15 / 77 Case 3 必要だと思うけど… 「優先順位はなに?」 マニュアルを作ってくれたメンバーに、理由を聞いてみましたが、 良い理由とは思えませんでした。 今あるタスクより優先すべきとは思えなかったのです。
どういう⾔葉をかけますか?
16 / 77 Case 3 「そんな考えもあるね」「そう感じているんだね」 「今は優先タスクがあるけれど、また改めて時間をとろう」はいかがでしょうか。 優先すべきタスクは理解した。でも⾃分の思いも汲み取ってもらえた!と感じられるよう返答します。 あなたの考えは確かに受け取った、という「⾒識の承認」が⽣まれます。
17 / 77 Case 4 相手にされてない… 「また後で」 最後のケースです。前のページで「また改めて時間をとる」と伝えました。 忙しいので致し⽅ありませんが、つい、忘れてしまいます。
18 / 77 Case 4 「後で」「改めて」と⼀旦おいておいたことがらは、必ず実⾏します。 相⼿は「あのこと、覚えていてくれたのだ!」と感じます。 「時を超えた承認」が⽣まれます。
19 / 77 正しいは正義か? 「シゴデキ」タイプほど「正解戦争」をしがちです。 「正解」を武器にお互い戦っても解決策は出ません。 ワンマンは⼀時的に業績が上がったとしても、チームとしては衰退します。
20 / 77 正しいは正義か? ぐっと⼀呼吸おいて、メンバーを理解し、受け⽌め、 ⼀旦保留としても忘れず改めて向き合うことが、 チームの⼼理的安全性を⾼めると私は考えています。
21 / 77 メンバーが、 と信じることによって… 無知 無能 ネガティブ 邪魔だと思われる可能性のある行動をしても このチームなら大丈夫だ
まとめ 心理的安全性 の 確保 ⼼理的安全性を確保し、⾼めることによって「質問しやすい雰囲気が醸成」され 「 失敗や改善点がオープンにされやすくなり」「属⼈化が避けられ」ます。
22 / 77 ドキュメントがスムーズに作成・運用される まとめ
23 / 77 ドキュメント、その前に。 ド。〜その前にあるものは?〜 まとめ
24 / 77 まとめ ド。の前は シ。
25 / 77 より良いドキュメントライフを!
26 / 77 宣伝 最後にちょびっと
27 / 77
None
None
None
None
32 / 77 ご清聴ありがとうございました 「ドキュメント、その前に。」
お ま け アップロード資料用
参考資料
使用素材
さ ら に お ま け アップロード資料用
改めてスライドを眺めてみると、あまりにも当たり前のことを言っていますね。 でも、その当たり前ができるかどうかが、より良いドキュメントの、ひいてはより良いチームへの 分岐点だと思います。 そして、当たり前のことを「納得感」をもって相手に伝えることができるか、も、 私はドキュメント制作に必要なスキルの一つだと思います。 ではでは、本当にこれで終わりです。 最後までご覧くださり、ありがとうございました! 2025.2.15 つむ 拝