Mailing-List: contact derby-user-help@db.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Derby Discussion" <derby-user@db.apache.org>
Received-SPF: neutral (asf.osuosl.org: 32.97.110.152 is neither permitted nor
 denied by domain of Stan.Bradbury@gmail.com)
Message-ID: <44232A00.6060402@gmail.com>
Date: Thu, 23 Mar 2006 15:06:40 -0800
From: Stanley Bradbury <Stan.Bradbury@gmail.com>
User-Agent: Mozilla Thunderbird 1.0.7 (Windows/20050923)
MIME-Version: 1.0
To: derby-user@db.apache.org
Subject: [WWD] Chap 3 and 4  submitted for review
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

I've submitted Chapters 1 and 2 of the Work With Derby [WWD] document 
for feedback.
The latest revision of Working With Derby has been posted to Jira.  It 
can be downloaded using:

http://issues.apache.org/jira/secure/attachment/12324531/WWDpdfNjava0323.zip

This contains the newly completed chapters 3 and 4.  Please focus first 
on the initial review of these chapters.  The PDF file and related JAVA 
code are contained in the file:  WWDpdfNjava0323.zip

The revisions of chapters 1 and 2 are also included.  This is their 
second review since restructuring the scope of the project and contain 
modifications based on information from the first review.  Please review 
and comment on these revisions as time allows.

Format Change Note:
Chapters 1 - 4 contain a structural change to the Basic Activity Format 
proposed.  Feedback received  (i.e. 'I keep jumping back and forth') 
indicated that the Basic Activity Format (Item 1 on the 'Feedback 
Requested' list) was not the best way to present this material.  The new 
format has  the descriptive text interspersed with the command and 
output examples.  The new activity format is step description followed 
by example then the next-step description followed by example, etc.

Some other changes that have been made besides correcting typOs and 
syntax errors:

A short section describing each activity was added to Ch 1.

The toursDB.sql script with the anticipated path has replaced 
'something.sql' as the script that is loaded in Activity 1.

References to 10.1 were updated to 10.2

The introduction is now warmer and more inviting.  If you can think of 
other eloquent words I might add, please let me know (I do not stand out 
when it comes to being eloquent).

The introduction of  shutdown=true was moved to Activity 3.

Responses to commands (aka output) is italicized to help differentiate 
user input from output in the examples - for long command sequences 
(e.g. running WwdEmbedded) the input is in bold.