db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Kim Haase (JIRA)" <j...@apache.org>
Subject [jira] Updated: (DERBY-2391) "Derby and standards" section of Developer's Guide needs reorganization
Date Mon, 05 Mar 2007 19:09:50 GMT

     [ https://issues.apache.org/jira/browse/DERBY-2391?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel

Kim Haase updated DERBY-2391:

    Attachment: DERBY-2391.zip

Here's a patch (DERBY-2391.diff, DERBY-2391.zip) that moves the content of those 12 files
into cdevstandards806118.dita; fixes a cross-reference to cdevstandards806118.dita in cdevstandardsxml.dita;
and removes the references to the deleted files from the map file (including the reltable).
Is the lack of vertical spacing in the definition list appropriate? I can put paragraph tags
in the <dd> text to create vertical space if that would be preferable.

I did a cvs rm for the deleted files.

> "Derby and standards" section of Developer's Guide needs reorganization
> -----------------------------------------------------------------------
>                 Key: DERBY-2391
>                 URL: https://issues.apache.org/jira/browse/DERBY-2391
>             Project: Derby
>          Issue Type: Bug
>          Components: Documentation
>            Reporter: Kim Haase
>         Assigned To: Kim Haase
>            Priority: Minor
>         Attachments: DERBY-2391.diff, DERBY-2391.zip
> The "Derby and standards" section of the Dev Guide (http://db.apache.org/derby/docs/dev/devguide/)
currently consists of 14 files: a parent file, cdevstandards806118.dita, and 13 subordinate
files. The current parent-child organization of these files in the map file means that in
the HTML Pages version of the manual, the complete text of all but one of the subordinate
files appears in a bullet list in the parent file. None but the last of the subtopics is actually
long enough to merit its own topic, nor do any but the last stand on their own logically.
> Only the last file (the topic titled "XML data types and operators") is long enough to
merit its own topic. The text of the others should be added to "Derby and standards", probably
in a definition list, and the 12 files should be removed.
> The "Derby and standards" file is cdevstandards806118.dita. The files to be removed are

> cdevstandards805644.dita
> cdevstandards805664.dita
> cdevstandards805690.dita
> cdevstandards805716.dita
> cdevstandards805742.dita
> cdevstandards805768.dita
> cdevstandards805841.dita
> cdevstandards805893.dita
> cdevstandards805949.dita
> cdevstandards805975.dita
> cdevstandards806001.dita
> cdevstandards806027.dita

This message is automatically generated by JIRA.
You can reply to this email to add a comment to the issue online.

View raw message