← Prev in month ← Prev in thread
Next in thread → Next in month →

Terminology for DITA TC to use regarding conformance

From
Kristen James Eberlein <>
Date
2019-03-26T18:38:52+00:00
ID
Thread
Terminology for DITA TC to use regarding conformance
Conformance clause

        "A statement in the Conformance section of a
        specification that that defines precisely how an implementation
        can conform to a specification and references one or more
        portions of normative content, directly or indirectly, and may
        refer to other conformance clauses." Guidelines to Writing
          Conformance Clauses for OASIS Specifications

    

    
Conformance section

      The topic (or topic collection) that contains conformance clauses.
      The conformance clauses must be numbered. Note: In DITA
      1.3 we hacked this by manually numbering section titles. For DITA
      2.0, these should perhaps be separate topics.

      DITA 1.3 example: http://docs.oasis-open.org/dita/dita/v1.3/errata02/os/complete/part1-base/conformance/conformance.html#conformance

    
Conformance target

      "An implementation
        which is the subject of at least one conformance clause." Guidelines
            to Writing Conformance Clauses for OASIS Specifications

          DITA 1.3 examples: DITA implementations, DITA documents,
        and DITA processors

    
Normative
            statements

        Statements that use RFC-2119 terminology.

        DITA 1.3 example: "Â A DITA document MUST have as its
        root element one of the following elements: <map> or a
        specialization of the <map> element <topic> or a
        specialization of the <topic> element <dita>, which
        cannot be specialized, but which allows documents with multiple
        sibling topics."

      

    
Best,

      Kris

      

      Kristen James Eberlein

      Chair, OASIS DITA Technical Committee

      Principal consultant, Eberlein Consulting

      www.eberleinconsulting.com

      +1 919 622-1501; kriseberlein (skype)

      

    

    
On 3/26/2019 10:07 AM, Kristen James
      Eberlein wrote:

    

    http://docs.oasis-open.org/templates/TCHandbook/ConformanceGuidelines.html
      

      

      This is the link to "Guidelines to Writing Conformance Clauses for
      OASIS Specifications," last updated April 2017.
      

      

      Please take a look!
← Prev in month ← Prev in thread
Next in thread → Next in month →