[Babase] Documentation editing, Susan's first pass

Karl O. Pinc babase@www.eco.princeton.edu
Thu, 19 May 2005 17:24:07 +0000


On 05/19/2005 09:00:43 AM, Susan Alberts wrote:

Anne,

I tried calling.  Give me a call sometime.  I want to talk
about line lengths, whether Susan might use bluefish or
something else, handy shortcuts, and suchlike stuff.

> I don't clearly understand how my changes will be
> incorporated with the chanages that Anne made yesterday, but I would  
> really like it if someone confirmed that that incorporation has  
> happened.  Anne, let me know if you can "see" my changes.

I'm not clear on how they will integrate either, as Anne has
probably changed every line in the file the tla program that
merges the changes might get confused and require manual
intervention.  Leah, please let me know how that goes.

> 
> One general overall remaining issue with the document is that the  
> organization and formatting is not yet complete -- for instance, the  
> sections are not all flagged in the table of contents and they don't  
> have outline letters and numbers. in many places in the document we  
> refer to "section VII.B" or whatever, so this needs to be fixed  
> eventually.

Anne and I can talk about this too.

> 
> Another general overall remaining issue is simply that a number of  
> tables are not yet described.
> 
> I've done three sets of things to it.
> 
> 1. Made some changes directly to the text. These were fixes of typos  
> or changes that Karl and I discussed.
> 2. Inserted a number of comments about things that need to be  
> attended to or suggestions for changes.
> 3. Added double asterisks (**) in a number of places where Karl needs  
> to look at it and see what changes need to be made. In some cases  
> I've just flagged a word (particularly FoxPro) that indicates a place  
> that needs to be updated to reflect our new system. In other cases  
> i've made notes to karl that involve questions for him to answer.

It all sounds good.

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