[Babase] Chapter 1 documentation comments

Karl O. Pinc kop at meme.com
Fri Feb 29 03:45:50 EST 2008


On 02/23/2008 04:24:27 PM, Susan Alberts wrote:

> Comment: The 3rd paragraph of This Document says "Any deviation from  
> the standards described in this document should be discussed with the  
> project director and may God have mercy on your souls." I am happy  
> with this except that it's not clear who of the three authors of this  
> document you are referring to as the director. Do you want to just  
> say "directors" and be equally ambiguous but more inclusive? Or do  
> you want to specify a contact person for reporting deviations from  
> the standards? I am OK with just adding an 's'.

's' added.

> 
> Comment: the 2nd paragraph of "Conventions used..." says "For  
> example, PCSColor. SOMETABLE.Somecolumn is shorthand for “the  
> Somecolumn column of the SOMETABLE table”, ..." It's not clear what  
> role the PCSColor is playing, and it confuses, can it be removed?

Clarified.  Fiddled with sentence order.

> Comment: the section on System Design indicates that you still need  
> to globally find and replace FoxPro with PostgreSQL: "The number of  
> FoxPro** program development tools used in the construction of the  
> software is kept to a minimum so that a new programmer need not spend  
> a lot of time learning the FoxPro** development environment. At the  
> present time, this means that the programs are limited to use of the  
> FoxPro** language and the screen builder, no queries, reports, etc.,  
> are used. All data are kept in FoxPro** databases."

This was leftover because this particular section was never redone
for Babase 2.0.  I've now redone it.

> 
> Comment: in "Other resources" I found a typo:tuitorials should be  
> tutorials.

Spellchecked everything.

Karl <kop at meme.com>
Free Software:  "You don't pay back, you pay forward."
                  -- Robert A. Heinlein



More information about the Babase mailing list