Comments on context hooks in DITA 1.3 spec

[Richard Forster <Richard.Forster@varian.com>]

http://docs.oasis-open.org/dita/dita/v1.3/csprd01/part2-tech-content/archSpec/base/help-systems-and-other-user-assistance.html#help-systems-and-other-user-assistance

 

Comment 1:

In the third paragraph, the following are superfluous and should be deleted:

-          The first occurrence of the sentence “Context hooks can be direct links to URIs, but more they are indirect links (numeric context identifiers and context strings) that can be processed into external resource files.” It is repeated immediately afterwards with a minor correction.

-          The word “tream” in the last sentence of the paragraph (“other downstream tream applications.”)

 

Comment 2:

In the list of attributes, the @appname is missing

 

 

----------------

 

http://docs.oasis-open.org/dita/dita/v1.3/csprd01/part2-tech-content/langRef/base/resourceid.html#resourceid

 

Comment 3:

The second paragraph says “each combination of values for the @appid and @appname attributes should be unique.” – Can the scope of uniqueness be specified? (e.g. “…should be unique in a publication.”)

 

Comment 4:

The examples all use the @id attribute (in addition to @appid). Suggest to remove @id attribute from all examples in this topic as the @id attribute is deprecated and having two IDs in the example is confusing.

 

 

 

 

 

Richard Forster

Information Architect, Global Publication Support Services

Varian Medical Systems Imaging Lab GmbH

Täfernstrasse 7

CH-5405 Baden-Dättwil