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
Honahuku
March 14, 2025
Programming
0
470
「改訂版ブルーム・タキソノミー」を利用したソフトウェアドキュメンテーションの改善手法の提案
Honahuku
March 14, 2025
Tweet
Share
More Decks by Honahuku
See All by Honahuku
KubeCon + CloudNativeCon Japan 2025 に行ってきた! & containerd の新機能紹介
honahuku
0
120
Kubernetes のクラスタ内ネットワーク概要
honahuku
1
46
エンジニアでも論文が読みたい!
honahuku
0
870
大規模コンピューティングを支える Kubernetes のネットワーク
honahuku
0
160
今から始める分散システム
honahuku
0
310
SecAd~Ad data drivin’ network security~
honahuku
0
180
Other Decks in Programming
See All in Programming
ふつうの技術スタックでアート作品を作ってみる
akira888
1
490
LT 2025-06-30: プロダクトエンジニアの役割
yamamotok
0
730
ソフトウェア品質を数字で捉える技術。事業成長を支えるシステム品質の マネジメント
takuya542
1
12k
Deep Dive into ~/.claude/projects
hiragram
14
2.5k
#kanrk08 / 公開版 PicoRubyとマイコンでの自作トレーニング計測装置を用いたワークアウトの理想と現実
bash0c7
1
710
iOS 26にアップデートすると実機でのHot Reloadができない?
umigishiaoi
0
130
生成AI時代のコンポーネントライブラリの作り方
touyou
1
170
“いい感じ“な定量評価を求めて - Four Keysとアウトカムの間の探求 -
nealle
1
9.1k
A full stack side project webapp all in Kotlin (KotlinConf 2025)
dankim
0
110
来たるべき 8.0 に備えて React 19 新機能と React Router 固有機能の取捨選択とすり合わせを考える
oukayuka
2
920
Quand Symfony, ApiPlatform, OpenAI et LangChain s'allient pour exploiter vos PDF : de la théorie à la production…
ahmedbhs123
0
170
第9回 情シス転職ミートアップ 株式会社IVRy(アイブリー)の紹介
ivry_presentationmaterials
1
280
Featured
See All Featured
Six Lessons from altMBA
skipperchong
28
3.9k
Into the Great Unknown - MozCon
thekraken
39
1.9k
Rails Girls Zürich Keynote
gr2m
94
14k
Being A Developer After 40
akosma
90
590k
Stop Working from a Prison Cell
hatefulcrawdad
270
21k
VelocityConf: Rendering Performance Case Studies
addyosmani
332
24k
ピンチをチャンスに:未来をつくるプロダクトロードマップ #pmconf2020
aki_iinuma
126
52k
Design and Strategy: How to Deal with People Who Don’t "Get" Design
morganepeng
130
19k
A designer walks into a library…
pauljervisheath
207
24k
The Web Performance Landscape in 2024 [PerfNow 2024]
tammyeverts
8
680
Building a Modern Day E-commerce SEO Strategy
aleyda
42
7.4k
It's Worth the Effort
3n
185
28k
Transcript
「改訂版ブルーム・タキソノミー」を利用 したソフトウェアドキュメンテーション の改善手法の提案 情報処理学会 第87回全国大会 Honahuku
情報処理学会 第87回全国大会 情報処理学会 第87回全国大会 ドキュメントで熟練者が持つ知識のすべてを 網羅することは難しい はじめに 2 doc 熟練者
他の開発者 分かるはず 不十分
情報処理学会 第87回全国大会 情報処理学会 第87回全国大会 創造 評価 分析 応用 理解 記憶
ブルーム・ タキソノミー 3 認知的領域を6段階に分類
情報処理学会 第87回全国大会 アンケートによる理解度調査 4
情報処理学会 第87回全国大会 概要 5
情報処理学会 第87回全国大会 認識の齟齬 6 doc 熟練者 他の開発者 分かるはず 不十分 ドキュメントで熟練者が持つ知識のすべてを
網羅することは難しい
情報処理学会 第87回全国大会 認識の齟齬 7 • 手順・仕様・コードの説明 • APIリファレンス • システム構成図
• 設計の背景や意図 • 捨てられた選択肢とその理由 • よくあるエラー・デバッグ • チームの開発文化 • 過去の試行錯誤や技術選定の履歴 表現しやすい情報 暗黙知・省かれがちな情報
情報処理学会 第87回全国大会 ブルーム・タキソノミーによる 理解度の可視化 8
情報処理学会 第87回全国大会 アンケートによる理解度の測定 9
情報処理学会 第87回全国大会 理解度の可視化 10
情報処理学会 第87回全国大会 考察 • 熟練者が単独で実装したシステムは理 解度の差が大きい • ドキュメントが不足しているシステムは 開発者全員の理解度が低い •
頻繁に使われるツールは理解度の差が 小さい 11
情報処理学会 第87回全国大会 ドキュメントの改善に向けて • 理解度の差が大きいシステム → 優先的にドキュメントを充実させる • 理解度が低いシステム →
チームで知識を共有しやすい形にする • 熟練者の頭の中にある情報(暗黙知)を意識的 にドキュメント化する 12
情報処理学会 第87回全国大会 まとめ • 熟練者は他の開発者の理解度を正しく 把握しづらい(知識の呪縛) • ブルーム・タキソノミーを活用した理解度 の計測、アンケート調査 •
熟練者への依存度が高いシステムの可 視化が行われた 13