WWESTの資料 技術文書のまとめとして３１文字にすることにより解決したい課題と利点を演習しながら体得する

1. 技術文書のまとめかた
技術士（情報工学）・博士（工学）
名古屋市工業研究所
小川清 @kaizen_nagoya

2. 技術文書の課題
! 膨大(数百頁から一万頁超）一日で読み切れない
! 難解 分野固有の用語・定義がある
! 複雑 複数の分野・立場にまたがると文脈依存で意味が違う
言葉が共存する
! 複数の言語 英語・日本語、C言語・アセンブラ
! 参考文献の入手性 技術書は絶版になりやすい

3. これまでの提案
! 略号のfull spell
! 定義した用語の一覧・用語定義の図の利用
! 参考文献の明記（特に定義を援用する文書）
! 用語の優先順位づけ
! 類語辞書の作成 用語の上下関係が分野・立場で違
うことを確認する
! 公開文書の参照 入手困難な文書を参照しても確認
が取れない
! オープンソースもこの一助

4. 未解決の課題
! 文書（ソースコードを含む）の見直し(review)の
時間・資源が半端ない
! 見直し(review)の際の手順・作業のばらつき
! 事前の本人による確認項目の多岐化
! いっぱい確認しないと回せない

5. 道具による検査
! ソースコードなら静的検査・動的検査
! 自然言語なら文法・単語の検査
! 機械翻訳ソフトにかける
! 言語検査の道具類

6. 今回の提案
! 文書の最後に短歌をつける
! 31文字の中に大事な用語を入れる
! 優先順位づけをしてあれば簡単にできる
! 優先順位づけする時間がなくても大事な言葉を二三個
いれるだけでその文書の特徴が分かる
! 論理は単純な論理しか記述できない
! 課題、解説、解決方法のいずれかを記載
! 利点
! 抄録とキーワードを同時に作ったことになるかも
! キーワード間の相互関係が少し分かる

7. 具体例
! TOPPERS/ssp/arch/arm_m_gcc/start.S
! http://researchmap.jp/jotxf95zi-1778110/#_1778110
! 作業報告
! M0とASPとも違いあり英語コメント作成中す
! 課題記録
! アセンブラフルスペルはコメントで記述しとくと
分かり易いと

8. 演習
! ファイル一つを選んで31文字にしてみよう
! 順に読み上げ、感想・意見をもらう
! 全部まとめて、SWESTでのポスタを出す

9. 他への展開
! 特許短歌
! 一つの特許ごとに抄録ではなく３１文字にまとめ
ておく
! 論文短歌
! 一つの論文ごとに抄録ではなく３１文字にまとめ
ておく
! 規格短歌
! 一つの規格ごとに抄録ではなく３１文字にまとめ
ておく

10. 注意事項
! アセンブラ短歌
! ３１命令語で実行できるプログラミング
! ブートアップの理解、マシン固有の課題の洗い出
しなどセキュリティ対策