super-structure / com.bentley.dita.v1_3

DITA-OT plugin containing Bentley Systems' topic shells, specializations, and customizations of DITA v1.3.
MIT License
1 stars 0 forks source link

Add 'bentley-' prefix to shell filenames #9

Closed super-structure closed 7 months ago

super-structure commented 7 months ago

The DITA 1.3 language specification "B.3 File naming conventions" states that:

Document type shells should be given a name that distinguishes their name, owner, or purpose; for example, acme-concept.dtd. The document type shells that are provided by the DITA Technical Committee use the root element of the primary specialization as the basis for the file name.

The draft DITA 2.0 language specification "Coding practices for DITA grammar files" also states that:

Document-type shells should be given a name that distinguishes their name, owner, or purpose, for example, acme-concept.dtd. The document-type shells that are provided by the DITA Technical Committee typically use the root element of the primary specialization as the basis for the file name. If necessary, a qualifier such as base is prepended to the name of the root element.

So the original approach was correct and this should be reverted for clarity.

super-structure commented 7 months ago

Updated in v1.1.0.