文書診断法の診断観点と診断水準におけるコーディング規約の分析

概要

論文の詳細を見る
我々は,ソフトウェア開発プロセスの各作業工程で出力される開発文書を中間成果物として捉えており,その開発文書の品質を計測するための研究を行っている.開発文書を評価するために,記述の明晰さと,開発に十分な緻密さと,技術内容の適切さに分ける「診断観点」を定義した.次に,文書で指摘した問題点が表記上の問題であるか,意味上の問題であるかの違いで分ける「診断水準」を定義した.これらの定義に従って,文書を精読して問題のある記述を「診断種別」ごとに分けられた「診断項目」に分類する文書診断法を提案した.本稿では,文書診断法の指標を用いてコーディング規約の基本概念として与えられたコーディングの「作法」を分析するために,「作法」を構成する「作法詳細」を「診断観点」と「診断水準」に対応づけた.結果として,コーディングの「作法」には,プログラムを作業工程における中間成果物の開発文書として評価するための性質があることを見出した.その結果を踏まえ,要求仕様書や設計書などの開発文書に加えて,プログラムを含むすべての中間成果物を評価する指標として「診断観点」と「診断水準」を提案する.
2011-03-11