Re: [soa-rm] SOA-RM draft in OpenOffice

[Duane Nickull <dnickull@adobe.com>]

Hello Hamid:

The TC is collectively the authors, however we collectively established 
an editing team during our TC meetings.  We all decided unanimously that 
the editing process will be divided amongst only the editing team to 
avoid having multiple versions of document floating around.  One person 
will act as Chief editor for the purpose of coordinating editing 
activity and ensuring consistent authoring style.

The editors only commit to paper what the TC collectively agrees on - 
they do not author the materials.  When sections are finished, they will 
then be presented for review by the TC.  At that time, if there is 
something that you wish to see changed, there is an opportunity to 
present it and state a case for change.  We hope you will participate in 
that process.

Suffice to say, I for one am extremely happy with the level of quality 
from our editors so far.  I think they have collectively done an 
excellent  job.

Cheers

Duane


Hamid Ben Malek wrote:

> Matt,
>
> Thanks for the explanation. What you are saying is very troubling 
> indeed. This whole process as you describe it is not very open.
>
>  
>
> One person having complete and total control on how the draft is 
> written and organized is very troubling. It may seem very appropriate 
> to have one single copy of it that is not accessible by others, but 
> there are so many disadvantages to this approach.
>
>  
>
> When a regular member of the TC modifies a draft and uploads it to the 
> Oasis site, it does not mean that his/her modifications are permanent. 
> Incorporating the modifications directly into the draft gives the 
> author all the flexibility of expression, and it makes the document 
> available to the TC for further discussions until the day of the vote 
> where certain things may be adopted and others may be rejected and the 
> editors of the spec would then do the clean up based on what was 
> adopted and what was rejected by merging it into another draft with a 
> different version that is also uploaded to the site. But this is not 
> what is most troubling. What is most troubling is the fact that the 
> whole set of place-holders and sections seems to have been fixed 
> forever. What if a member wants to add other sections, or even modify 
> the whole organization of the draft? I guess your answer would be that 
> the time for adding place-holders was gone.
>
>  
>
> Thanks,
>
>  
>
> Hamid.
>
> P.S. When you are done with your DocBook version, would you please at 
> least upload the DocBook version?
>
>  
>
> -----Original Message-----
> From: Matthew MacKenzie [mailto:mattm@adobe.com]
> Sent: Friday, May 06, 2005 11:26 AM
> To: Hamid Ben Malek
> Cc: soa-rm@lists.oasis-open.org
> Subject: Re: [soa-rm] SOA-RM draft in OpenOffice
>
>  
>
> Hamid,
>
>  
>
> 2 things:
>
>  
>
> 1) You are not an editor of the specification.  You do not sign up for
>
> any sections when that was happening last week.
>
> 2) FYI, editors of the specification send their work to me in vanilla MS
>
> Word format.  I take the submitted content and work it into the master
>
> document.  There is only one copy of the master specification in play. 
>
> This master document *may* be maintained in docbook.  I am working on
>
> the toolchain for that at the moment.
>
>  
>
> -Matt
>
> Hamid Ben Malek wrote:
>
>  
>
>> This may sound like a stupid question: How can we edit the spec if
>
>> there are no OpenOffice versions of the spec draft on the web site of
>
>> SOA-RM?
>
>> 
>
>> Could somebody please upload an OpenOffice version of the latest draft
>
>> to Oasis site so that we can do some editing?
>
>> 
>
>> 
>
>> 
>
>> Thanks,
>
>> 
>
>> 
>
>> 
>
>> Hamid.
>
>> 
>

-- 
***********
Senior Standards Strategist - Adobe Systems, Inc. - http://www.adobe.com
Chair - OASIS Service Oriented Architecture Reference Model Technical Committee - 
http://www.oasis-open.org/committees/tc_home.php?wg_abbrev=soa-rm
Vice Chair - UN/CEFACT Bureau Plenary - http://www.unece.org/cefact/
Adobe Enterprise Developer Resources  - http://www.adobe.com/enterprise/developer/main.html
***********