Project 10: Documentation	

Oxford 1975:
============

The renewed discussion on documentation culminated in agreement to 
circulate examples of the documentation between members of the Group. 
Dr Ford agreed to be co-ordinator for this area and Professor Fosdick 
indicated interest in collaborating in this work.

---

Documentation was mentioned briefly again and from the interest aroused 
the Chairman proposed allocating further time to the subject later.

Amsterdam 1977:
===============

Dr Ford reported that he had collected some material and proposed to
work on it, but needed help.  Support from Argonne, Bell Laboratories,
Harwell, and Russia was promised.

Toronto 1978:
=============

Mr. Hague reported that Dr. Ford was continuing to collect and evaluate
examples of numerical software documentation. Further examples produced 
or located by group members would be welcome.

It was also reported that the Secretary had received for comment, a 
draft American National Standard for computer program abstracts from 
Ms Butler, the chairman of ANSI Technical Committee X3K7. Copies of 
this draft standard would be distributed with the WG 2.5 minutes and 
members were asked to convey their views to the Secretary.

Harwell 1980:
=============

Dekker summarized his views on readability and self-documentation of
programs. For a full account see his paper on "Design of languages for
numerical algorithms" in "Production and assessment of numerical
software", ed.  M.A. Hennell and L.M. Delves, Academic Press, 1980.

Ford reported that the documentation project is proceeding, aiming for
completion in 1982 and that NAG is rewriting its test programs
following the work reported in Baden.

Argonne 1986:
=============

Stetter briefly outlined the subgroup meeting held the evening before.
He said that it was not the intention of this project to provide
directions for the operational software documentation but to study the
problem through the collection of documentation on existing systems
and libraries. On the basis of that some general guideline and rules
might possibly be developed. Input from all members of the groups is
welcome. The project will continue.