[WWD] CH 3 and 4 Revision 1.1 review

[Stanley Bradbury <st...@gmail.com>]

I've attached the Review packet for the revision 1.1 of Ch 3 and 4 based on
the feedback received from the community.  To view the revisions download
the file Review-WWD-Ch3-4rv1.1.zip (
http://issues.apache.org/jira/secure/attachment/12325379/Review-WWD-Ch3-4rv1.1.zip
).  As
requested, more detail and code examples were added to Ch 4, section 2: :The
WwdEmbedded program" (original draft ~750 word - rv1.1 ~1325
words).  This section is not intended to teach JDBC and Java but rather
describe the basic steps to access data in a Derby database using the
embedded driver.  Please let me know if this is adequate to describe the
program to a beginning level programer that is not familair with JAVA or
JDBC.  If these drafts meet with general approval I hope to submit them for
checkin late this week.

Chapter 1 and 2 status.  The final revision of Chapters 1 and 2 of WWD were
submitted to checkin to SVN (commited to the document repostitory) on April
13 and were committed to the repository on April 14.  These chapters are now
included in Derby document checkouts and builds.
==== Comment from Ch 1 and 2 Final revision contribution ===
FOR SVN COMMIT: DIFF file of the Working With Derby document Ch 1 and 2 (the
Introduction and Activity 1)
  filename: FINAL_wwd_ch_1and2.diff

FOR Review / Validation: PDF file generated from the above DITA source
files.
   filename: FINAL_wwd_ch_1and2.pdf



==== Ch 3 and 4 rv 1.1 - JIRA issue information  ========
    [ http://issues.apache.org/jira/browse/DERBY-913?page=all ]

   Attachment: SRC-Review-Ch3-4rv1.1.zip
               Review-WWD-Ch3-4rv1.1.zip

Chapters 3 and 4 (Activites 2 and 3) - Revision based on review and feedback
of initial drafts March 23.  Significant rewrite to Chapter 4 (original
draft ~750 word - rv1.1 ~1325 words)

SRC-Review-Ch3-4rv1.1.zip - DITA files needed to build just chapters 3 and 4
with REVIEW title

Review-WWD-Ch3-4rv1.1.zip - PDF document and program files needed for the
activities

Please post comments to derby-user.

> [WWD] Proposal to create and add Working With Derby, an activity-based
tutorial document, to the Derby documentation set
>
------------------------------------------------------------------------------------------------------------------------
>
>          Key: DERBY-913
>          URL: http://issues.apache.org/jira/browse/DERBY-913
>      Project: Derby
>         Type: Improvement

>   Components: Documentation
>     Versions: 10.2.0.0
>     Reporter: Stan Bradbury
>     Assignee: Stan Bradbury
>  Attachments: FINAL_wwd_ch_1and2.diff, FINAL_wwd_ch_1and2.pdf,
Review-WWD-Ch3-4rv1.1.zip, SRC-Review-Ch3-4rv1.1.zip, WWDditaSrc0220.zip,
WWDditaSrc0222.zip, WWDditaSrc0323.zip, WWDhtml0220.zip, WWDpdfNjava0323.zip,
WorkingWithDerbyV1.1.html, WorkingWithDerbyV10.html,
workingwithderby0222.pdf, workingwithderby0306.pdf,
wwdDitaSrc0306_Ch1and2.zip
>
> I propose starting a new activity-based tutorial document for Derby.  The
proposed name is "Working With Derby" and I'd like to include it with the
next release.  The document would target new Derby users.  Information would
be presented that supports a series of activities designed to be performed
after installation.  These activities will guide beginners through the
basics of using Derby.  Attached is a proposal that further describes the
initial topics as I see them.  I would very much like feedback on all
aspects of this proposal from the Derby communities.  Please post all
feedback to the derby-user maillist, include Working With Derby (WWD for
short) in the subject line of all messages on this topic.

--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
  http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
  http://www.atlassian.com/software/jira