RE: [saf] Documents naming and maintenance

[<Stavros.Isaiadis@uk.fujitsu.com>]

Yes, exactly! Thanks for clarifying this.

Stavros


 > -----Original Message-----
 > From: Lipton, Paul C [mailto:Paul.Lipton@ca.com]
 > Sent: 17 March 2010 02:10
 > To: Stavros Isaiadis; saf@lists.oasis-open.org
 > Subject: RE: [saf] Documents naming and maintenance
 >
 >
 > Stavros,
 >
 > You said: " When a WD is approved, only then we create a new
 > document with the suffix "CD 01". Every time changes are
 > made, we REPLACE the file, thus increasing its revision
 > number. When a new version of the CD is approved, we create
 > a new document with a new suffix "CD 02" and so on."
 >
 > Not to be picky, but just to clarify, there is actually no
 > concept of an "approved WD." What I think you meant was when
 > a WD is approved as a CD."
 >
 > Thanks,
 > Paul
 >  
 > Paul Lipton
 > VP, Industry Standards and Open Source
 > Member, CA Council for Technical Excellence
 > Phone (preferred number!): +1 215 539-2731
 > Mobile: +1 267 987-6887
 > Email: paul.lipton@ca.com
 >
 > THIS MESSAGE MAY CONTAIN CONFIDENTIAL, PRIVILEGED OR OTHER
 > LEGALLY PROTECTED INFORMATION. IT IS INTENDED FOR THE
 > ADDRESSEE ONLY. IF YOU ARE NOT THE ADDRESSEE (OR SOMEONE THE
 > ADDRESSEE AUTHORIZED TO RECEIVE THIS MESSAGE), YOU ARE
 > PROHIBITED FROM COPYING, DISTRIBUTING OR OTHERWISE USING IT.
 > PLEASE NOTIFY THE SENDER AND RETURN IT AT OUR COST. THANK YOU.
 >
 >
 >
 > -----Original Message-----
 > From: Stavros.Isaiadis@uk.fujitsu.com
 > [mailto:Stavros.Isaiadis@uk.fujitsu.com]
 > Sent: Tuesday, March 16, 2010 7:28 AM
 > To: saf@lists.oasis-open.org
 > Subject: [saf] Documents naming and maintenance
 >
 > Hi all,
 >
 > A few rules and guidelines on naming and versioning:
 >
 > Stages in TC documents:
 > Working Draft -> Committee Draft -> Public Review Draft ->
 > Committee Specification -> OASIS Standard
 >
 > All of the above have both Versions AND Revision numbers
 > EXCEPT the Working Drafts which have no Revisions (all
 > changes are reflected in an updated Version number).
 >
 > So, here are the rules for naming and versioning:
 >
 > For Working Drafts we use the suffix "WD" at the end of the
 > filename, and when changes are made, we REPLACE the file NOT
 > add a new one to the folder! This will keep track of the
 > revisions for the WD.
 >
 > When a WD is approved, only then we create a new document
 > with the suffix "CD 01". Every time changes are made, we
 > REPLACE the file, thus increasing its revision number. When
 > a new version of the CD is approved, we create a new
 > document with a new suffix "CD 02" and so on.
 >
 > Same process for Public Review Drafts and Specifications.
 >
 > On top of that, we will also use the following prefixes, as
 > discussed previously:
 >
 > "SAF-" for specification or profile related documents (e.g.
 > Spec it self, Whitepaper and Issues list)
 >
 > "Educational-" for promotional documents (e.g. FAQ & PPT.)
 >
 > "UseCase-" for use case documents
 >
 > Some examples:
 >
 > "SAF-WhitePaper WD" -no version reflected in the name
 > itself. Instead, it is tracked everytime we replace the file
 > (like SVN sort of) "SAF-WhitePaper CD 01" -only Version but
 > no Revision reflected in the name itself! Revisions are
 > tracked when we replace the file. "UseCase-Provisioning WD"
 > "Educational-FAQ WD" -the current name for the unapproved
 > FAQ. "Educational-FAQ CD 01" -when we approve the FAQ it
 > will get this name
 >
 >
 > If you are in doubt please contact me or send me or Jeff the
 > file to upload properly.
 >
 > As I'm currently trying to "clean" the documents folder
 > based on the rules above, expect to receive action items to
 > clean up some of the files uploaded (due to permission
 > restrictions even for us chairs!)
 >
 > Sorry for the long email and thanks for the understanding
 > and cooperation!
 >
 > Cheers,
 >
 > Stavros
 >

______________________________________________________________________
                                       
 Fujitsu Laboratories of Europe Limited
 Hayes Park Central, Hayes End Road, Hayes, Middlesex, UB4 8FE
 Registered No. 4153469

 This e-mail and any attachments are for the sole use of addressee(s) and
 may contain information which is privileged and confidential. Unauthorised
 use or copying for disclosure is strictly prohibited. The fact that this
 e-mail has been scanned by Trendmicro Interscan does not guarantee that
 it has not been intercepted or amended nor that it is virus-free.