OASIS Darwin Information Typing Architecture (DITA) TC

 View Only
Expand all | Collapse all

#12020: elements in specializations which contain only #PCDATA

  • 1.  #12020: elements in specializations which contain only #PCDATA

    Posted 10-17-2007 01:17

    Hi all,

    I'm raising this as a result of an outstanding issue with #12020 that was raised at this week's TC call.

    #12020 has a list of elements in the standard DITA specializations that contain only #PCDATA.  The proposal suggests adding elements to them so that re-usable text can be used.  

    The choices of elements to add are <ph>, <keyword> and/or <text>.

    Here is the current draft:

    Bookmap

            * revisionid gets keyword
            * year gets keyword
            * month gets keyword
            * day gets keyword
            * edition gets keyword
            * isbn gets keyword
            * volume gets keyword

    Programming domain

            * option gets keyword
            * parmname gets keyword
            * synph gets keyword
            * apiname gets keyword
            * kwd gets keyword

    Software domain

            * msgnum gets keyword
            * cmdname gets keyword
            * varname gets keyword

    UI domain

            * wintitle gets keyword
            * shortcut gets keyword

    Utilities domain

            * shape gets keyword

    xNAL domain

            * honorific gets keyword
            * firstname gets keyword
            * middlename gets keyword
            * lastname gets keyword
            * generationidentifier gets keyword
            * postalcode gets keyword
            * country gets keyword
            * contactnumber gets keyword

    That's a lot of <keyword>.

    Are any of those choices wrong?  Can people imagine a case where an element in that list would need to contain non-keywordy text?  Please reply to the list.

    --
    Deborah Pickett
    Information Architect, Moldflow Corporation, Melbourne
    Deborah_Pickett@moldflow.com


  • 2.  Re: [dita] #12020: elements in specializations which contain only #PCDATA

    Posted 10-17-2007 02:06

    Deborah_Pickett@moldflow.com wrote on 17/10/2007 11:17:10 AM:
    > Programming domain
    >         * option gets keyword
    >         * parmname gets keyword
    >         * apiname gets keyword
    >         * kwd gets keyword
    > Software domain
    >         * msgnum gets keyword
    >         * cmdname gets keyword
    >         * varname gets keyword
    > UI domain
    >         * wintitle gets keyword
    >         * shortcut gets keyword
    > Utilities domain
    >         * shape gets keyword

    I can answer myself here.  All of those elements already specialize <keyword>, so they can't themselves contain <keyword>.  They'll have to contain <text>.  (Unless we want to have <keyword> nest.  What about that?)  

    But the ones I haven't quoted above I would still like to know what people think.

    --
    Deborah Pickett
    Information Architect, Moldflow Corporation, Melbourne
    Deborah_Pickett@moldflow.com