開発ドキュメントの標準化

開発ドキュメントの標準化

ここでいう「標準化」とは、ツールや記載内容をルール化し、作業を定型化していくことである。標準化していくことで、誰が行っても同じよう なドキュメント作成をめざすのである。開発ドキュメントの重要性が増している昨今においては、この標準化の作業によって、開発生産性を高めるということ だ。

その1つの例として、Think ITではExcelで統一した開発ドキュメントの記事として「即活用！業務システムの開発ドキュメント標準化」 を紹介し、人気連載となっている。本記事ではExcelでドキュメントを統一し、標準のテンプレートを用意している。また、一部Excelでは難しいもの については、他のツールを用いている。この記事で紹介しているように、すべてを標準化するのではなく、極力標準化していくというアプローチが現場において 実践的なものといえよう。

これらの標準化には、ノウハウの集約化が必要となる。いままで見えなかった個人のノウハウを見える化することで、新たな発見や作業効率の向上が生まれることもあるだろう。またそのノウハウが集約されたものは企業資産としての価値が高いといえる。

開発ドキュメントを再利用する

さて、標準化を行っていくことで開発生産性があがる理由に、開発ドキュメントの再利用性という視点がある。

企業や個人にはさまざまなドキュメントが資産として残っている。読者の皆さんもこれまで業務にかかわるドキュメントを多く作成していること であろう。新たに何かドキュメントを作成するにあたっては、それらのドキュメントをベースとして、その状況にあわせてカスタマイズして再利用していること と思う。

標準化の恩恵の1つに、この再利用がある。ベースとなるドキュメントが整備されていれば、再利用にあたっても非常に効率的に進めることができる。ドキュメント作成にあたっては、内容こそ変化するものの、そこに記載する「項目」というのは大きく変化するものではない。

テンプレートがまさにその典型例であろう。テンプレートがあれば、意外と簡単にベースとなるドキュメントを作成できる。あくまでテンプレー トであるため、カスタマイズは必要となるが、ゼロから作成することを考えればその効率は比べるまでもない。このように標準化していくことで、作業効率を高 めることができるため、非常に重要なのである。