[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
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
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]
Powered by eList eXpress LLC