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
490
「改訂版ブルーム・タキソノミー」を利用したソフトウェアドキュメンテーションの改善手法の提案
Honahuku
March 14, 2025
Tweet
Share
More Decks by Honahuku
See All by Honahuku
KubeCon + CloudNativeCon Japan 2025 に行ってきた! & containerd の新機能紹介
honahuku
0
140
Kubernetes のクラスタ内ネットワーク概要
honahuku
1
47
エンジニアでも論文が読みたい!
honahuku
0
900
大規模コンピューティングを支える Kubernetes のネットワーク
honahuku
0
180
今から始める分散システム
honahuku
0
310
SecAd~Ad data drivin’ network security~
honahuku
0
180
Other Decks in Programming
See All in Programming
ご注文の差分はこちらですか? 〜 AWS CDK のいろいろな差分検出と安全なデプロイ
konokenj
4
710
はじめてのWeb API体験 ー 飲食店検索アプリを作ろうー
akinko_0915
0
170
Claude Code で Astro blog を Pages から Workers へ移行してみた
codehex
0
160
顧客の画像データをテラバイト単位で配信する 画像サーバを WebP にした際に起こった課題と その対応策 ~継続的な取り組みを添えて~
takutakahashi
4
1.4k
中級グラフィックス入門~効率的なメッシュレット描画~
projectasura
3
1.7k
AIコーディングエージェント全社導入とセキュリティ対策
hikaruegashira
15
8.4k
ソフトウェア設計とAI技術の活用
masuda220
PRO
25
6.9k
Prompt Engineeringの再定義「Context Engineering」とは
htsuruo
0
110
階層化自動テストで開発に機動力を
ickx
1
440
The Modern View Layer Rails Deserves: A Vision For 2025 And Beyond @ RailsConf 2025, Philadelphia, PA
marcoroth
2
820
GPUを計算資源として使おう!
primenumber
1
290
SQLアンチパターン第2版 データベースプログラミングで陥りがちな失敗とその対策 / Intro to SQL Antipatterns 2nd
twada
PRO
34
10k
Featured
See All Featured
[Rails World 2023 - Day 1 Closing Keynote] - The Magic of Rails
eileencodes
35
2.5k
Side Projects
sachag
455
43k
Raft: Consensus for Rubyists
vanstee
140
7k
How GitHub (no longer) Works
holman
314
140k
Bootstrapping a Software Product
garrettdimon
PRO
307
110k
Building an army of robots
kneath
306
45k
RailsConf & Balkan Ruby 2019: The Past, Present, and Future of Rails at GitHub
eileencodes
138
34k
Making Projects Easy
brettharned
117
6.3k
Easily Structure & Communicate Ideas using Wireframe
afnizarnur
194
16k
Principles of Awesome APIs and How to Build Them.
keavy
126
17k
Understanding Cognitive Biases in Performance Measurement
bluesmoon
29
1.8k
Fight the Zombie Pattern Library - RWD Summit 2016
marcelosomers
234
17k
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