[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
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 > > -- Eve Maler +1 781 442 3190 Sun Microsystems cell +1 781 354 9441 Web Technologies and Standards eve.maler @ sun.com
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Powered by eList eXpress LLC