Re: Re: Re: [uoml] uoml sample document

[stephen.green@systml.co.uk]

Thanks Alex

Apologies that I didn't quite realise the purpose of the documents
as being to consider the format rather than the content.

Yes the format does appear to be along the correct lines, although
there would probably need to be additions such as, at the least -

OASIS logo
Title - such as 'Document Operation Language (UOML) 1.0'

Publication Date
Document identifier  - could be same as the filename if it obeys the  
OASIS rules
Editorial Status - 'Draft'
Location (perhaps include this later when one is established)
Editors
Contributors

<rest of document as in the samples sent on the 14th Feb>

Normative References  (if there are any, perhaps ODF, W3C XML Schema, XML )
Non-Normative References  (if there are any - perhaps ODF would be here)
Notices (OASIS copyright)

I am also reminded that it would seem to be ideal if there
were no spaces in the filename but if there are spaces then
no double spaces. Maybe an file name without spaces like
'wd-UOML-0-1.odt' might be ideal, or 'wd-UOML-1.0.odt' but
I think it best to avoid '.' except for extensions.

I hope these comments are more relevant. The document samples
have a good structure as OASIS specification drafts, I think.

All the best

Stephen Green





Quoting Wang Donglin <dlwang@sursen.com>:

> Thanks Green.
> Xu Guo has given the .odt file format for the sample schedma, TOC   
> and instroduction in 14th Feb. Pine converted to PDF in 27th Feb. We  
>  need your comment to these documents. After confirmation of sample,  
>  we will provide the whole specification according to the style of   
> sample.
>
> -Alex
>
>> Greetings Alex, UOML TC,
>>
>> We need to list the documents to be provided in the specification.
>>
>> I expect we have a list like the following at the present time:
>>
>> 1. Draft W3C XML Schema files
>> 2. Draft specification prose document (in open document, XHTML and   
>> pdf format)
>> 3. Samples in both prose and XML formats
>>
>> Besides item 2 we will need a collection of all of the diagrams as .jpg or
>> equivalent.
>>
>> We might also need to produce a docbook version of item 2, provided we
>> have the skills. This will be an editable XML version of the prose
>> specification text from which the other file formats can be generated
>> (such as with XSLT, say). That way we would only need to concentraton
>> editing one document. Maybe we wish to use Open Document for the
>> editable version,
>> in which case may I suggest we use the .odt file format. Does Red Office
>> support this same file type as the one used in Open Office? It is possible
>> to create pdf and XHTML from this format but maybe we need help with this
>> from Mary to get the exact OASIS style right. Suggestions on how to do this
>> from an Open Office file or Red Office file would be welcome. Or does it
>> require docbook for the generation of the right OASIS style?
>>
>> Then we need a folder structure to be decided if we are to zip the package
>> into one zip file for easy download.
>>
>> We also need to agree for the schema files:
>>
>> 1. the namespace format
>> 2. the filename format
>>
>> Plus version and naming rules for the whole specification - for UOML itself.
>>
>> For that we need to understand the latest OASIS namespace and file naming
>> rules which are not very restrictive so there is much that is just for
>> the TC to decide.
>>
>> Do we have draft copies of the whole specification and the schema files?
>>
>> Enough of me for now.
>>
>> All the best
>>
>> Stephen Green
>>
>>
>> Quoting Wang Donglin <dlwang@sursen.com>:
>>
>>> Dear TC members,
>>> The most important topic of 2nd meeting is the discussion of UOML
>>> Specification samples and UOML work draft TOC. We will write the
>>> whole work draft according to it before March 31th. We need your
>>> comment on whether the format and expression meets the requirement
>>> of OASIS specification. Especially, I'd like hear from Charles,
>>> Green and Lin Fong, since you are experienced OASIS contributors.
>>>
>>> -Alex
>>>
>>>> Hello,
>>>>
>>>> I have converted those two documents into PDF format, which was
>>>> edited by Guo Xu , please have a review in the attachment.
>>>>
>>>> I am looking forward to your advice.
>>>>
>>>> Regards
>>>>
>>>> Pine
>>>>
>>>>  ----- Original Message -----
>>>>  From: guoxu
>>>>  To: uoml@lists.oasis-open.org
>>>>  Sent: Wednesday, February 14, 2007 9:58 PM
>>>>  Subject: [uoml] [SPAM] uoml sample document
>>>>
>>>>
>>>>  hi, everyone. here's the uoml sample document.
>>>>
>>>>  there are two documents in attachment. one is instroduction of the
>>>>  draft, the other describes three samples and the structure of the
>>>> draft.
>>>>
>>>>  any comment or question is welcome.
>>>>
>>>>  guoxu
>>>>
>>>>
>>>
>>>
>>>
>>>
>>>
>>>
>>
>>
>>
>> .
>
>
>
>
>