[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [dita] Sound bite for the OASIS press release
"Semantic granularity" ... <Hangs head in shame/> Yes, my academic roots are showing. How can we communicate the same concept in a more accessible way? Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) On 1/16/2016 2:03 PM, Richard Hamilton wrote:
Hi Eliot, I see your point on compliance vs. conformance. Makes sense to me. I'm not wedded to my words in the rest of that paragraph. My only concern with Kris's wording was the use of the term "semantic granularity," Seems like it's an awfully academic term for a press release. Best regards, Dick ------- XML Press XML for Technical Communicators http://xmlpress.net hamilton@xmlpress.net On Jan 16, 2016, at 6:03, Eliot Kimber <ekimber@contrext.com> wrote:I like the first sentence--I think that captures the essence of specialization pretty well. I'm not as happy with the rest of the paragraph--I think Kris' is better with respect to reuse and interoperability. Also, "compliant" is the wrong term. One complies with laws and regulations, one conforms to standards. So the the correct term would be "conformant with" or "conforming to ". Cheers, E. ---- Eliot Kimber, Owner Contrext, LLC http://contrext.com On 1/15/16, 8:20 PM, "Richard Hamilton" <hamilton@xmlpress.net> wrote:The copy editor in me says, please don't say "most unique":-). How about the following? "DITA is unique among XML grammars because it supports specialization," ... Also, what is "semantic granularity"? I think that will go right past the likely audience for this release (it went right past me:-). How about saying something like the following? "DITA specialization enables practitioners to create new elements from existing elements, making it possible to support an organization's unique information structure, enable more precise semantic search, and provide better guidance for authors. Content created using a DITA specialization remains compliant with the DITA standard, and output processors can understand and process that content. In addition, such content can be easily shared between organizations, increasing interoperability." Best regards, Dick ------- XML Press XML for Technical Communicators http://xmlpress.net hamilton@xmlpress.net On Jan 15, 2016, at 12:38, Tom Magliery <tom.magliery@justsystems.com> wrote:I see that re-use is already mentioned in the rest of the press release. Here's a suggested rework of your paragraphs below. ³The most unique feature of the DITA standard is specialization,² said Kristen Eberlein, chair of the OASIS DITA Technical Committee. ³DITA enables practitioners to create new elements from existing ones in order to increase the semantic granularity. For example, a section element can be specialized to represent more specific types of sections such as ³Introduction,² ³Main point,² and ³Conclusion²; this enables more precise semantic searching and better guidance for authors.² ³Done correctly², Eberlein continued, ³Output processors always will understand the specialization hierarchy a section is always a section, after all and be able to apply general processing transformations. Together the re-use and interoperation possibilities of DITA allow great cost sharing and cost reductions.² From: Kristen James Eberlein [mailto:kris@eberleinconsulting.com] Sent: Friday, January 15, 2016 11:39 AM To: Tom Magliery; Eliot Kimber; dita@lists.oasis-open.org Subject: Re: [dita] Sound bite for the OASIS press release The press release needs to go to Carol by next Tuesday. It also will include quotations from sponsor companies, such as IXIASOFT, Comtech, etc. It probably should not be longer than two paragraphs. Tom, I'll send you the draft press release off-list; it's currently marked OASIS Confidential. Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) On 1/15/2016 2:31 PM, Tom Magliery wrote: In fact I would say that interoperability is far more germane to the topic of specialization being emphasized here. If reuse is also important to highlight in this blurb, I think there needs to be some verbiage that calls attention to the topic-based architecture and the conref/keyref capabilities. This is perhaps less "unique" to DITA and I don't know the overall gist of the PR, so I don't know if you want that or not. mag From: dita@lists.oasis-open.org [mailto:dita@lists.oasis-open.org] On Behalf Of Eliot Kimber Sent: Friday, January 15, 2016 9:35 AM To: Kristen James Eberlein; dita@lists.oasis-open.org Subject: Re: [dita] Sound bite for the OASIS press release I would add "and interoperation" to "the ensuing reuse possibilities": "the ensuing reuse and interoperation possibilities" Interoperation, with or without reuse, is an important and distinguishing feature of the DITA architecture. Cheers, E. ---- Eliot Kimber, Owner Contrext, LLC http://contrext.com From: dita <dita@lists.oasis-open.org> on behalf of Kristen James Eberlein <kris@eberleinconsulting.com> Date: Friday, January 15, 2016 at 11:17 AM To: dita <dita@lists.oasis-open.org> Subject: Re: [dita] Sound bite for the OASIS press release How about the following: ³DITA is more than flexible, it¹s specializable,² said Kristen Eberlein, chair of the OASIS DITA Technical Committee. ³The standard is unique; it enables practitioners to specialize from existing elements in order to increase the semantic granularity. For example, consider a very simple document. A section element can be specialized to represent more specific types of sections such as ³Introduction,² ³Main point,² and ³Conclusion²; this enables more precise semantic searching and better guidance for authors.² ³Done correctly², Eberlein continued, ³Output processors always will understand the specialization hierarchy a section is always a section, after all and be able to apply general processing transformations. This is unique to DITA, and the ensuing reuse possibilities allow great cost sharing and cost reductions.² Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) On 1/14/2016 1:15 PM, Kristen James Eberlein wrote: Carol Geyer has sent me a draft press release. It includes the following paragraph: ³DITA is more than flexible, it¹s specializable,² said Kristen Eberlein, chair of the OASIS DITA Technical Committee. ³The standard allows specific semantics to be introduced for specific purposes without increasing the size of other XML grammar files.² <PLEASE EDIT LIBERALLY> I think we can improve this. Thoughts? -- Best, Kris Kristen James Eberlein Chair, OASIS DITA Technical Committee Principal consultant, Eberlein Consulting www.eberleinconsulting.com +1 919 682-2290; kriseberlein (skype) --------------------------------------------------------------------- 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 --------------------------------------------------------------------- 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--------------------------------------------------------------------- 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
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]