THE SPDX WIKI IS NO LONGER ACTIVE. ALL CONTENT HAS BEEN MOVED TO https://github.com/spdx

Difference between revisions of "Technical Team/Proposals/2010-10-21/artifactOf"

From SPDX Wiki
Jump to: navigation, search
Line 11: Line 11:
 
<h2>Proposal</h2>
 
<h2>Proposal</h2>
  
<p>Define a property of File whose value is a DOAP Project.  The DOAP Project will contain the project name and homepage URL when they are known.  It also might also included more complete information regarding a project, if such information is known.  For more information regarding DOAP see <a href="http://en.wikipedia.org/wiki/Description_of_a_Project">Wikipedia</a> and <a href="http://schemapedia.com/schemas/doap">Schemapedia</a> </p>
+
<p>Define a property of File whose value is a DOAP Project.  The DOAP
 +
Project will contain the project name and homepage URL when they are
 +
known.  It also might also included more complete information
 +
regarding a project, if such information is known.  For more
 +
information regarding DOAP see <a
 +
href="http://en.wikipedia.org/wiki/Description_of_a_Project">Wikipedia</a>
 +
and <a href="http://schemapedia.com/schemas/doap">Schemapedia</a> </p>
  
<p>Multiple instances of this property are allowed because the exact origin of a file may be unclear.  If a file was first created in a project A and then copied and modified in project B the file version of the file in project be would be an artifact of both projects A and B.</p>
+
<p>Multiple instances of this property are allowed because the exact
 +
origin of a file may be unclear.  If a file was first created in a
 +
project A and then copied and modified in project B the file version
 +
of the file in project be would be an artifact of both projects A and
 +
B.</p>
  
 
<h3>Additions to spec</h3><p>
 
<h3>Additions to spec</h3><p>
Line 24: Line 34:
 
5.6.5 RDF: /RDF/SPDXDoc/Describes/File/ArtifactOf
 
5.6.5 RDF: /RDF/SPDXDoc/Describes/File/ArtifactOf
 
5.6.6 Data Format: doap:Project
 
5.6.6 Data Format: doap:Project
 +
</p>
  
 
<p>The value of this property is a doap:Project.  For the RDF/XML
 
<p>The value of this property is a doap:Project.  For the RDF/XML
format it may be a URI pointing to the project info, or a valid
+
format it may be any valid doap:Project resource, including a URI
doap:Project resource.  For the tag value format project information
+
reference.  For the tag value format project information is limited to
is limited to name and homepage.  These tags are are semantically
+
name and homepage.  These tags are are semantically equivalent to
equivalent to doap:name and doap:homepage properties, respectively.
+
doap:name and doap:homepage properties, respectively. Either name of
Either name of homepage may be omitted in the tag value format.</p>
+
homepage may be omitted in the tag value format.</p>
  
5.6.7 Example:
+
<p>5.6.7 Example:
</p>
+
</p><p>&nbsp;</p>
<pre>
+
<pre>       ArtifactOf: Project: name: JUnit<br />                            homepage: http://www.junit.org<br /></pre>
        ArtifactOf: Project: name: JUnit
+
                            homepage: http://www.junit.org
+
</pre>
+

Revision as of 18:26, 9 November 2010

Status

Open

Alternative to <a href="http://www.spdx.org/wiki/proposal-2010-10-21-2-file-origin">Proposal 2010-10-21-1: File origin</a>

Issue

The origin of a file is an important fact that is not described by and spdx file.

Proposal

Define a property of File whose value is a DOAP Project. The DOAP Project will contain the project name and homepage URL when they are known. It also might also included more complete information regarding a project, if such information is known. For more information regarding DOAP see <a href="http://en.wikipedia.org/wiki/Description_of_a_Project">Wikipedia</a> and <a href="http://schemapedia.com/schemas/doap">Schemapedia</a>

Multiple instances of this property are allowed because the exact origin of a file may be unclear. If a file was first created in a project A and then copied and modified in project B the file version of the file in project be would be an artifact of both projects A and B.

Additions to spec

5.6 ArtifactOf 5.6.1 Purpose: Identify the project(s) of which this file is a part. 5.6.2 Intent: By providing data regarding the project(s) where this file originated or occurs the reader can better identify the source and use it to do further research if needed. 5.6.3 Cardinality: Optional, 0 or more. 5.6.4 Tag: "ArtifactOf" 5.6.5 RDF: /RDF/SPDXDoc/Describes/File/ArtifactOf 5.6.6 Data Format: doap:Project

The value of this property is a doap:Project. For the RDF/XML format it may be any valid doap:Project resource, including a URI reference. For the tag value format project information is limited to name and homepage. These tags are are semantically equivalent to doap:name and doap:homepage properties, respectively. Either name of homepage may be omitted in the tag value format.

5.6.7 Example:

 

        ArtifactOf: Project: name: JUnit<br />                             homepage: http://www.junit.org<br />