I'm nervous about picking and choosing specific domain elements that can appear inside of this new "map resources" container.
For the most part, having a model like (keydef | mapref | topicsubject) is legal, it just seems to really over-complicate things. That is ... if the map resources container element explicitly allows <topicsubject> but not <topicref>, then **no use of the mapresources domain can every be valid without the classification domain.** That's wrong -- a generic map resources domain definitely should not depend on the classification domain.
If the map resources domain is going to allow (at a minimum) keydef and mapref, AND if we want to be flexible enough for others to add in their own resources, then I think this element probably just has to allow (topicref*) in the content model. That way, if you add the classification domain, it will show up there; if you don't want the classification domain, it doesn't. Bookmap already has (and will probably always have) the map group domain, meaning you'll automatically get keydef and mapref. The OASIS distribution might want to add in a constraint to take some things out, but that's optional - and either way we'll still have to address what happens if you put other content in there.
Once topicref is allowed, whether or not we add the classification domain into bookmap becomes an entirely different proposal. That is ... what we've discussed so far is impossible today (adding ditavalref to the bookmap, adding keydefs without resorting to weird hacks). But anybody can add the classification domain to their bookmap shell today. Neither change depends on the other, and (to me at least) they don't really seem related. Handling these as different proposals, with unrelated use cases / costs / benefits, seems like the right way to go.
Or ... maybe I'm just not understanding Eric's question about adding the classification domain.
| Regards, Robert D. Anderson |  |
| E-mail: robander@us.ibm.com Digital Services Group |  |
| 11501 BURNET RD,, TX, 78758-3400, AUSTIN, USA | |
Scott Hudson ---02/27/2018 11:27:40 AM---Yes, I would. It is similar to subjectScheme in that it is not directly rendered in the book, but isFrom: Scott Hudson <scott.hudson@jeppesen.com>
To: "Éric Sirois" <eric.sirois@ixiasoft.com>, Amber Swope <amber@ditastrategies.com>, Kristen James Eberlein <kris@eberleinconsulting.com>, "dita@lists.oasis-open.org" <dita@lists.oasis-open.org>
Cc: Robert Anderson <robander@us.ibm.com>
Date: 02/27/2018 11:27 AM
Subject: Re: [dita] RE: Issue #29: Bookmap modifications -- Attn reviewers Amber Swope and Robert Anderson
Yes, I would. It is similar to subjectScheme in that it is not directly rendered in the book, but is an important resource.
--Scott
- From: Éric Sirois <eric.sirois@ixiasoft.com>
Date: Tuesday, February 27, 2018 at 10:19 AM
To: Éric Sirois <eric.sirois@ixiasoft.com>, Scott Hudson <scott.hudson@jeppesen.com>, Amber Swope <amber@ditastrategies.com>, Kristen James Eberlein <kris@eberleinconsulting.com>, "dita@lists.oasis-open.org" <dita@lists.oasis-open.org>
Cc: Robert Anderson <robander@us.ibm.com>
Subject: RE: [dita] RE: Issue #29: Bookmap modifications -- Attn reviewers Amber Swope and Robert Anderson
A quick question. So adding mapref and subjectScheme to mapresources, does it make sense to add the classifyDomain (topicsubject?) to the mix as well?
Éric Sirois
DITA Toolsmith
IXIASOFT
825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1
tel + 1 514 279-4942 / toll free + 1 877 279-4942
mobile + 1 647 462-3620
eric.sirois@ixiasoft.com / www.ixiasoft.com
From: dita@lists.oasis-open.org [mailto:dita@lists.oasis-open.org] On Behalf Of Éric Sirois
Sent: February 27, 2018 11:07 AM
To: Scott Hudson <scott.hudson@jeppesen.com>; Amber Swope <amber@ditastrategies.com>; Kristen James Eberlein <kris@eberleinconsulting.com>; dita@lists.oasis-open.org
Cc: Robert Anderson <robander@us.ibm.com>
Subject: RE: [dita] RE: Issue #29: Bookmap modifications -- Attn reviewers Amber Swope and Robert Anderson
| This sender failed our fraud detection checks and may not be who they appear to be. Learn about spoofing | Feedback |
- I have no issue with the name change.
Éric Sirois
DITA Toolsmith
IXIASOFT
825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1
tel + 1 514 279-4942 / toll free + 1 877 279-4942
mobile + 1 647 462-3620
eric.sirois@ixiasoft.com / www.ixiasoft.com
From: Scott Hudson [mailto:scott.hudson@jeppesen.com]
Sent: February 27, 2018 10:40 AM
To: Éric Sirois <eric.sirois@ixiasoft.com>; Amber Swope <amber@ditastrategies.com>; Kristen James Eberlein <kris@eberleinconsulting.com>; dita@lists.oasis-open.org
Cc: Robert Anderson <robander@us.ibm.com>
Subject: Re: [dita] RE: Issue #29: Bookmap modifications -- Attn reviewers Amber Swope and Robert Anderson
What about generalizing the element name: resources ?
Thanks and best regards,
--Scott
- From: <dita@lists.oasis-open.org> on behalf of Éric Sirois <eric.sirois@ixiasoft.com>
Date: Tuesday, February 27, 2018 at 8:23 AM
To: Amber Swope <amber@ditastrategies.com>, Kristen James Eberlein <kris@eberleinconsulting.com>, "dita@lists.oasis-open.org" <dita@lists.oasis-open.org>
Cc: Robert Anderson <robander@us.ibm.com>
Subject: RE: [dita] RE: Issue #29: Bookmap modifications -- Attn reviewers Amber Swope and Robert Anderson
Hi Amber,
The bookmapresources is simply an anchor point to allow other specializations to hook into that spot. The way the shell is setup you will never see bookmapresources in a drop down menu in an XML editor. It’s there for specializers. The markup below is correct.
Bookmapresources is based on topicref
<!-- LONG NAME: Bookmap Specialization Placeholder -->
<!ENTITY % bookmapresources.content
"((%topicmeta;)?,
(%anchor; |
%data.elements.incl; |
%navref; |
%topicref;)*)"
>
<!ENTITY % bookmapresources.attributes
"href
CDATA
#IMPLIED
keyref
CDATA
#IMPLIED
keys
CDATA
#IMPLIED
query
CDATA
#IMPLIED
copy-to
CDATA
#IMPLIED
outputclass
CDATA
#IMPLIED
%topicref-atts;
%univ-atts;"
>
Bookmap.dtd shell: Usually you whould see “bookmapresources | %bookmapkeydefs-d-bookmapresources;”, but we omitted the first part so it’s not available.
<!ENTITY % bookmapresources "%bookmapkeydefs-d-bookmapresources;
">
Éric Sirois
DITA Toolsmith
IXIASOFT
825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1
tel + 1 514 279-4942 / toll free + 1 877 279-4942
mobile + 1 647 462-3620
eric.sirois@ixiasoft.com / www.ixiasoft.com
From: dita@lists.oasis-open.org [mailto:dita@lists.oasis-open.org] On Behalf Of Amber Swope
Sent: February 26, 2018 10:14 PM
To: Kristen James Eberlein <kris@eberleinconsulting.com>; dita@lists.oasis-open.org
Cc: Robert Anderson <robander@us.ibm.com>
Subject: [dita] RE: Issue #29: Bookmap modifications -- Attn reviewers Amber Swope and Robert Anderson
My apologies for the late response.
I have reviewed the proposal and have the following comments/questions:
- 1. Does the proposed <bookmapresources> element only allow specializations of <topicref> or also include <topicref> elements?
2. Is the sample markup correct? Or should <bookmapkeydefs> be replaced with <bookmapresources>?
<bookmap>
<mainbooktitle>Test</mainbooktitle>
</booktitle>
<bookmapkeydefs>
<keydef keys="test" href="">
</bookmapkeydefs>
<ditavalref href="">
</bookmap>
- 3. Also, can we include sample usage of the proposed <bookmakers> element?
Thanks, Amber
PS – I will be unable to attend tomorrow’s meeting.
From: Kristen James Eberlein [mailto:kris@eberleinconsulting.com]
Sent: Monday, February 26, 2018 2:33 PM
To: dita@lists.oasis-open.org
Cc: Robert Anderson; Amber Swope
Subject: Issue #29: Bookmap modifications -- Attn reviewers Amber Swope and Robert Anderson
Have you reviewed the stage two proposal for #29? Is it ready for TC discussion tomorrow?
Best,
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)
On 2/26/2018 12:30 PM, Kristen James Eberlein wrote:
- Eric, has your stage two proposal been reviewed by the assigned reviewer for stage two completeness?
Best,
Kris
Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)
On 2/26/2018 11:45 AM, Eric Sirois wrote:
- Submitter's message
HTML Version of Issue 29 Stage 2 proposal, bookmap update
-- Mr. Eric Sirois
Download Latest Revision Public Download Link Group: OASIS Darwin Information Typing Architecture (DITA) TC Folder: DITA Specification 2.0 Ideas and Proposals Date submitted: 2018-02-26 08:45:08 |
--------------------------------------------------------------------- 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