[LSC] FW: Proposed change to LDraw part file header to support the CA

[Ross Crawford]

Not 100% sure on what the various brackets mean. [] are often used to 
represent optional information, but it looks like (not specified) all 
such information in the header is mandatory? Should we also allow for 
optional email? It's nice for part users to be able to contact the 
author directly if they wish to, otherwise ldraw.org will need to 
provide a mechanism for them to be able to do that via the username, and 
instructions will need to be provided.

ROSCO

LDraw wrote:
> I forward the message by chris. I still have to figure out what's wrong 
> with his posting privileges.
> w.
> 
> 
>> FW: Proposed change to LDraw part file header to support the CA
>> From: <chris_w_dee at hotmail.com>
>> Date: Sun, 30 Jul 2006 18:28:34 +0100
>> Resend of request sent on 8 June. It would help me a lot to get this 
>> ratified as soon as possible.
>> Chris
>>
> ------------------------------------------------------------------------
>>
>> *From:* Chris Dee [mailto:chris.w.dee at ntlworld.com]
>> *Sent:* 08 June 2006 20:37
>> *To:* 'LDraw Standards Committee'
>> *Subject:* Proposed change to LDraw part file header to support the CA
>>  
>> Hi
>> Implementation of the Contributor Agreement requires some changes to 
>> the header section in LDraw part files. The attached proposal already 
>> has the blessing of all members of the SteerCo. The usage of Steffen 
>> as an example of a non-CA author is now obsolete, as he has finally 
>> affirmed.
>> It would help me if you could discuss this within the LSC and give me 
>> a single consolidated reply. Can I ask for a response before 17th June?
>> Any delay in agreement on this will hold up the next parts release, as 
>> I want to get the distributions sorted out before releasing 2006-01.
>> Kind regards, Chris Dee
> 
> 
> 
> CAheaderV1.doc:
> Proposed changes to the LDraw part header to support the Contributor 
> Agreement
> The following shortcomings in the current LDraw part header require 
> attention to support the Contributor Agreement :
> a) The author line fails to identify the LDraw.org username – the basis 
> upon which CA affirmation is assessed.
> b) The header does not identify whether the part is covered by the 
> Contributor Agreement or not.
> c) The change history comment lines are unstructured and fail to clearly 
> identify the LDraw.org username.
> 
> 
> The proposed new structure for official parts is :
> 0 <PartDescription>
> 0 Name: <Filename>.dat
> 0 Author: <RealName> [<UserName>]
> 0 LDRAW_ORG Part|Subpart|Primitive UPDATE <YYYY-RR>
> 0 Redistributable under CCAL version 2.0 : see CAreadme.txt
> or
> 0 Not redistributable : see NonCAreadme.txt
> 
> For example:
> 0 Animal Scorpion
> 0 Name: 30169.dat
> 0 Author: Chris Dee [cwdee]
> 0 LDRAW_ORG Part UPDATE 2006-01
> 0 Redistributable under CCAL version 2.0 : see CAreadme.txt
> and
> 0 Stud Hollow Group  4 x  4
> 0 Name: stug4a.dat
> 0 Author: Steffen
> 0 LDRAW_ORG Primitive UPDATE 2006-01
> 0 Not redistributable : see NonCAreadme.txt
> 
> For the change history, I’d prefer to add a “0 HISTORY” meta-statement:
> 0 HISTORY <YYYY-MM-DD> [<UserName>] <Free text>
> or
> 0 HISTORY <YYYY-MM-DD> {<RealName>} <Free text>
> I’d also like the release process to automatically add lines to this 
> when a part is made official – at present it is unclear which changes 
> are included in which version of the file.
> For example, this,
> 0 Technic Connector
> 0 Name: 3651.dat
> 0 Author: James Jessiman
> 0 Official LCAD Part - 2000-02 Update
> 0 2000-Aug Axel Poque, Manfred Moolhuysen - fixes to resolve L3P error 
> messages
> 0 // 2004-05-18 GuyVivan Made BFC compliant
> 0 // 2004-05-18 GuyVivan Use more primitive
> 0 BFC CERTIFY CCW
> when next released would become
> 0 Technic Connector
> 0 Name: 3651.dat
> 0 Author: James Jessiman [JamesJessiman]
> 0 LDRAW_ORG Part UPDATE 2006-01
> 0 BFC CERTIFY CCW
> 0 HISTORY 2000-08-?? {Axel Poque} fixes to resolve L3P error messages
> 0 HISTORY 2000-08-?? {Manfred Moolhuysen} fixes to resolve L3P error 
> messages
> 0 HISTORY 2002-04-25 [PTadmin] Official update 2002-02
> 0 HISTORY 2004-05-18 [guyvivan] Made BFC compliant
> 0 HISTORY 2004-05-18 [guyvivan] Use more primitive
> 0 HISTORY 2006-??-?? [PTadmin] Official update 2006-01
> 
> I also propose to add full headers to the ~Moved to files and other 
> admin generated files with a special name / username, probably “PTadmin”.
> 
> v1.0     Chris Dee 22 May 2006
> _______________________________________________
> LSC mailing list
> LSC at ldraw.org
> http://five.pairlist.net/mailman/listinfo/lsc
>