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

Difference between revisions of "Technical Team/RDF Vocabulary Contributions - HOWTO"

From SPDX Wiki
Jump to: navigation, search
(Convert to MediaWiki syntax)
 
Line 1: Line 1:
<p>To make contributions to the spec please follow these steps.
+
To make contributions to the spec please follow these steps.
  
</p><ol>
+
# [http://bugs.linux-foundation.org/enter_bug.cgi?product=spdx Report the issue]. Reporting an issue is a huge contribute. You can stop here and have our gratitude. If you want to try to fix the issue you can follow the steps below.
  <li><p><a href="http://bugs.linux-foundation.org/enter_bug.cgi?product=spdx">Report the issue</a>. Reporting an issue is a huge contribute. You can stop here and have our gratitude. If you want to try to fix the issue you can follow the steps below.</p></li>
+
# Clone the repository and setup the build system (see below).
  <li><p>Clone the repository and setup the build system (see below).</p></li>
+
# Create a feature branch.
  <li><p>Create a feature branch.</p></li>
+
# Make your changes on that branch.
  <li><p>Make your changes on that branch.</p></li>
+
# [[Technical_Team/Proposals|Create a proposal]] linking to the issue and describing your changes. Be sure to attach a patch (and include a link to your branch is if it published anywhere).
  <li><p><a href="http://spdx.org/wiki/proposals">Create a proposal</a> linking to the issue and describing your changes. Be sure to attach a patch (and include a link to your branch is if it published anywhere).</p></li>
+
</ol>
+
  
<h3>Specification development setup</h3>
+
===Specification development setup===
  
<p>The master source for the specification resides in a git repository hosted at linuxfoundation.org. Anyone can clone a working copy by doing:</p>
+
The master source for the specification resides in a git repository hosted at linuxfoundation.org. Anyone can clone a working copy by doing:
  
<pre><code>git clone http://git.linuxfoundation.org/spdx-spec.git</code></pre>
+
    git clone http://git.linuxfoundation.org/spdx-spec.git
  
<p>The spdx specification build system is based on ruby. The following steps are required to generate the complete version of the specification.</p>
+
The spdx specification build system is based on ruby. The following steps are required to generate the complete version of the specification.
  
<ol>
+
# Install Ruby 1.9.2 using the appropriate mechanism for your OS. (Earlier versions of Ruby will probably work but have not been tested.)
  <li><p>Install Ruby 1.9.2 using the appropriate mechanism for your OS. (Earlier versions of Ruby will probably work but have not been tested.)</p></li>
+
# Install sqlite3-ruby gem: gem install --source http://rubygems.org sqlite3-ruby --version 1.2.5
  <li><p>Install sqlite3-ruby gem: gem install --source http://rubygems.org sqlite3-ruby --version 1.2.5</p></li>
+
# Install rdf-context gem: <code>gem install --source http://rubygems.org rdf_context</code>
  <li><p>Install rdf-context gem: <code>gem install --source http://rubygems.org rdf_context</code></p></li>
+
# Install mustache gem: <code>gem install --source http://rubygems.org mustache</code>
  <li><p>Install mustache gem: <code>gem install --source http://rubygems.org mustache</code></p></li>
+
</ol>
+
  
<p>One you have performed those installations you can generate the full specification by running <code>rake</code> in the spec-spec directory. This will product a full html version of the spec, <code>build/spdx-1.0.html</code>, and an rdf owl file containing the spdx ontology, <code>build/spdx-1.0-ont.html</code>.</p>
+
One you have performed those installations you can generate the full specification by running <code>rake</code> in the spec-spec directory. This will product a full html version of the spec, <code>build/spdx-1.0.html</code>, and an rdf owl file containing the spdx ontology, <code>build/spdx-1.0-ont.html</code>.
  
<p>If you have any issues getting up and running let us know and we'll get your issue sorted out.</p><p>&nbsp;</p><p>&lt;kes&gt; 20110516 - missing how to get contribution sent back - not ready for general usage.</p>
+
If you have any issues getting up and running let us know and we'll get your issue sorted out.
 +
 
 +
&lt;kes&gt; 20110516 - missing how to get contribution sent back - not ready for general usage.
 +
 
 +
[[Category:Technical]]

Latest revision as of 14:32, 7 March 2013

To make contributions to the spec please follow these steps.

  1. Report the issue. Reporting an issue is a huge contribute. You can stop here and have our gratitude. If you want to try to fix the issue you can follow the steps below.
  2. Clone the repository and setup the build system (see below).
  3. Create a feature branch.
  4. Make your changes on that branch.
  5. Create a proposal linking to the issue and describing your changes. Be sure to attach a patch (and include a link to your branch is if it published anywhere).

Specification development setup

The master source for the specification resides in a git repository hosted at linuxfoundation.org. Anyone can clone a working copy by doing:

   git clone http://git.linuxfoundation.org/spdx-spec.git

The spdx specification build system is based on ruby. The following steps are required to generate the complete version of the specification.

  1. Install Ruby 1.9.2 using the appropriate mechanism for your OS. (Earlier versions of Ruby will probably work but have not been tested.)
  2. Install sqlite3-ruby gem: gem install --source http://rubygems.org sqlite3-ruby --version 1.2.5
  3. Install rdf-context gem: gem install --source http://rubygems.org rdf_context
  4. Install mustache gem: gem install --source http://rubygems.org mustache

One you have performed those installations you can generate the full specification by running rake in the spec-spec directory. This will product a full html version of the spec, build/spdx-1.0.html, and an rdf owl file containing the spdx ontology, build/spdx-1.0-ont.html.

If you have any issues getting up and running let us know and we'll get your issue sorted out.

<kes> 20110516 - missing how to get contribution sent back - not ready for general usage.