From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: **
X-Spam-Status: No, score=2.1 required=5.0 tests=BAYES_05,INVALID_DATE,
	MSGID_SHORT,REPLYTO_WITHOUT_TO_CC autolearn=no autolearn_force=no
	version=3.4.4
Path: utzoo!attcan!uunet!software.org!nettles
From: nettles@software.org (David Nettles)
Newsgroups: comp.lang.ada
Subject: Re: Rational ADA development environment
Message-ID: <438@software.software.org>
Date: 12 Feb 90 13:08:45 GMT
References: <405@wmt.UUCP> <595@ns-mx.uiowa.edu> <4722@rtech.rtech.com>
Sender: news@software.org
Reply-To: nettles@software.org (David Nettles)
Organization: Software Productivity Consortium, Herndon, Virginia
List-Id: <comp.lang.ada>

In article <4722@rtech.rtech.com> dennism@menace.UUCP (Dennis Moore) writes:
>ssawyers@cadfx.ccad.uiowa.edu (Steve Sawyers,212 ERF,,) writes:
>
>Isn't this typical for a government project?!?  40,000 LOC and 2,500 pages
>of documentation?  Are you serious?  40,000 lines of code is 667 pages (at
>60 lines per page).  That's almost 4 pages of documentation per line of
>code, even if your LOC counter doesn't count blank lines or comments as lines.
>
>If ADA is such a wonderful, self-documenting, easy to code, easy to understand,
>easy to maintain language (as the government claims it is), then why are 2,500
>pages of documentation necessary?
>
>-- Dennis Moore, my own opinions, blahblahblah

Nice cheap shot.

Though not familiar with the particular project, I have worked both sides of
a DoD project (military and civilian contractor).  Let me list some of the 
attending documents that are required as deliverables, regardless of
language used.

  System Specification
  System Design Document
  Software Requirements Specification
  Software Development Plan
  Interface Requirements Specification
  Software Test Plan
  Interface Design Document
  Software Design Document
  Software Test Descriptions
  Software Test Reports
  Operation and Support Documents
  Version Description Document

The government is going to get their pound of documentation regardless of 
how wonderful the language is.
--

David Nettles