OASIS Darwin Information Typing Architecture (DITA) TC

 View Only
Expand all | Collapse all

DITA goes Nuclear?

  • 1.  DITA goes Nuclear?

    Posted 11-04-2008 21:14
    Hello,
    
    At the DocTrain conference last week, I attended a session that described
    how a nuclear power plant converted all of its procedure documentation to
    DITA (previously 170,000 pages of unstructured material). As part of this
    process, they created a specialization to store the information. They are
    now interested in formalizing this specialization through OASIS, so I
    agreed to send a note checking interest on the TC.
    
    So - is there anybody on the TC interested in working on a specialization
    for the nuclear industry? If so, we can set up a subcommittee to start work
    based on what has already been done. If so, please send a note briefly
    describing your interest level (observer vs active participant). If you'd
    rather not send directly to the list at this point, you can send to me and
    I'll collect responses; if you do that, please also copy Don Day, as I'll
    be offline some of the next week and want to be sure I don't miss any
    notes.
    
    Thanks -
    
    Robert D Anderson
    IBM Authoring Tools Development
    Chief Architect, DITA Open Toolkit
    
    


  • 2.  Re: [dita] DITA goes Nuclear?

    Posted 11-04-2008 23:02
    On 11/4/08 3:10 PM, "Robert D Anderson" 


  • 3.  Re: [dita] DITA goes Nuclear?

    Posted 11-06-2008 17:06
    On 11/4/08 5:01 PM, "Eliot Kimber" 


  • 4.  RE: [dita] DITA goes Nuclear?

    Posted 11-06-2008 17:20
    Eliot, I agree with the comments from both of your e-mails on this
    topic.
    
    Is there a good place for people and organizations to informally share
    new specializations?  Part of the DITA area on xml.org?  That might be a
    way to encourage sharing of DITA specializations that are not formally
    standardized. It might be a good way to share early versions of new
    specializations before they become standardized as well.
    
    If the specializations don't need to be formally standardized, would the
    DITA Adoption TC be a better forum for encouraging this sort of thing
    than the DITA TC with its focus on standards development?
    
       -Jeff
    
    > 


  • 5.  RE: [dita] DITA goes Nuclear?

    Posted 11-06-2008 17:57
    I've always envisioned a DITA archive like the CPAN archive for Perl (http://cpan.org/).
    
    Could OASIS set up a site like that?
    
    If not, could something like that be hosted on sourceforge?
    
    
    Seraphim Larsen
    Intel Corporation * ECG TechComm
    Chandler, AZ * (480) 552-6504
    My opinions only; I don't speak for Intel. 
    
    
    
    
    


  • 6.  RE: [dita] DITA goes Nuclear?

    Posted 11-10-2008 15:33
    Your suggestion has a lot of value, Seraphim. How would you see CPAN as
    being like or different than the DITA Focus Area, http://dita.xml.org?  For
    example, what kind of file hosting service and interface might be needed by
    that Drupal site to make it more equivalent?
    
    Regards,
    --
    Don Day
    Chair, OASIS DITA Technical Committee
    Architect, Lightweight DITA Publishing Solutions
    Email: dond@us.ibm.com
    11501 Burnet Rd. MS9033E015, Austin TX 78758
    Phone: +1 512-244-2868 (home office)
    
    "Where is the wisdom we have lost in knowledge?
     Where is the knowledge we have lost in information?"
       --T.S. Eliot
    
    
                                                                                                             
      From:       "Larsen, Seraphim L" 


  • 7.  RE: [dita] DITA goes Nuclear?

    Posted 11-13-2008 17:54
    Hi Don,
    
    The main difference is that the CPAN site is already organized to support this usage model.  The very first thing listed on the CPAN page is "Perl Modules", and it takes you to a page with links for search or for browsing a categorized list of modules.
    
    But specializations aren't even listed on the Resources page, and there isn't any consistency in the descriptions of the few specializations that are mentioned on the site.
    
    So, here would be my suggestions:
    
    (1) Create a place to put the specializations.  Set up some kind of base hierarchy / taxonomy scheme.  Make it searchable.  Post guidelines on how it is intended to be organized.
    (2) Create a standard for how they should be posted:  which files to include, what kind of documentation and samples to include.  Document this standard clearly.
    (3) Post a few examples to get it started -- e.g., the already existing specializations for Learning and Training, Troubleshooting, and Music, which are listed in the Wiki Knowledgebase article, "Introduction to Specializations" (but links either don't work, or point to Sourceforge).
    
    Maybe Sourceforge is a better place, if that's where people are already posting these?
    
    
    Thanks,
    
    Seraphim Larsen
    Intel Corporation * ECG TechComm
    Chandler, AZ * (480) 552-6504
    My opinions only; I don't speak for Intel. 
    
    
    
    


  • 8.  RE: [dita] DITA goes Nuclear?

    Posted 11-13-2008 18:12
    Sounds like this might be something that should be forwarded to the DITA
    Adoption TC - they can work on setup issues, etc.
    
    Regards,
    
    Mary
    
    > 


  • 9.  RE: [dita] DITA goes Nuclear?

    Posted 11-13-2008 18:12
    Sounds like this might be something that should be forwarded to the DITA
    Adoption TC - they can work on setup issues, etc.
    
    Regards,
    
    Mary
    
    > 


  • 10.  RE: [dita] DITA goes Nuclear?

    Posted 11-08-2008 02:12
    
    
    
    
    

    As a member of the DITA Adoption TC, I think the Adoption TC would be quite interested in tracking DITA specializations, formally or informally, in the industry at large.  It could also host the information at dita.xml.org.

    Regards,

    Scott Tsao 曹壽國
    Information Architect - Associate Technical Fellow
    The Boeing Company




    mailto:jogden@ptc.com]
    Sent: Thursday, November 06, 2008 9:18 AM
    To: Eliot Kimber; dita
    Subject: RE: [dita] DITA goes Nuclear?

    Eliot, I agree with the comments from both of your e-mails on this topic.

    Is there a good place for people and organizations to informally share new specializations?  Part of the DITA area on xml.org?  That might be a way to encourage sharing of DITA specializations that are not formally standardized. It might be a good way to share early versions of new specializations before they become standardized as well.

    If the specializations don't need to be formally standardized, would the DITA Adoption TC be a better forum for encouraging this sort of thing than the DITA TC with its focus on standards development?

       -Jeff

    >
    Original Message-----
    > From: Eliot Kimber [
    mailto:ekimber@reallysi.com]
    > Sent: Thursday, November 06, 2008 12:05 PM
    > To: dita
    > Subject: Re: [dita] DITA goes Nuclear?
    >
    > On 11/4/08 5:01 PM, "Eliot Kimber" <ekimber@reallysi.com> wrote:
    >
    > > On 11/4/08 3:10 PM, "Robert D Anderson" <robander@us.ibm.com> wrote:
    > >
    > >> So - is there anybody on the TC interested in working on a
    > specialization
    > >> for the nuclear industry? If so, we can set up a subcommittee to
    start
    > work
    > >> based on what has already been done. If so, please send a note
    briefly
    > >> describing your interest level (observer vs active participant). If
    > you'd
    > >> rather not send directly to the list at this point, you can send to
    me
    > and
    > >> I'll collect responses; if you do that, please also copy Don Day,
    as
    > I'll
    > >> be offline some of the next week and want to be sure I don't miss
    any
    > >> notes.
    > >
    > > While I'm sure such a specialization is quite valuable and it's
    exciting
    > to
    > > see this type of activity happening, I worry that we are starting to
    set
    > a
    > > precedent by which every community of interest that might find DITA
    > useful
    > > wants to be a subcommittee.
    > >
    > > I don't think that's either necessary or productive in the long run.
    > DITA is
    > > expressly designed to enable unilateral extension that does not need
    to
    > be
    > > coordinated with the base standard in order to be both reliably
    > > interchangeable and potentially useful as a standard in its own
    right.
    > >
    > > There's absolutely no reason that something like a nuclear industry
    > > specialization couldn't be developed as a completely separate effort
    > within
    > > whatever standards community serves the nuclear power industry.
    >
    > Michael Priestly pointed out privately that there might be communities
    of
    > interest that do not have an existing standards-making body that could
    > host a DITA specialization standard, in which case the DITA TC would
    > be a natural home.  I agree completely.
    >
    > My main intent is that it's clear to the DITA community at large that
    > standardization within the DITA TC is not a *requirement* for
    standardized
    > DITA specialization, nor is standardization within OASIS a
    requirement.
    >
    > For example, if the Air Transport Association wanted to define an
    > aircraft-industry-specific set of specializations, it would make sense
    for
    > the ATA to host that activity--no need for it to be done under the TC
    just
    > because it happens to be a DITA-based XML application.
    >
    > Cheers,
    >
    > Eliot
    >
    > ----
    > Eliot Kimber | Senior Solutions Architect | Really Strategies, Inc.
    > email:  ekimber@reallysi.com <
    mailto:ekimber@reallysi.com>
    > office: 610.631.6770 | cell: 512.554.9368 2570 Boulevard of the
    > Generals | Suite 213 | Audubon, PA 19403 www.reallysi.com
    > <
    http://www.reallysi.com>  | http://blog.reallysi.com
    > <http://blog.reallysi.com> | www.rsuitecms.com
    <
    http://www.rsuitecms.com>
    >
    >



  • 11.  RE: [dita-adoption] RE: [dita] DITA goes Nuclear?

    Posted 11-09-2008 12:29
    
    
    
    
    
    Hi Scott,
    We do have a specializations page on dita.xml.org for this very purpose. I wonder if you might place the note about the nuclear industry there. I believe that very few if any have included specializations in the focus area. The TC should encourage the practice. Perhaps it requires some outreach to work.
     
    Thanks for the information,
    JoAnn
     

    JoAnn T. Hackos, PhD
    President
    Comtech Services, Inc.
    710 Kipling Street, Suite 400
    Denver CO 80215
    303-232-7586
    joann.hackos@comtech-serv.com

     


    From: Tsao, Scott [mailto:scott.tsao@boeing.com]
    Sent: Friday, November 07, 2008 7:08 PM
    To: Ogden, Jeff; Eliot Kimber; dita
    Cc: DITA Adoption TC
    Subject: [dita-adoption] RE: [dita] DITA goes Nuclear?

    As a member of the DITA Adoption TC, I think the Adoption TC would be quite interested in tracking DITA specializations, formally or informally, in the industry at large.  It could also host the information at dita.xml.org.

    Regards,

    Scott Tsao 曹壽國
    Information Architect - Associate Technical Fellow
    The Boeing Company




    mailto:jogden@ptc.com]
    Sent: Thursday, November 06, 2008 9:18 AM
    To: Eliot Kimber; dita
    Subject: RE: [dita] DITA goes Nuclear?

    Eliot, I agree with the comments from both of your e-mails on this topic.

    Is there a good place for people and organizations to informally share new specializations?  Part of the DITA area on xml.org?  That might be a way to encourage sharing of DITA specializations that are not formally standardized. It might be a good way to share early versions of new specializations before they become standardized as well.

    If the specializations don't need to be formally standardized, would the DITA Adoption TC be a better forum for encouraging this sort of thing than the DITA TC with its focus on standards development?

       -Jeff

    >
    Original Message-----
    > From: Eliot Kimber [
    mailto:ekimber@reallysi.com]
    > Sent: Thursday, November 06, 2008 12:05 PM
    > To: dita
    > Subject: Re: [dita] DITA goes Nuclear?
    >
    > On 11/4/08 5:01 PM, "Eliot Kimber" <ekimber@reallysi.com> wrote:
    >
    > > On 11/4/08 3:10 PM, "Robert D Anderson" <robander@us.ibm.com> wrote:
    > >
    > >> So - is there anybody on the TC interested in working on a
    > specialization
    > >> for the nuclear industry? If so, we can set up a subcommittee to
    start
    > work
    > >> based on what has already been done. If so, please send a note
    briefly
    > >> describing your interest level (observer vs active participant). If
    > you'd
    > >> rather not send directly to the list at this point, you can send to
    me
    > and
    > >> I'll collect responses; if you do that, please also copy Don Day,
    as
    > I'll
    > >> be offline some of the next week and want to be sure I don't miss
    any
    > >> notes.
    > >
    > > While I'm sure such a specialization is quite valuable and it's
    exciting
    > to
    > > see this type of activity happening, I worry that we are starting to
    set
    > a
    > > precedent by which every community of interest that might find DITA
    > useful
    > > wants to be a subcommittee.
    > >
    > > I don't think that's either necessary or productive in the long run.
    > DITA is
    > > expressly designed to enable unilateral extension that does not need
    to
    > be
    > > coordinated with the base standard in order to be both reliably
    > > interchangeable and potentially useful as a standard in its own
    right.
    > >
    > > There's absolutely no reason that something like a nuclear industry
    > > specialization couldn't be developed as a completely separate effort
    > within
    > > whatever standards community serves the nuclear power industry.
    >
    > Michael Priestly pointed out privately that there might be communities
    of
    > interest that do not have an existing standards-making body that could
    > host a DITA specialization standard, in which case the DITA TC would
    > be a natural home.  I agree completely.
    >
    > My main intent is that it's clear to the DITA community at large that
    > standardization within the DITA TC is not a *requirement* for
    standardized
    > DITA specialization, nor is standardization within OASIS a
    requirement.
    >
    > For example, if the Air Transport Association wanted to define an
    > aircraft-industry-specific set of specializations, it would make sense
    for
    > the ATA to host that activity--no need for it to be done under the TC
    just
    > because it happens to be a DITA-based XML application.
    >
    > Cheers,
    >
    > Eliot
    >
    > ----
    > Eliot Kimber | Senior Solutions Architect | Really Strategies, Inc.
    > email:  ekimber@reallysi.com <
    mailto:ekimber@reallysi.com>
    > office: 610.631.6770 | cell: 512.554.9368 2570 Boulevard of the
    > Generals | Suite 213 | Audubon, PA 19403 www.reallysi.com
    > <
    http://www.reallysi.com>  | http://blog.reallysi.com
    > <http://blog.reallysi.com> | www.rsuitecms.com
    <
    http://www.rsuitecms.com>
    >
    >



  • 12.  RE: [dita-adoption] RE: [dita] DITA goes Nuclear?

    Posted 11-09-2008 12:29
    
    
    
    
    
    Hi Scott,
    We do have a specializations page on dita.xml.org for this very purpose. I wonder if you might place the note about the nuclear industry there. I believe that very few if any have included specializations in the focus area. The TC should encourage the practice. Perhaps it requires some outreach to work.
     
    Thanks for the information,
    JoAnn
     

    JoAnn T. Hackos, PhD
    President
    Comtech Services, Inc.
    710 Kipling Street, Suite 400
    Denver CO 80215
    303-232-7586
    joann.hackos@comtech-serv.com

     


    From: Tsao, Scott [mailto:scott.tsao@boeing.com]
    Sent: Friday, November 07, 2008 7:08 PM
    To: Ogden, Jeff; Eliot Kimber; dita
    Cc: DITA Adoption TC
    Subject: [dita-adoption] RE: [dita] DITA goes Nuclear?

    As a member of the DITA Adoption TC, I think the Adoption TC would be quite interested in tracking DITA specializations, formally or informally, in the industry at large.  It could also host the information at dita.xml.org.

    Regards,

    Scott Tsao 曹壽國
    Information Architect - Associate Technical Fellow
    The Boeing Company




    mailto:jogden@ptc.com]
    Sent: Thursday, November 06, 2008 9:18 AM
    To: Eliot Kimber; dita
    Subject: RE: [dita] DITA goes Nuclear?

    Eliot, I agree with the comments from both of your e-mails on this topic.

    Is there a good place for people and organizations to informally share new specializations?  Part of the DITA area on xml.org?  That might be a way to encourage sharing of DITA specializations that are not formally standardized. It might be a good way to share early versions of new specializations before they become standardized as well.

    If the specializations don't need to be formally standardized, would the DITA Adoption TC be a better forum for encouraging this sort of thing than the DITA TC with its focus on standards development?

       -Jeff

    >
    Original Message-----
    > From: Eliot Kimber [
    mailto:ekimber@reallysi.com]
    > Sent: Thursday, November 06, 2008 12:05 PM
    > To: dita
    > Subject: Re: [dita] DITA goes Nuclear?
    >
    > On 11/4/08 5:01 PM, "Eliot Kimber" <ekimber@reallysi.com> wrote:
    >
    > > On 11/4/08 3:10 PM, "Robert D Anderson" <robander@us.ibm.com> wrote:
    > >
    > >> So - is there anybody on the TC interested in working on a
    > specialization
    > >> for the nuclear industry? If so, we can set up a subcommittee to
    start
    > work
    > >> based on what has already been done. If so, please send a note
    briefly
    > >> describing your interest level (observer vs active participant). If
    > you'd
    > >> rather not send directly to the list at this point, you can send to
    me
    > and
    > >> I'll collect responses; if you do that, please also copy Don Day,
    as
    > I'll
    > >> be offline some of the next week and want to be sure I don't miss
    any
    > >> notes.
    > >
    > > While I'm sure such a specialization is quite valuable and it's
    exciting
    > to
    > > see this type of activity happening, I worry that we are starting to
    set
    > a
    > > precedent by which every community of interest that might find DITA
    > useful
    > > wants to be a subcommittee.
    > >
    > > I don't think that's either necessary or productive in the long run.
    > DITA is
    > > expressly designed to enable unilateral extension that does not need
    to
    > be
    > > coordinated with the base standard in order to be both reliably
    > > interchangeable and potentially useful as a standard in its own
    right.
    > >
    > > There's absolutely no reason that something like a nuclear industry
    > > specialization couldn't be developed as a completely separate effort
    > within
    > > whatever standards community serves the nuclear power industry.
    >
    > Michael Priestly pointed out privately that there might be communities
    of
    > interest that do not have an existing standards-making body that could
    > host a DITA specialization standard, in which case the DITA TC would
    > be a natural home.  I agree completely.
    >
    > My main intent is that it's clear to the DITA community at large that
    > standardization within the DITA TC is not a *requirement* for
    standardized
    > DITA specialization, nor is standardization within OASIS a
    requirement.
    >
    > For example, if the Air Transport Association wanted to define an
    > aircraft-industry-specific set of specializations, it would make sense
    for
    > the ATA to host that activity--no need for it to be done under the TC
    just
    > because it happens to be a DITA-based XML application.
    >
    > Cheers,
    >
    > Eliot
    >
    > ----
    > Eliot Kimber | Senior Solutions Architect | Really Strategies, Inc.
    > email:  ekimber@reallysi.com <
    mailto:ekimber@reallysi.com>
    > office: 610.631.6770 | cell: 512.554.9368 2570 Boulevard of the
    > Generals | Suite 213 | Audubon, PA 19403 www.reallysi.com
    > <
    http://www.reallysi.com>  | http://blog.reallysi.com
    > <http://blog.reallysi.com> | www.rsuitecms.com
    <
    http://www.rsuitecms.com>
    >
    >



  • 13.  RE: [dita] DITA goes Nuclear?

    Posted 11-08-2008 02:12
    
    
    
    
    

    As a member of the DITA Adoption TC, I think the Adoption TC would be quite interested in tracking DITA specializations, formally or informally, in the industry at large.  It could also host the information at dita.xml.org.

    Regards,

    Scott Tsao 曹壽國
    Information Architect - Associate Technical Fellow
    The Boeing Company




    mailto:jogden@ptc.com]
    Sent: Thursday, November 06, 2008 9:18 AM
    To: Eliot Kimber; dita
    Subject: RE: [dita] DITA goes Nuclear?

    Eliot, I agree with the comments from both of your e-mails on this topic.

    Is there a good place for people and organizations to informally share new specializations?  Part of the DITA area on xml.org?  That might be a way to encourage sharing of DITA specializations that are not formally standardized. It might be a good way to share early versions of new specializations before they become standardized as well.

    If the specializations don't need to be formally standardized, would the DITA Adoption TC be a better forum for encouraging this sort of thing than the DITA TC with its focus on standards development?

       -Jeff

    >
    Original Message-----
    > From: Eliot Kimber [
    mailto:ekimber@reallysi.com]
    > Sent: Thursday, November 06, 2008 12:05 PM
    > To: dita
    > Subject: Re: [dita] DITA goes Nuclear?
    >
    > On 11/4/08 5:01 PM, "Eliot Kimber" <ekimber@reallysi.com> wrote:
    >
    > > On 11/4/08 3:10 PM, "Robert D Anderson" <robander@us.ibm.com> wrote:
    > >
    > >> So - is there anybody on the TC interested in working on a
    > specialization
    > >> for the nuclear industry? If so, we can set up a subcommittee to
    start
    > work
    > >> based on what has already been done. If so, please send a note
    briefly
    > >> describing your interest level (observer vs active participant). If
    > you'd
    > >> rather not send directly to the list at this point, you can send to
    me
    > and
    > >> I'll collect responses; if you do that, please also copy Don Day,
    as
    > I'll
    > >> be offline some of the next week and want to be sure I don't miss
    any
    > >> notes.
    > >
    > > While I'm sure such a specialization is quite valuable and it's
    exciting
    > to
    > > see this type of activity happening, I worry that we are starting to
    set
    > a
    > > precedent by which every community of interest that might find DITA
    > useful
    > > wants to be a subcommittee.
    > >
    > > I don't think that's either necessary or productive in the long run.
    > DITA is
    > > expressly designed to enable unilateral extension that does not need
    to
    > be
    > > coordinated with the base standard in order to be both reliably
    > > interchangeable and potentially useful as a standard in its own
    right.
    > >
    > > There's absolutely no reason that something like a nuclear industry
    > > specialization couldn't be developed as a completely separate effort
    > within
    > > whatever standards community serves the nuclear power industry.
    >
    > Michael Priestly pointed out privately that there might be communities
    of
    > interest that do not have an existing standards-making body that could
    > host a DITA specialization standard, in which case the DITA TC would
    > be a natural home.  I agree completely.
    >
    > My main intent is that it's clear to the DITA community at large that
    > standardization within the DITA TC is not a *requirement* for
    standardized
    > DITA specialization, nor is standardization within OASIS a
    requirement.
    >
    > For example, if the Air Transport Association wanted to define an
    > aircraft-industry-specific set of specializations, it would make sense
    for
    > the ATA to host that activity--no need for it to be done under the TC
    just
    > because it happens to be a DITA-based XML application.
    >
    > Cheers,
    >
    > Eliot
    >
    > ----
    > Eliot Kimber | Senior Solutions Architect | Really Strategies, Inc.
    > email:  ekimber@reallysi.com <
    mailto:ekimber@reallysi.com>
    > office: 610.631.6770 | cell: 512.554.9368 2570 Boulevard of the
    > Generals | Suite 213 | Audubon, PA 19403 www.reallysi.com
    > <
    http://www.reallysi.com>  | http://blog.reallysi.com
    > <http://blog.reallysi.com> | www.rsuitecms.com
    <
    http://www.rsuitecms.com>
    >
    >