Bugzilla Version 2.16.7
Bugzilla Bug 1842
  extend JDO documentation by illustrations
     Query page      Enter new bug
Bug#: 1842   Platform:   Reporter: martin-fuchs at gmx dot net (Martin Fuchs)
Product:   OS:   Add CC:
Component:   Version:   CC:
Status: NEW   Priority:  
Resolution:   Severity:  
Assigned To: ferret at frii dot com (Bruce Snyder)   Target Milestone:  
URL:
Summary:

Attachment Type Modified Status Actions
patch for src/doc/jdo.xml patch 2005-01-07 04:33 none Edit
Create a New Attachment (proposed patch, testcase, etc.) View All

Bug 1842 depends on: Show dependency tree
Show dependency graph
Bug 1842 blocks:
Votes: 0    Show votes for this bug    Vote for this bug

Additional Comments:


Leave as NEW 
Accept bug (change status to ASSIGNED)
Resolve bug, changing resolution to
Resolve bug, mark it as duplicate of bug #
Reassign bug to
Reassign bug to owner of selected component

View Bug Activity   |   Format For Printing

Description: Opened: 2005-01-02 08:43

As a picture says more than thousand words, I made an approach for a 
illustration of the chapter "Using A JDO Database" of our current documentation 
at http://castor.exolab.org/jdo.html:

http://www.sky.franken.de/castor/transactions-en.html

There is available an english and a germ an version of the text.
It shows what happens and which functions are used when creating, querying, 
updating and deleting objects using JDO.

How can we include the pictures into the XML-formated documentation?

------- Additional Comment #1 From Werner Guttmann 2005-01-06 12:25 -------
> How can we include the pictures into the XML-formated documentation?
Either you add a new template for e.g. <pictures> to exolab.xsl, or you simply
include an image element in the source file.

------- Additional Comment #2 From Werner Guttmann 2005-01-06 12:26 -------
Martin, great stuff in general. This should make things a lot easier for our
users to grasp the main concepts. Having said that, I honestly think that the
images can (and should) be made easier to follow. It's very difficult to explain
why, so let's talk off-line.

------- Additional Comment #3 From Martin Fuchs 2005-01-07 04:33 -------
Created an attachment (id=844)
patch for src/doc/jdo.xml

This is a first draft of the docu extension. (just copied from my web page)
It doesn't include the pictures itself, only <img src="..."/> references.
Any concrete ideas how to make them easier to follow?

     Query page      Enter new bug
This is Bugzilla: the Mozilla bug system. For more information about what Bugzilla is and what it can do, see bugzilla.org.
Actions: New | Query | bug # | Reports   New Account | Log In