[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [dita] Sound bite for the OASIS press release
Never be ashamed of being an academic. We need all the academics we can get. That said, I still haven't found a definition for semantic granularity, so I'm afraid I can't help you communicate the concept:-). A google search turns up academic articles and books but no plain definition (at least on the first page or two), and wikipedia doesn't have the term, nor does a search find it in any other place on wikipedia. I think there's an opportunity for some academically inclined person (hint, hint) to create a new wikipedia topic:-). But, more seriously, is the concept important to the audience for a press release for DITA? I think there are plenty of more important, and accessible, points you can make (and have made already). Best regards, Dick ------- XML Press XML for Technical Communicators http://xmlpress.net hamilton@xmlpress.net On Jan 16, 2016, at 11:26, Kristen James Eberlein <kris@eberleinconsulting.com> wrote: > "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 >> >> >> > > > --------------------------------------------------------------------- > 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]