[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Subject: Re: [ubl-ndrsc] FW: [ebxml-msg] Docbook,was: Errata Format and Style etc
Note that it is now required that Committee Specs submitted to OASIS for consideration as an OASIS Standard must be formatted in the OASIS-approved templates mentioned by Eve. (See item #1 of http://www.oasis-open.org/committees/process.shtml#approval_standard ) -Karl Eve L. Maler wrote: > Check out this OASIS site: > > http://www.oasis-open.org/spectools/ > > You'll find DocBook tools there... > > Tim McGrath wrote: > >> this is something that should apply to all UBL documentation for >> public consumption.. maybe this is a task for 'tools and techniques' >> - to evaulate docbook and recommend ways (and some tools with which) >> we can use it. >> >> We are starting to think about UBL 1p00 as an OASIS spec so we should >> be planning this format now. >> >> well volunteered Gunther! >> >> >> >> Stuhec, Gunther wrote: >> >>> Hello all, >>> >>> Matthew MacKenzie recommends the ebXML Messaging group to be begin >>> using docbook. I guess, we should do the same for our representation >>> of documentation and descriptions. Matthew told that Norman Walsh has >>> put together a package to help OASIS spec authors to use docbook. And >>> Matthew used that for a proposal for the RegRep group. I might be a >>> good idea to look into this package, too. What do you think about it. >>> >>> Kind regards, >>> >>> Gunther >>> >>> -----Original Message----- >>> From: Matthew MacKenzie [mailto:matt@xmlglobal.com] >>> Sent: Freitag, 8. November 2002 03:55 >>> To: Doug Bunting >>> Cc: Mike Dillon - Drummond Group; ebxml-msg@lists.oasis-open.org >>> Subject: [ebxml-msg] Docbook, was: Errata Format and Style etc >>> >>> >>> Doug, >>> >>> To take your (and mine) HTML bias to new heights, I recommend that we >>> begin using docbook. Norman Walsh has put together a package to help >>> OASIS spec authors to use docbook. I have used it in the past to >>> draft proposals for the RegRep group, and I found it extremely useful >>> because my formatting was guaranteed to be correct as long as I kept >>> my XML valid and well formed. The HTML output by the docbook html >>> stylesheet also places anchors at all of the sections and links them >>> together in the table of contents, allowing you to quickly zoom to >>> the section you want, or include a link in email directly to that >>> section. >>> >>> I think the W3C uses docbook, which is ironic seeing as docbook is an >>> OASIS spec hardly used by OASIS spec TCs. If this TC wants to start >>> going down that route, I would be willing to do the conversion on the >>> current specification source into docbook to get the effort started. >>> >>> -Matt >>> >>> On Thursday, Nov 7, 2002, at 16:03 America/Vancouver, Doug Bunting >>> wrote: >>> >>> >>> >>>> Mike, >>>> >>>> I would much prefer this document be a 'tidy' HTML document and that >>>> it liberally use links to tie the comments into the PDF version of >>>> our specification. (Are links in to a PDF document possible? Guess >>>> we could fall back to linking into the Word document.) >>>> >>>> Beyond that delivery and linking issues, I don't have many qualms >>>> with this format. The introductory material may not be necessary >>>> but also doesn't cause a problem. >>>> >>>> In the final section, you've included a few "act liberally" >>>> comments. I'd recommend we act a bit more forcefully about at least >>>> the SOAP non-compliance issues (if this can be classed as such). >>>> Even for the clarification around SyncReply in a synchronous reply, >>>> we should recommend both parsing such a response without error and >>>> not creating one in the first place. As a general rule, we should >>>> balance acting liberally on receipt with recommendations to clarify >>>> the options for senders. >>>> >>>> thanx, >>>> doug >>>> >>>> Mike Dillon - Drummond Group wrote: >>>> >>>> >>>> >>>>> Hi all, >>>>> >>>>> Attached is a draft of the Errata format >>>>> that Ian has graciously furnished and I have filled in some >>>>> sections for ebXML Messaging. >>>>> >>>>> I am looking for any comments on style, format... >>>>> I will continue to update the items from the various >>>>> interops, ebxml-msg@lists.oasis-open.org the requirements and other >>>>> sources, and send out an update next week. >>>>> >>>>> thanks ! >>>>> mike dillon >>>>> mike@drummondgroup.com >>>>> 817 875 0794 >>>>> >>>> >>>> >>>> ---------------------------------------------------------------- >>>> To subscribe or unsubscribe from this elist use the subscription >>>> manager: <http://lists.oasis-open.org/ob/adm.pl> >>>> >>> >>> >>> >>> ---------------------------------------------------------------- >>> To subscribe or unsubscribe from this elist use the subscription >>> manager: <http://lists.oasis-open.org/ob/adm.pl> >>> >>> ---------------------------------------------------------------- >>> To subscribe or unsubscribe from this elist use the subscription >>> manager: <http://lists.oasis-open.org/ob/adm.pl> >>> >>> >>> >> >> -- >> regards >> tim mcgrath >> fremantle western australia 6160 >> phone: +618 93352228 fax: +618 93352142 >> > -- ================================================================= Karl F. Best Vice President, OASIS +1 978.667.5115 x206 karl.best@oasis-open.org http://www.oasis-open.org
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Powered by eList eXpress LLC