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] [Created] (DERBY-6379) Manuals are inconsistent in their use of the <shortdesc> element
Date Tue, 15 Oct 2013 20:35:41 GMT
Kim Haase created DERBY-6379:

             Summary: Manuals are inconsistent in their use of the <shortdesc> element
                 Key: DERBY-6379
                 URL: https://issues.apache.org/jira/browse/DERBY-6379
             Project: Derby
          Issue Type: Improvement
          Components: Documentation
    Affects Versions:
            Reporter: Kim Haase
            Priority: Minor

When topics are organized as subtopics of other topics, our tools generate a list of the subtopics
at the end of the parent topic. If the DITA source of the subtopic begins with a <shortdesc>
element, the contents of the <shortdesc> appear under the subtopic title in the parent
topic. These contents also form the first paragraph of the subtopic. It does not seem to be
possible to suppress the list of subtopics; they appear in the HTML output, but not in the

Generally, the documentation is not consistent in its use of the <shortdesc> element.

I'll add more detail in a comment.

This message was sent by Atlassian JIRA

View raw message