XMLWordPrintable

    Details

    • Type: Bug
    • Status: New
    • Priority: Minor
    • Resolution: Unresolved
    • Affects Version/s: Darwin Information Typing Architecture (DITA) Version 1.3 CSPRD01
    • Fix Version/s: None
    • Component/s: Public reviews
    • Labels:
      None
    • Environment:

      Style

    • Proposal:
      Hide

      Correct hanging paragraphs as part of improving sectioning and headers with section numbers for examples.

      Show
      Correct hanging paragraphs as part of improving sectioning and headers with section numbers for examples.

      Description

      Section 2.2 DITA markup is followed by a hanging paragraph.

      That is if I say see Section 2.2 DITA markup, do I mean only the following two paragraphs or do I mean all of Section 2.2, including all of its subsections?

      For clarity of reference 2.2 DITA markup should be followed by:

      2.2.1 Introduction
      (your current two paragraphs)
      2.2.2 DITA topics
      2.2.1.1 Introduction to DITA topics
      2.2.1.2 The topic as the basic unit of information

      Reasoning that if you accept the comment on consistent subsectioning and giving examples section headings, elimination of hanging paragraphs fits nicely with those tasks and makes the document more consistent in appearance. Not to mention easier to reference.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              patrick Patrick Durusau
            • Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated: