Re: [dita] Fwd: Comments about <subjectHead> and <subjectHeadMeta>

[Kristen James Eberlein <kris@eberleinconsulting.com>]

That's a easy fix.

I'm most interested, however, in whether folks think that subjectHead and subjectHeadMeta is adequately covered. Many reviewers stumbled over the content for these elements, perhaps because they were assuming that they provided documentation for an enumeration.

In contrast, I think Erik Hennum intended that these elements serve the following purposes:

• Group a set of subjects with a label and short description that was intended to be rendered (as opposed to <navtitle> and <shortdesc> inside of <topicmeta>, which was intended to strictly provide metadata)
• Perhaps publish some form of artifact to enable faceted browsing
• Publish a taxonomy reference for authors charged with classifying content

We potentially could remove these elements, but I think they probably serve a valid purpose, although the design is not what I would have advocated.

Thoughts? These are the ONLY outstanding comments in the subjectScheme review.

PDF attached, and I have updated the <subjectHead> example to use the same taxonomy as in the <subjectdef> topic.

Best,
Kris

On 1/25/2022 10:56 AM, Nancy Harrison wrote:

In your 'hobbies'Â subjectdef, the initial entry for 'woodworking' is too far indented; it should be level with 'fiber-arts'

Nancy

_____________
Nancy Harrison
Infobridge SolutionsÂ
nharrison@infobridge-solutions.com

On Tue, Jan 25, 2022 at 6:03 AM Kristen James Eberlein <kris@eberleinconsulting.com> wrote:

Best,
Kris

-------- Forwarded Message --------

Subject:	Comments about <subjectHead> and <subjectHeadMeta>
Date:	Tue, 18 Jan 2022 12:34:13 -0500
From:	Kristen James Eberlein <kris@eberleinconsulting.com>
To:	Robert Anderson <robert.dan.anderson@oracle.com>, Zoe Lawson <zoelawson17@hotmail.com>, Stevens, Dawn <dawn.stevens@comtech-serv.com>, Wegmann, Frank <Frank.Wegmann@softwareag.com>

The attached PDF has updated topics about the <subjectHead> and <subjectHeadMeta> elements. This is the best that I can do; let me know whether it is enough.

-- 
Best,
Kris

---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail. Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php

Attachment: subjectHead-subjectHeadMeta.pdf
Description: Adobe PDF document