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
550
「改訂版ブルーム・タキソノミー」を利用したソフトウェアドキュメンテーションの改善手法の提案
Honahuku
March 14, 2025
Tweet
Share
More Decks by Honahuku
See All by Honahuku
Kubernetes のスケーラビリティを左右するデータストアの話
honahuku
0
54
KubeCon + CloudNativeCon Japan 2025 に行ってきた! & containerd の新機能紹介
honahuku
0
160
Kubernetes のクラスタ内ネットワーク概要
honahuku
1
52
エンジニアでも論文が読みたい!
honahuku
0
990
大規模コンピューティングを支える Kubernetes のネットワーク
honahuku
0
270
今から始める分散システム
honahuku
0
320
SecAd~Ad data drivin’ network security~
honahuku
0
190
Other Decks in Programming
See All in Programming
Swift Concurrency - 状態監視の罠
objectiveaudio
2
550
PHPに関数型の魂を宿す〜PHP 8.5 で実現する堅牢なコードとは〜 #phpcon_hiroshima / phpcon-hiroshima-2025
shogogg
1
270
技術的負債の正体を知って向き合う
irof
0
190
Leading Effective Engineering Teams in the AI Era
addyosmani
7
490
『毎日の移動』を支えるGoバックエンド内製開発
yutautsugi
2
250
CSC305 Lecture 05
javiergs
PRO
0
220
What's new in Spring Modulith?
olivergierke
1
160
Foundation Modelsを実装日本語学習アプリを作ってみた!
hypebeans
0
120
Introduce Hono CLI
yusukebe
6
2.9k
CSC305 Lecture 04
javiergs
PRO
0
270
TFLintカスタムプラグインで始める Terraformコード品質管理
bells17
2
310
「ちょっと古いから」って避けてた技術書、今だからこそ読もう
mottyzzz
11
6.9k
Featured
See All Featured
The Straight Up "How To Draw Better" Workshop
denniskardys
238
140k
Java REST API Framework Comparison - PWX 2021
mraible
34
8.9k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
smashingmag
253
22k
Measuring & Analyzing Core Web Vitals
bluesmoon
9
620
Producing Creativity
orderedlist
PRO
347
40k
[RailsConf 2023 Opening Keynote] The Magic of Rails
eileencodes
31
9.7k
Connecting the Dots Between Site Speed, User Experience & Your Business [WebExpo 2025]
tammyeverts
10
600
Easily Structure & Communicate Ideas using Wireframe
afnizarnur
194
16k
Unsuck your backbone
ammeep
671
58k
Mobile First: as difficult as doing things right
swwweet
225
10k
Fantastic passwords and where to find them - at NoRuKo
philnash
52
3.4k
Gamification - CAS2011
davidbonilla
81
5.5k
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