dita — archive

Groups - DITA 2.0 Stage 2 proposal for issue #29 (HTML) uploaded

From: Eliot Kimber <[email protected]>
To: [email protected]
Date: Tue, 27 Feb 2018 19:53:00 -0000

I agree completely with Robert. Cheers, E. -- Eliot Kimber http://contrext.com From: <[email protected]> on behalf of Robert D Anderson <[email protected]> Date: Tuesday, February 27, 2018 at 1:38 PM To: Scott Hudson <[email protected]> Cc: "[email protected]" <[email protected]> Subject: Re: [dita] RE: Issue #29: Bookmap modifications -- Attn reviewers Amber Swope and Robert Anderson 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 DITA-OT lead and Co-editor DITA 1.3 specification , Digital Services Group E-mail: [email protected] 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 is From: Scott Hudson <[email protected]> To: "Éric Sirois" <[email protected]>, Amber Swope <[email protected]>, Kristen James Eberlein <[email protected]>, "[email protected]" <[email protected]> Cc: Robert Anderson <[email protected]> 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 <[email protected]> Date: Tuesday, February 27, 2018 at 10:19 AM To: Éric Sirois <[email protected]>, Scott Hudson <[email protected]>, Amber Swope <[email protected]>, Kristen James Eberlein <[email protected]>, "[email protected]" <[email protected]> Cc: Robert Anderson <[email protected]> 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 [email protected] / www.ixiasoft.com From: [email protected] [ mailto:[email protected] ] On Behalf Of Éric Sirois Sent: February 27, 2018 11:07 AM To: Scott Hudson <[email protected]>; Amber Swope <[email protected]>; Kristen James Eberlein <[email protected]>; [email protected] Cc: Robert Anderson <[email protected]> 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 [email protected] / www.ixiasoft.com From: Scott Hudson [ mailto:[email protected] ] Sent: February 27, 2018 10:40 AM To: Éric Sirois < [email protected] >; Amber Swope < [email protected] >; Kristen James Eberlein < [email protected] >; [email protected] Cc: Robert Anderson < [email protected] > 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: < [email protected] > on behalf of Éric Sirois < [email protected] > Date: Tuesday, February 27, 2018 at 8:23 AM To: Amber Swope < [email protected] >, Kristen James Eberlein < [email protected] >, " [email protected] " < [email protected] > Cc: Robert Anderson < [email protected] > 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 [email protected] / www.ixiasoft.com From: [email protected] [ mailto:[email protected] ] On Behalf Of Amber Swope Sent: February 26, 2018 10:14 PM To: Kristen James Eberlein < [email protected] >; [email protected] Cc: Robert Anderson < [email protected] > 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> <booktitle> <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: [email protected] ] Sent: Monday, February 26, 2018 2:33 PM To: [email protected] 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 Document Name : DITA 2.0 Stage 2 proposal for issue #29 (HTML) No description provided. Download Latest Revision Public Download Link Submitter : Mr. Eric Sirois 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