Path: utzoo!mnetor!tmsoft!torsqnt!news-server.csri.toronto.edu!cs.utexas.edu!samsung!munnari.oz.au!ariel!sue
From: sue@ariel.ucs.unimelb.edu.au (Sue McPherson)
Newsgroups: comp.databases
Subject: INGRES manuals
Message-ID: <366@ariel.ucs.unimelb.edu.au>
Date: 19 Dec 90 01:36:21 GMT
Organization: Software Contracts Group, University of Melbourne, Australia
Lines: 24

Two of the programmers in my group have been develping applications using
INGRES (release 6) in a Unix environment.

They have both complained (quite forcefully) about the manuals provided
with INGRES, in particular;
- difficulty finding information
- lack of cross-referencing within documentation
- incorrect details, ie. instructions for passing a parameter to a report
  show the use of quotes, after much trial and error it turns out a
  different combination of quotes are required.

They seem to spend a considerable amount of time 'browsing' through the 
manuals looking for information and quite often find it by chance or when
they are looking for something else.

I have two questions;

1) Does everyone have the same problem with the manuals?

2) Is there a good "Developers' Guide" written by any third party?

Thanks,

Sue McPherson