OASIS Darwin Information Typing Architecture (DITA) TC

 View Only
Back to discussions
Expand all | Collapse all

2.0 Spec Feedback: Branch Filtering and

  • 1.  2.0 Spec Feedback: Branch Filtering and

    Posted 04-15-2025 11:35
    Sorry that this is late . . . 

    I reviewed the Branch Filtering Architecture section and <ditavalref>
    Reference section.

    I recommend moving them into a more detailed review. In general, the
    writing and examples here are some of the best in the 2.0 spec.

    Beyond a handful of line edits . . . only two questions/issues for the TC.

    1. Placement of 7.5.5 Branch Filter: Impact on resource and key names
      This is a long and somewhat esoteric section. The content is great and
      relevant, but I do wonder whether it might improve flow and readability
      to move it after the processing section. Just thinking.

    2. Under 7.5.5.1 "metadata," a Note mentions, "In general. the best wayt o reference a topic to be modified based on branch filtering is to use a key, rather than a URI. Key scopes . . . "

      A little more description and an in-line example might be nice here.
    <ditavalref> Reference: No issues on this end . . .
    Stan


Related Content