This section is where you can contribute to the development of the specification. To learn how to participate and get signed up for an account and the mailing list, click on the Getting Started link below.
Here are some instructions for using the SPDX wiki. Every user who is logged into spdx.org can modify wiki pages. At the top of a page, you'll see an "Edit" option. You can then edit the page using the HTML editor. When you save the page, make sure to put in a message in "Log message" briefly explaining the change you've made. Then click on "Save" at the bottom of the page to save or on "Preview" or "Preview changes" to preview before saving.
If a page has been edited more than once, you'll see a "Revisions" link at the top of the page (next to "Edit"). Clicking on this link will allow you to see in detail which changes have been made to the page.
If you want to create a new page, click on "Add child page".
If you want to add a visible comment, please start the comment by indicating the source by your initials, bolded, surrounded by angle brackets. Then put the comment itself in italics. For example: <kes> this is a comment or a question?. The purpose of this is to make sure its clear that this is not part of the official text of the standard at this point, and provides localized context for the discussion.
Attendance: 12
Previous minutes not reviewed
Legal Team Report - Adam
Technical Team Report - Kate
Business Team Report - Scott
Cross Functional Issues – Kirsten
Attendees
Attendance: 11
Meeting lead by Kate Stewart
Attendees
Chuck - Protecode
Michael Herzog - NexB
Pierre La Point NextB
Tom Incorvia - MIcrofocus
Kate Stewart - Canonical
Martin M - HP
Scott -
Mark Gisi - Windriver
Jilyane Lovejoy - Openlogic
Adam Cohn - Cisco
Steve Cropper - Cisco
---
Technical - Kate
• sorting out the usecases/groupings for last 2 meetings
• SPEC 1.1 being readied for wider review.
? Roadmap for 2.0? timing is question, dependency on how
quickly we can gel on targets. hoping for Q4.
? need to tie in to business activities with structure to
capture, and forward looking activities.
Legal Team - Jilayne
• revised license addition process posted for review
• feedback received, URLs to be added.
• reality of situation, encouraging other to check out.
• Getting more documentation/explanation of vision/goals of subgroup.
(see meeting minutes)
• People working on drafts of what legal work group is in charge of.
License list.
• Sense of to do list, what is still outstanding.
• Movement on OSI outstanding issues, clarification.
• License notices - lots of discussion, but no net change.
• Nothing further on templatizing front.
Business Team - Michael
• general topic, product planning and roadmap for SPDX
• combining concepts - validating, compliance, root attribution
information.
• Product Roadmap - 2.0, some vision of what it should be, review of
business team next week.
• Charter - is data exchange, how it is evolving... framework.
• Distinguishing between changes to SPEC and changes to software to
support SPEC. Foster adoption, help folks comply, SPEC and
implementation in software are different. Java community process...
• SPEC and licensing for implementation. Subset of issues change SPEC,
and enable others.
• Framework for discussing different ideas... revision to future plan.
Proposing a simple product management to planning. Constituencies,
coallescing. Purpose of version in business discussion.
• Current, Next, Future - approach. Product management function.
Difference between SPEC and related issues around implementing.
• Wanting to expand out the charter -
Steve/Pierre - Web
• pierre, martin, steve did survey - 30% of content in place, 70%
missing
• link on the front page of new site
• assignments, checked against all of the pages, pages, content added
and missing.
• requested Steve rebroadcast assignment page, mail out to everyone
else.
• Re-attach instruction of .pdf of instructions.
• End of May will be switch over...
• Business team, looking at reallocating page with Kim's name was
beside. Finish up.
• Status on assignments, guidelines to being done.
Martin - Web migration
• Wiki ideas, infrastructure is redundant, web site is maintained by
Martin, want to find better ways
• Good discussion with Ed Warnicke, moving to proper wiki, going to
hosted sites. Move WIKI and make site easier.
• Martin working on plan to do this. Discuss with others after
preliminary sketch - June/July time frame.
• Cost: really low, hosting instances cheap, couple $$ per month?
Steve Cropper - SPDX WEBEX site setup option. Hostids to team members.
Genearal agreement that this is a good direction to investigate, but
Linux system must work with it, or its a non starter. (Steve will get
together with Ed, and investigate if Linux problems can be solved).
Concern expressed desire to have calls recorded for convenience of those
in other timezones, and help with meeting minute writers.
Phil: Can the phone recording option be turned on in future, and
the summaries be made available via the web, as interim until WEBEX
like capabilities can be make available with all participants, still
able to participate.
Attendance: 9
May 3 minutes approved
Legal Team Report - Jilayne
"The SPDX Legal Team supports the SPDX working groups by providing recommendations to the SPDX working groups regarding licensing issues for the specification itself; providing input that will result in increased legal certainty of the licensing attributes of open source projects; maintain the SPDX License List; and to promote the SPDX specification to the legal community at-large."
"The SPDX License List is a list of commonly found open source software licenses for the purposes of being able to easily and efficiently identify such licenses in an SPDX document. The SPDX License List includes a standardized short identifier and full name for each license, as well as other basic information. By providing a short identifier, SPDX creators (as well as others beyond SPDX) can efficiently refer to a license without having to redundantly reproduce the full license. The SPDX website (spdx.org) maintains the full text of each license on the SPDX License List. In keeping with the overall goal of the SPDX project, no interpretation of the licenses has been made and the SPDX Licenses List endeavors to only provide a factual list of licenses and short identifiers that can be consistently relied upon by users of the list."
Business Team Report - Scott/Jack
Technical Team Report - Kate
Cross Functional Issues – Phil
Attendees
There have been multiple discussions in different working groups about the nomenclature, meaning and intent of the package license fields. To ensure we are all on the right page, we want ot have some wiki-based discussion about the fields with perhaps some examples and use cases tha that we can capture for documentation, FAQs, etc. We may need to go thru this same exercise at the file level, but let's start here.
Below is extracted (though for simplicity, not 100% complete) text from the June 5 rev of the spec (http://www.spdx.org/wiki/spdx/specification). Please make comments or ask questions and identify yourself.
4.9 Declared License
4.9.1 Purpose: This field lists the licenses that have been declared by the authors of the package. Any license information that does not originate from the package authors, e.g. license information from a third party repository, should not be included in this field...
4.9.2 Intent: This is simply the license identified in text in the actual package source code files. This field is not intended to capture license information obtained from an external source, such as the package website. Such information can be included in 4.7 Concluded License. This field may have multiple declared licenses, if multiple licenses are declared at the package level...
4.7 Concluded License
4.7.1 Purpose: TThis field contains the license the creator has concluded as governing the package or alternative values, if the governing license cannot be determined...
4.7.2 Intent: Here, the intent is to have the reviewer analyze the license information in package, and other objective information, e.g., COPYING.txt file etc., together with the results from any scanning tools, to arrive at a reasonably objective conclusion as to what license governs the package.
So, what do you think?
Is the distinction clear between the two fields?
Are both useful?
Can you provide examples of where they are useful?
Do you have an example that raises issues?
Milestones for Teams & Events
NOTE: This events including in the Master Schedule are only those that have milestone implications. A more complete list of events can be found here.
|
Month |
Tech |
Biz |
Legal |
Events |
|
Jan |
|
|
Review Terms of Use for SPDX.com |
|
|
Feb |
|
-Feb 3 - Beta Intro Call for Potential Beta Sites -Finalize list of beta participants |
|
|
|
Mar |
Complete Release Candidate for Beta. Preliminary tooling in place. |
-Train Beta Sites |
License Repo in Place for Beta |
|
|
Apr |
|
|
4/7-78 Present at FSFE Legal Network in Amsterdam - Rockett 4/6-8 Tech and Biz Team Meetings at Collab Summit, San Francisco |
|
|
May |
|
-Start Beta Testing |
|
5/16-17 - Mark Radcliffe to discuss SPDX at OSBC, SF |
|
Jun |
|
-Complete Beta Testing |
|
|
|
Jul |
-Finalize spec for 1.0 Final -Final tooling |
-Final user content in place -Launch plan in place |
|
|
|
Aug |
|
-Launch 1.0 Final |
|
8/17-19 Launch at LinuxCon NA - Vancouver |
|
Sep |
|
|
|
|
|
Oct |
|
|
|
|
|
Nov |
|
|
|
|
|
Dec |
|
|
|
|
Scuse the lousy formatting. I'm working on it. Phil
Minutes - 2010/08/11 LinuxCon2010 Boston SPDX BOF
Current status:
- need to focus on goals for next 3 months
- SPDX.org rollout, shadows fossbazaar.org for data.
- mail list transfering to spdx@fossbazaar.org with
self subscription to mail list now possible, and
public archives.
- package-facts@fossbazaar.org now depreciated,
mail list there will remain private, per original
commitment.
Web site overview:
- site design is still evolving, participation welcome.
- log in to comment on wiki etc.
- anyone can blog on site, and postings on topic welcome.
- presentation material available on site for outreach support.
- AI: Phil/Martin - update on participation page where to join
(suggestion was to put link in text, not just at top,
consider "I want to use the spec, vs. I want to contribute
to the spec).
- AI: Kate to transfer document (.pdf) back to WIKI.
- AI: Phil update standard presentation with LinuxCon2010 input
- AI: Kate clean up the sharing analysis to what is accurate
- AI: Kate publish the current version number of the specification
in brackets behind reference.
- License Discussion:
- Look at Fedora's approach as a single page.
Example license text - canonical form.
Good from tooling perspective. Suck info off the pages.
HTML at low technical level is easy. RDF?
- see fedoraproject.org/wiki/License- licenses table.
- Used License Text - uses tag to identify in page
Fedora provide notes, and canonical text.
- For SPDX problem is where store templated version?
Minutes - 2010/08/11 LinuxCon2010 Boston SPDX BOF
Current status:
- need to focus on goals for next 3 months
- SPDX.org rollout, shadows fossbazaar.org for data.
- mail list transfering to spdx@fossbazaar.org with
self subscription to mail list now possible, and
public archives.
- package-facts@fossbazaar.org now depreciated,
mail list there will remain private, per original
commitment.
Web site overview:
- site design is still evolving, participation welcome.
- log in to comment on wiki etc.
- anyone can blog on site, and postings on topic welcome.
- presentation material available on site for outreach support.
- AI: Phil/Martin - update on participation page where to join
(suggestion was to put link in text, not just at top,
consider "I want to use the spec, vs. I want to contribute
to the spec).
- AI: Kate to transfer document (.pdf) back to WIKI.
- AI: Phil update standard presentation with LinuxCon2010 input
- AI: Kate clean up the sharing analysis to what is accurate
- AI: Kate publish the current version number of the specification
in brackets behind reference.
- License Discussion:
- Look at Fedora's approach as a single page.
Example license text - canonical form.
Good from tooling perspective. Suck info off the pages.
HTML at low technical level is easy. RDF?
- see fedoraproject.org/wiki/License- licenses table.
- Used License Text - uses tag to identify in page
Fedora provide notes, and canonical text.
- For SPDX problem is where store templated version?
Suggestion is to use come up with standardized naming
of the sections, and embed the text of the licence
"template" version, so it shows up on the "official"
license page. (example to consider, verify that BSD
hasn't been modified and do it with a template).
- Fields to put on each "web license WIKI page"
- short form name
- long form name
- link to formal license
- notes on license
- full license text
- template version
- Note: need to figure out and document how to add a license
(ie. When you add a license - 1) create separate page;
raw template text, user visible text - here's out how
embed this text. etc.)
- AI: Tom to define a proposal for user front page.
Decide section names to correspond to spec
- AI: Group: discuss further following questions:
- what does it mean to be "on the list" for a license.
- what is it going to take to add and maintain a license.
- Consider when english isn't spoken language?
(what can be translated, what can't, work into template)
- roll out - operational aspects
- what do we want to get accomplished?
- divy out and how get accomplished?
- Target to have spec at 1.0 in 2010Q4
- What are building blocks needed?
Consider: documenting tooling; training; how to use.....
- Strong feeling one shot to get this right, want
free and comercial tool support available for supply chain.
- AI: Kim & John to work on operationalize plan.
(including a date can tell supply chain people?
GOAL is understand a date to have industry
changing/financially impacting. Tie to next LinuxCon??)
of the sections, and embed the text of the licence
"template" version, so it shows up on the "official"
license page. (example to consider, verify that BSD
hasn't been modified and do it with a template).
- Fields to put on each "web license WIKI page"
- short form name
- long form name
- link to formal license
- notes on license
- full license text
- template version
- Note: need to figure out and document how to add a license
(ie. When you add a license - 1) create separate page;
raw template text, user visible text - here's out how
embed this text. etc.)
- AI: Tom to define a proposal for user front page.
Decide section names to correspond to spec
- AI: Group: discuss further following questions:
- what does it mean to be "on the list" for a license.
- what is it going to take to add and maintain a license.
- Consider when english isn't spoken language?
(what can be translated, what can't, work into template)
- roll out - operational aspects
- what do we want to get accomplished?
- divy out and how get accomplished?
- Target to have spec at 1.0 in 2010Q4
- What are building blocks needed?
Consider: documenting tooling; training; how to use.....
- Strong feeling one shot to get this right, want
free and comercial tool support available for supply chain.
- AI: Kim & John to work on operationalize plan.
(including a date can tell supply chain people?
GOAL is understand a date to have industry
changing/financially impacting. Tie to next LinuxCon??)
Agenda
PhilO discussed need for evolving logistics with the group getting larger and including new folks. We're doing away with the "Who just joined?" approach to attendance and will mainly depend on log-ins to Webshare to record attendance. In addition everyone is encouraged to state their name when speaking. There also some discussion (actually it came up towards the end of the meeting) about providing minutes via a link rather than an attached Word doc.
PhilO is updating the presentation to reflect Kate's LinuxCon presentation content.
PhilO reported on LinuxCon. Jim Zemlin's keynote was all about the new Open Compliance Program, and SPDX was prominently featured. SPDX got some good PR out of it and one article said it was the key to the bigger program. Phil Koltun delivered a more detailed session on the OCP and Kate had one on SPDX. Both were well attended. Finally, we had a Birds of a Feature session.
Kudos to Martin for helping PhilO get the new spdx.org launched in time for LinuxCon. There was some discussion about making it more obvious how one joins both the group and the mailing list; it's better to be redundant in order to be more welcoming. There was also a discussion about getting examples up to date and getting the Wiki going again. We finally got into a discussion about hosting code for tools. Possibilities were: SourceForge, GitHub.
PhilO mentioned the JohnE and KimW have been working on a rollout plan, expanding on both out technical efforts and outreach/evangelism efforts. More at the next meeting.
Agenda
Spot was not in attendance, but we reviewed the mock-up. There was fair agreement that its close to what we are looking for (if not "Spot" on)
Our implicit path had tied a fixed license list of licenses to the spec rev, but JohnE put forth an impassioned argument as to why they should be decoupled: Essentially we'll want the license list to change with more frequency than the spec (months vs. years). A new license can't mean a new spec rev. There was much discussion about how to manage the license list.
There was fair agreement just as there is a "playground" for working on the spec and a release process to the current rev, there should be a similar arrangement for licenses (though decoupled) and certainly there should be legal review.
There was not complete agreement about the intended scope of the list, but there was agreement that there needed so be some nomination process and that anyone wishing to add a license must be willing to take on the associated work. BobG is willing to be a contributor. A topic of future discussion is how we will come down on the initial V1.0 list of licenses. These issues in contemplated in the rollout framework that we'll be putting forth.
We reviewed the intent of using RDF and BillS described what's been done with DOAP as a model. Essentially, we're exploring RDF as a reasonable balance between the needs of people being able to view and create SPDX docs, and machines to be able to consume and produce the format.
There was agreement that there is lots of work to be done in this area: defining the syntax, defining web repository of license info, documenting usage, etc. We decided that we need a sub-team to take this on. BillS will coordinate and PeterW, Gary and Kate will participate, as well as others who are interested.
Agenda
PhilO reported that he'd updated the presentation. He's added a slide describing to people why they should participate; he and Kim will update in the context of her OWF presentation.
PhilO reviewed process for new participatns
PhilO walked through changes implemented to make how to participate more obvious. There are pointers to where to sign up and get on the mailing list from every major tab.
Kim described the motivations for, approach to and elements of the rollout that will require work. There's a fair amount to be done, but it is now well framed. There will likely be a different thread of meetings on rollout issues (vs. spec completion) starting after a face to face meeting in mid-November. Some of the areas that need work would benefit from skills from outside the current group, so please think about others in your organization that might help.
We agreed that we should implement an issue tracking system for spec issues. We can use Linux Foundations Bugzilla. Peter Williams agreed to drive and administer with help from Marshall.
New
As there has been a lot of discussion of licenses on the mailing list (decoupling from spec, etc.), we decided to have a separate session dedicated to that discussion. Kate will be hosting on Thurs, Sept 16 at 12:00 EDT (one hour later than our normal.) Invitation and agenda to be sent out early next week.
No changes have been implemented since the beta release as we are working through some formatting issues getting the .pdf back into Wiki form.
Additional Fields: 5.6/5.7 We picked up on the discussion from the maillist of adding 5.6/5.7 fields to the file section which would designate the name and URL of the package from which a file is known to come. There was agreement that we should go ahead with this in concept and that the RDF group would work out the syntax.
Revisit 3.3 To deal with the recursive problem (wanting to include the SPDX file in a package but also wanting it to include a SHA-1 for the package) there has been a proposal based off of the SHA-1s of all the other files in the package. Kate is looking for others interested in this, to brainstorm with as to algorithms to generate this new package level checksum. We got into a discussion of "unique identifier" vs. "validator" and it became clear our nomenclature needs to be cleaned up to indicate that this is a validator and not an identifier. Someone proposed "Package Check Sum" as the name of the field and there was agreement. Kate will clean up the language requested more discussion on the maillist of the technical approach.
Appendices- The RDF group identified the need for an ontology and an XML schema appendix. Place holders for these will be added to the WIKI.
RDF Group
There was a good kickoff meeting last Thursday. Most of the discussion was about approaches and concerns. Both an ontology and a schema are to be the targeted outputs from this subgroup. Bill has since found a collaborative ontology site that will be useful in the development.
Tools & Infrastructure
Linux Foundation has agreed to make the source code revision infrastructure (git based) available to SPDX tools. There will be a meeting next week between Gary, Ibrahim, Kate to discuss the logistics in more details. The first project will be Gary's Pretty Printer (which has components that can be reused in other projects).
Request was made on the list for an issue tracker. Current mechanism is a WIKI, but it was felt something more formal would give us better history. After group discussion and the willingness of Peter to volunteer to adminster it (thanks Peter!), we will be looking at setting up a bugzilla system. Options on where it can be hosted (linux foundation?), will be investigated by Kate. Goal would be that this could be used for the SPDX tools as well.
Agenda
PhilO once again expressed openness to any feedback on the standards slides we should all be using to describe SPDX
PhilR lead a discussion about future events we should be getting on the list. He will be updating. All are encouraged to crowdsource this list.
Website is still developing and PhilO is open to feedback.
PhilO summarized the need for a roll out plan. Kim emphasized that we are looking for volunteers from the group and our respective organizations. A face to face meeting will be scheduled for Nov 16/17, with location to be determined based on who is coming.
Rockett summarized a call with Linux Foundation legal group, the Member Counsel. (Kim, Kate, JohnE and PhilO also participated.) The Member Council has been aware of standardization efforts for a couple of year and this call was to provide status. A number of the participants were new to the MC, so it was important to get them up to speed. They encouraged us to provide them with an example.
New
Formatting difficulties have slowed getting the spec back in the Wiki. That's in process. Kate will add 5.6/5.7.
Work group is in process defining the ontology. Using knodle site: http://knoodl.com/ui/groups/SPDX/vocab/SPDX(dev-only);jsessionid=16BABC384D81ECF9EC6DC52C93977C3E
Participating are Bill, Kate, Gary, Peter, Jeff, Ed, Kyle (from Canonical), Pierre. Bruno and Marshall have been monitoring as well. We discussed using DOAP (description of a project) as a way to extend SPDX capability.
LF is willing to host Bugzilla (as well as code). No one in the group saw any problem with going ahead. Kate, Bill and Peter are open to input for defining the hierarchy.
We discussed the call (Friday, Sept 24) dedicated to the big picture license discussion. Decoupling versioning from spec versioning, process for including new licenses, list for version 1, etc.
DRAFT
Agenda
ACTION ITEMS
New - See notes in above minutes.
Minutes
Action Items
Note: Drafting related action items are embedded in the Wiki. http://www.spdx.org/wiki/spdx/specification
• Dave - Clean up the WIKI to only have analysis visible that reflects current spec. ON HOLD FOR MARTIN TO PROVIDE PRIVS; SHOULD BE UNDERWAY
• Dave/JeffL - Update zlib based on new specification DONE, BUT AWAITING FEEDBACK
• Peter - Mail out competing proposals for 5.6/5.7 DONE
• PeterW- Implement issue tracking system. BLOCKED ON KATE
• Kate - submit ids to Linux Foundation so infrastructure setup can proceed - PENDING
• Kate- Draft example for LF Member Counsel; include XML and corresponding spreadsheet (or spreadsheet-like) format. PENDING
• Kim - list of questions from Open World Forum to form start of FAQ - pending - will send mail to list with questions remembered, request Phillipe O, add comments. DONE
• Phil R - Update Industry Events. IN PROCESS
• Kate - 10/14 minutes to be added to WIKI for review. - DONE
• Bill S - Send Martin some examples of issue posting HTML. DONE
• Rockett- Mail out trademark policy draft to SPDX list. WAITING FOR SIGNOFF BY LF
• Rockett- Query status of trademark application TBD
• Kim- Update of plans for Face to Face DONE
• Kim- Send out invite for next licensing meeting. DONE. WILL INCLUDE FOLKS FROM DEBIAN.
• All- Review 6 months mail and contrast against licensing group spreadsheet. FOR NEXT LICENSE GRP MEETING
• All- If you can't attend meeting, post feedback/vote to list on 5.6/5.7 proposals. FOR TECH AGENDA NXT MTG.
• Kate- Write up formal proposal on SHA field change and mail to list. IN PROCESS
• All- Review SHA field change proposal for technical flaws; if so, discuss on list. FOR TECH AGENDA NXT MEETING
• Kate- Add back to SPEC page in WIKI preferred syntax for adding comments. TBD
Minutes
Action Items
Note: Drafting related action items are embedded in the Wiki. http://www.spdx.org/wiki/spdx/specification
• Dave - Clean up the WIKI to only have analysis visible that reflects current spec. DONE
• Dave/JeffL - Update zlib based on new specification DONE, BUT AWAITING FEEDBACK FROM GARY
• PeterW- Implement issue tracking system. BLOCKED ON KATE
• Kate - submit ids to Linux Foundation so infrastructure setup can proceed - PENDING
• Kate- Draft example for LF Member Counsel; include XML and corresponding spreadsheet (or spreadsheet-like) format. PENDING
• Phil R - Update Industry Events. DONE
• Rockett- Mail out trademark policy draft to SPDX list. DONE.
• Rockett- Query status of trademark application DONE. APPLICATION IS IN AN WAITING FOR ASSIGNMENT OF A TM EXAMINER
• All- Review 6 months mail and contrast against licensing group spreadsheet. FOR NEXT LICENSE GRP MEETING
• All- If you can't attend meeting, post feedback/vote to list on 5.6/5.7 proposals. DONE
• Kate- Write up formal proposal on SHA field change and mail to list. IN PROCESS
• All- Review SHA field change proposal for technical flaws; if so, discuss on list. FOR TECH AGENDA NXT MEETING
• Kate- Add back to SPEC page in WIKI preferred syntax for adding comments. TO BE DONE
• Michael H- Write up and share position on "reporting" vs. "interpreting."
• PhilO- Get legal team input on Michael's position.
Administrative
Technical Team Report
Business Team Report
Legal Team Report
Cross Functional Issues
Action Items
Attendees
Administrative
Technical Team Report
Business Team Report
Legal Team Report
Cross Functional Issues
Action Items
Attendees
Attendance: 16+
NOTE: I believe many folks joined whose names I did not capture. Let me know if your name is not here, and I'll be happy to add it.
Technical Team Report - Kate
Business Team Report - Kim
Legal Team Report - Rockett
Open Action Items
Attendees
2011/2/10 General Meeting Minutes
Administrative
Technical Team Report
Business Team Report
Legal Team Report
Cross Functional Issues
Action Items
Attendees
Administrative Agenda
Attendance: 9
Minutes from http://www.spdx.org/wiki/2011210-general-meeting-minutes - approved
Technical Team Report - Kate
Mid March is now target for spreadsheet in draft form, with spec that correlates to spreadsheet.
Business Team Report - Kim
Legal Team Report - Rockett
Other
Cross Functional Issues – Kate (for Phil)
Action Items
Most of the action items belong with the Teams. So, in addition to statusing, we will dispatch them to the respective teams and will not continue to track in this meeting. Action items for this meeting will be cross functional.
• Kate/Kim- Draft example for LF Member Counsel; include XML and spreadsheet. PENDING
• MichaelH/Rockett- Write up and share postion on "reporting" vs. "interpreting. PENDING
• MartinM- Report back on # of people on respective mailing lists. DONE, BUT LET'S KEEP UPDATING
• Kim/Kate- Provide PhilK with paragraph descriptions of Collab Summit sessions by 2/17
New Actions:
We need to capture a list of who will be at face to face meeting - each of the work groups to
Attendees
Administrative Agenda
Attendance: 11
Minutes from http://www.spdx.org/wiki/2011224-general-meeting-minutes - acceptance deferred
Technical Team Report - Kate
Still working through RDF issues/model and spreadsheet to resolve naming, and with a focus on:
Business Team Report
Kim was traveling. No update from Business Team at this time.
Legal Team Report - Rockett
Cross Functional Issues – Kate (for Phil)
Action Items
Most of the action items belong with the Teams. So, in addition to statusing, we will dispatch them to the respective teams and will not continue to track in this meeting. Action items for this meeting will be cross functional.
• Kate/Kim- Draft example for LF Member Counsel; include XML and spreadsheet. PENDING
• MichaelH/Rockett- Write up and share postion on "reporting" vs. "interpreting. CLOSED
• MartinM- Report back on # of people on respective mailing lists. DONE, BUT LET'S KEEP UPDATING
Phil O. - Capture a list of who will be at face to face meeting - PENDING
Attendees
Administrative Agenda
Attendance: 15
Minutes accepted http://www.spdx.org/wiki/20110224-general-meeting-minutes
http://www.spdx.org/wiki/20110311-general-meeting-minutes
Technical Team Report - Kate
After a great deal of effort, the team has converged on a consistent set of field names which will by synch'ed with all forms of spec shortly.
There are still a couple of areas of open issues which are dependent on the Legal Team, most having to do with who created the SPDX file.
Kate will be starting up a wiki page with an agenda for the upcoming Face to Face; participants should feel free to provide input.
Business Team Report - Phil
Beta training materials are not complete, but are in motion and should be fine for beta.
In the last meeting there was a lot of discussion about a process for requesting/evaluating/adding new licenses to the standard list. See last Business Team meeting's minutes for details.
Legal Team Report - Rockett
SPDX Tool/Template Licensing- Done, we'll be using Apache 2.0
Metadata Licensing
Templatizing (defining what insubstantial variants are OK for a match to a standard license)
Cross Functional Issues – Phil
Collaboration Summit
Discussion about how to handle "Newbee" question that come in on lists
Action Items
Most of the action items belong with the Teams. So, in addition to statusing, we will dispatch them to the respective teams and will not continue to track in this meeting. Action items for this meeting will be cross functional.
• Kate- Beta collateral: Examples in XML and spreadsheet form. PENDING
• MartinM- Report back on # of people on respective mailing lists. ONGOING
Phil O. - Capture a list of who will be at face to face meeting - DONE
Attendees
SPDX General Meeting minutes from 4/21/2011
Attendance: 10
Minutes accepted
http://www.spdx.org/wiki/20110324-general-meeting-minutes
Technical Team Report - Kate
Team is recovering from specification review held at the Linux Collaboration Summit face-to-face meeting.
An initial revised draft (PDF) incorporating first round of feedback, dated 20110411, is posted here: http://spdx.org/wiki/spdx/specification
Team is working through discrepancies and adding examples for RDF
It's still possible to have the tools complete (alpha quality) by the end of April, or within one week of beta spec being finalized.
Requested feedback from legal team on web page location (URI) for special terms such as UNDETERMINED.
Business Team Report - Kim
Coordinators have been identified for the 3 beta pairs. Kick off calls planned for early May (likely 2nd week).
Training materials in progress and will be finalized once beta spec is final.
Three new discussion/action threads were identified at the Linux Collaboration Summit face-to-face
Legal Team Report - Rockett
2 active discussions continue: metadata licensing and how to handle id'ing author/reviewer
Metadata Licensing: Stil active discussion delving in aspects of:
How to handle id'ing authors/reviewers
Related: Trying to determine beta approach for audit / revision history
Action Items
Most of the action items belong with the Teams. So, in addition to statusing, we will dispatch them to the respective teams and will not continue to track in this meeting. Action items for this meeting will be cross functional.
Attendees
Administrative Agenda
Attendance: 15
Minutes accepted
Technical Team Report - Bill
Good Progress
One specific blocking item/for spec and tools. The issue is has to do with set of terms to describe situation where a concluded license is not named. Team had been working with terms such as: None, No Assertion, Not Analyzed, Blank. They are working on a final proposal but are leaning towards two values one indcating that there has been a conclusion that there is no license and one indicating that there is no conclusion one way or the other.
Team is asking for some ratification from the legal team, but proceeding on the two value path.
Business Team Report - Kim
Beta kickoffs are scheduled.
Final field names are getting merged into the training and tool docs by Kim and Kirsten resepctively.
Legal Team Report - Rockett
Metadata licensing issue still under discussion
Team is reviewing the need for including change tracking of SPDX docs in the spec. This will not hold up the beta. There was a discussion about how major a requirement this would be, i.e. would it necessarily hold up V1.0 past LinuxCon in August. The general sense from members of the Tech Team (which has been contemplating the issue) was that it would not by itself.
Cross Functional Issues – Phil
Website: A workign group of Kirsten, Pierre and Steve have been reviewing the website for usability. They are recommending the "three big buttons" approach to the home page for folks who are:
Their other major recommendation was to have drop down menus to give more visibility into the various sections of the website from the home page.
There was lots of spirited discussion and opinions, but general agreement on the direction.
The team will be developing and circulating mockups for subsequent feedback.
Action Items
• MartinM- Report back on # of people on respective mailing lists. ONGOING
Attendees
Administrative Agenda
Attendance: 14
Minutes accepted
Technical Team Report - Kate
New version up with RDF vocabulary appendix. Please review
Tools are keeping up. Only one known oustanding issue at this point.
Legal Team Report - Rockett
License State Discussion
Going through latest spec versionLicensing of Metadata
Business Team Report
Abreviated as Kim was unavailable
Cross Functional Issues – Phil
Brief statuse on website. Team is working on a story board
OSBC report- No formal presentation, but mentioned on a panel with very positive reception
Action Items
New
Attendees
Attendance: 13
Minutes for 20110519 approved
Technical Team Report - Gary
Business Team Report - Kim
Legal Team Report - Rockett
Cross Functional Issues – Discussion
Open Action Items
Closed Action Items
Attendees
Attendance: 11
Minutes for 20110602 approved
Technical Team Report - Kate
Business Team Report - Kim
Legal Team Report - In absentia
Cross Functional Issues – Discussion
Open Action Items
Attendees
Administrative
Technical Team Report
Business Team Report
Legal Team Report
Cross Functional Issues
Action Items
Attendees
Administrative
Technical Team Report
Business Team Report
Legal Team Report (From PhilO/Jilayne in Rockett's absence)
Cross Functional Issues
Action Items
Attendees
Attendance: 7
Technical Team Report - Kate
Business Team Report - Michael Herzog (in Kim's absence)
Legal Team Report - Jilayne (in Rockett's absence)
Cross Functional Issues – Phil
Open Action Items
Attendees
Attendance: 12
Dec1 Minutes Approved
Technical Team Report - Kate
Business Team Report - Kim
Legal Team Report - Adam/Jilayne (in Rockett's absence)
Cross Functional Issues – Phil
Open Action Items
Attendees
Attendance: 12
Minutes for 20110616 approved
Technical Team Report - Kate
Business Team Report - Kim
Legal Team Report - Rockett
Cross Functional Issues – Discussion
Open Action Items
Attendees
Attendance: 10
Minutes for 20110630 approved
Technical Team Report - Kate
Business Team Report - Kim
Legal Team Report - Rockett
Cross Functional Issues – Discussion
Open Action Items
Attendees
Attendees
Legal Update from Jilayne
Tech Team Update from Gary
Biz team update from Kim
Attendance: 9
Minutes for 2011/12/15 approved
Technical Team Report - Gary
Business Team Report - Kim
Legal Team Report - Jilayne
Cross Functional Issues – Phil
Open Action Items
Attendees
Attendance: 10
Minutes for 2011/1/26 approved
Technical Team Report - Gary
Business Team Report - Kim
Legal Team Report - Jilayne
Cross Functional Issues – Phil
Attendees
Attendance: 10
Minutes for 2011/2/9 approved
Technical Team Report - Kate
Business Team Report - Kim
Legal Team Report - Jilayne
Cross Functional Issues – Phil
Attendees
Attendance: 10
Minutes for 2011/2/23 approved
Technical Team Report - Kate
Business Team Report - Phil (written input from Kim)
Legal Team Report - Jilayne
Cross Functional Issues – Phil
Attendees
This is the working area for the technical team. This team has primary responsibility for drafting the specification and developing documentation, templates, samples and tools.
You can sign up for the mailing list here.
You can register concerns, comment or issues with the spec in our issue tracking system. To see a list of all outstanding issues see our issues list
A repository containing the source for tools can be found at http://git.spdx.org/.
The technical team meets weekly on Tuesdays at 19:00 GMT (11:00AM Pacific Time, 1:00 PM Central, 2:00 PM Eastern Time).
(note the time change, starting with 8/30/2011)
Toll-free dial-in number (U.S. and Canada): (877) 435-0230
International dial-in number: (253) 336-6732
Conference code: 7833942033.
URL: http://blackducksoftware.na6.acrobat.com/spdxrdf/
-------------------------------------------------------------------------------
The Technical team is contributing to the draft FAQ, which you can find here: Draft SPDX use FAQ
This the working version of the SPDX specification.
The license list used by SPDX is available too, as are the RDF references.
Added bug id's to version #14 for all P1 bugs, so now version 15 is current.
Version 14 is updated to be current with the draft spec as of the start of the face to face meeting.
Areas of spreadsheet still under discussion are:
?.? spds:Tool (class) - when is this proposed to be used?
? web page for standard licenses
Adopted proposals
Rejected proposals
Drafts
Below is a class diagram merging Ed Warnicke's proposed SPDX Element model with the 1.0 model. Definately a work in progress. Most of the class definitions can be found in the 1.0 spec in the RDF appendix (model) or in Ed's proposal (http://spdx.org/wiki/rough-proposal-hierarchy-signing-and-supply-chain-friendliness-spdx-20).
The goals of this proposal are to:
- Support the use cases for the 1.0 spec
- Support the supply chain use cases
- Support the "hierarchical" or embedded package use cases
- Provide a more abstract model which can simplify the application of SPDX to some of the more complex use cases
This proposal extends the existing proposals by adding an SPDX Element Relationship which describes the type of relationship from one SPDX element to another.
See the attached document for the mapping between the SPDX 1.0 properties and this proposal.
See the attached document for a proposal on creating RDF references to other Licensable documents which can be verified through checksums.

Draft
In order to facilitate the delivery of multiple SPDX Data Files (and possiblye SPDX Data Signature Files ) we need some standard way of grouping them together for simple transport and delivery.
Modify the spec to state that
$ unzip -l example.spdx.zip
Archive: example.spdx.zip
Length Date Time Name
-------- ---- ---- ----
0 03-11-12 20:18 example.spdx
0 03-11-12 20:18 example.spdx.sign
-------- -------
0 2 files
$ unzip -l example2.spdx.zip
Archive: example2.spdx.zip
Length Date Time Name
-------- ---- ---- ----
0 03-11-12 20:18 example.spdx
0 03-11-12 20:18 example.spdx.sign
0 03-11-12 20:21 example2.spdx
0 03-11-12 20:21 example2.spdx.sign
-------- -------
0 4 files
Resulting <filename>.spdx.zip files will not be backward compatible with SPDX 1.0 tooling. However, the SPDX Data Files they contain can be, and can be easily extracted by ubiquitously available tools and libaries are virtually every platform and in virtually every programming language.
Draft
To correctly fulfill the terms of some licenses you must know who the licensor is. Currently SPDX has no way to represent this in the situation where there are multiple licenses.
Modify the spec in the following ways
Introduce a LicenseDeclaration entity type. Any number of instances of this type of entity would be allowing in an SPDX dataset.
A LicenseDeclaration entity would have zero or more licensor properties whose values are Agents.
A LicenseDeclaration entity would have exactly one licensing property whose values is a AnyLicenseInfo.
A LicenseDeclaration entity would have zero or more declarer properties whose values are Agents.
Allow the value of the licenseConcluded property to be a LicenseDeclaration in addition to the currently allowed AnyLicenseInfo.
Currently there is no way track relationships between SPDX datasets.
For example, PostgreSQL project is most licensed under an MIT like license but has some code in the contrib directory which is GPL. If i want a PostgreSQL without any GPL obligations i can simply build it without the contrib directory. I can start with publicly available SPDX dataset for PostgreSQL, remove all files in the contrib directory from the dataset and save it as the SPDX dataset for my PostgreSQL w/o GPL project.
If i do this there is no way for someone else to know that my SPDX data is derived from the public PostgreSQL SPDX data. If any issues are found in the public SPDX data they might effect my SPDX data also. Or if someone found problems in my SPDX data it would be useful to track that issue back to the original source and fix it there.
Add an optional property to SpdxDocument which would specify another SpdxDocument from which it was derived. The isVersionOf property in the Dublin Core vocabulary is widely used and has the correct semantics.
<http://example.com/spdx/postgresql-sans-contrib-9.1.2> a :SpdxDocument;
dc:isVersionOf <http://postgresql.org/spdx/9.1.2>; :describesPackage ... .
IsVersionOf: http://postgresql.org/spdx/9.1.2
The addition of this property would allow the history a particular SPDX dataset to be determined by following the isVersionOf properties of each SpdxDocument. Differences between any two SpdxDocuments could be determined by comparing the two dataset.
This change is fully backwards compatible for consumers that ignore properties they do not understand.
Draft
Currently there is no way to be sure that an SPDX file has not been modified by a third party after it was produced. See also, issue 980.
Modify the spec to state that allow SPDX producers may cryptographically sign SPDX files using the PGP clear text signature format. This format embeds a clear text version of the file to be signed inside of a text based wrapper which contains the cryptographic signature. SPDX consumers must accept signed SPDX files, but would not be required to authenticate any signatures. SPDX producers would have the option of signing SPDX files but would not be required to do so.
SPDXVersion: SPDX-1.0
DataLicense: PDDL-1.0
Creator: Person: Peter Williams
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
SPDXVersion: SPDX-1.0
DataLicense: PDDL-1.0
Creator: Person: Peter Williams
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (Darwin)
iQEcBAEBAgAGBQJPVZO9AAoJENTSLvN5TFz940UH/j2/dys3uK6VTqnNBi/yQQxQ
sp/+wBhJThQ4qzph2Zy4pmpjX4u9iwuaIvkOigYp/XR8sdJExQSSSxLxgkfPokRG
4dN8YRZyQ3fTVuCz5DPas9B4NCcZTn77nB8Gas4wzyli7Pqu3YKfq81sfIyxnC+G
/LIMidJ6JD9mvcLmgsbz5zDwmEFnafXcgocK0d9Fbhvx6MKPK7dFxdQ9oN1lV9Ej
hED+wpGIQSSdSJBc2udKAxPZHFQxOTHHr8flxC6bzq01xyjm0W2hDDd0jKRN/cqZ
o10Une5wEO/p7UqFDoNh++kLJeODJ2ZKLr4qwrGXODKLDd5F8ZdDB8deuIb/7RM=
=jdOZ
-----END PGP SIGNATURE-----
$ gpg --clearsign sample.spdx
Embedding the signature in the the SPDX file has several advantages. The combination of the data and its signature reduce the possibility that the two will be accidentally separated as the SPDX data is passed from person to person. Such a separation could happen if an SPDX signature file is simply forgotten, or it could happen very easily if the name of an SPDX file ever needs to be changed. Having that data together will also make tooling easier to build because finding the signature data will be less error prone. Embedding the signature prevents large classes of mistakes from occurring and as such removes the need to cope with them.
This proposal will produce files that are not backwards compatible. Specifically a signed filed will not be readable by SPDX-1.0 compliant consumers. However, files produced by SPDX-1.0 compliant tools will continue to be valid SPDX files and tools that support signing, as described above, will be able to consume SPDX-1.0 files with no changes.
Draft
Currently there is no way to be sure that an SPDX file has not been modified by a third party after it was produced. See also, issue 980.
Modify the spec to state that
SPDXVersion: SPDX-1.0 DataLicense: PDDL-1.0 Creator: Person: Ed Warnicke
-----BEGIN PGP SIGNATURE----- Version: GnuPG/MacGPG2 v2.0.17 (Darwin) Comment: GPGTools - http://gpgtools.org iEYEABECAAYFAk9WSn0ACgkQpqzn7Jq4hlCfYACbBelTUtjOGAYrSBXEODD9Ukpo vuAAn2gLkGsGOntkUTERnISOyOoBJxlT =JxE7 -----END PGP SIGNATURE-----
$ gpg --armor --output example.spdx.sign --detach-sig example.spdx
Detaching the signature in the SPDX file has several advantages.
Detaching the signature in the SPDX file could lead to
This proposal will produce files that are trivially backwards compatible. Specifically a signed filed will be readable by SPDX-1.0 compliant consumers and any tool capable of reading it's underlying encoding format (RDF, XML, Tag). By making the issue of signing orthogonal, we maintain separation of concerns.
This page contains the latest version of the SPDX RDF vocabulary in various formats. These are not considered stable at this time.
This document is under revision control at http://git.spdx.org/spdx-spec.git.
The HTML version is the authorative version. The other versions are generated from the HTML for your convience.
We have several sources to begin pulling for SPDX Use Cases:
Consumer of the audit:
A vendor wants to embed information about a package in its SPDX file that is not representable using standard SPDX fields (and/or classes).
The person or organization that is producing the SPDX and wish to extend it with non-standard information.
A person, organization or tool that can read and process standard SPDX data but is not aware of the non-standard extensions being used by "SPDX producer".
A person, organization or tool that can read and process the non-standard extensions used by "SPDX producer" as well as standard SPDX data.
An organization that does a lot of compliance work is likely to have a license list already which is a superset of the SPDX license list. Such an organization probably will have policies for how to deal with at least some of these licenses. It is important that organizations be able identify the equivalency of these non-SPDX listed license texts/notices.
Stakeholders and interests
A person or organization which produced the SDPX file and maintains their own license list.
A person, organization or tool which wants to consume SPDX files produced by one or more analyzer. This entity maintains its own license list and policies for those licenses. This license list partially overlaps with each of the Analyzers' license lists. The Consumer maintains mappings between its list and those of the analyzers from which it receives SPDX files.
Main Scenario
Alternate scenario A
Alternate scenario B
Notes: This use case can be viewed as a superset of the application, SDK, distribution, Yocto, etc uses cases where many things are aggregated together. There may be a lot of SPDX documents. Software on Reference Implementations are typically updated and could be posted for download from a website or made accessible though a source code control system. (as examples).
An organization desires to understand the legal obligations associated with their intended use of a software package. To gain insight the organization requests a third party to audit their entire codebase to determine all rights holders and licenses for every file in the codebase.
Main Success Scenario
The spreadsheet template to be used for spreadsheet input can be found attached to this page.
Example of data using this template should be stored under the examples section.
Information on the tool used to convert to/from this can be found in the Tools Sandbox
Known Issues with the current version of the template:
- 20110325 - still pending resolution from legal team on whether analysis information section will have a data license.
New versions of examples are to be added here:
Older versions (and stale) of examples can be found:
Attaching spdxOWL2.txt (renamed to spdx.txt so I could attach to wiki)
Also attached spdx_notionalBillEditRDF.txt (renamed to spdx.txt so I could attach to wiki)
spdx_notionalBillEditRDF.txt validates as RDF against http://www.w3.org/RDF/Validator/ and is meant to have one of each 'tag' in the spec, according to the ontology spdxOWL2.txt
Here are some examples generated by OpenLogic. The are comformant to the 1.0 beta version of the spec.
The resulting files are well-formed RDF. However the graph they produce when parsed as RDF is total gibberish. It appears to be impossible to create a document that both matches the current spec and produces a meaningful RDF graph.
The OpenLogic License Analysis system uses SHA-256 to produce checksums of files. We replaced the SHA1 tag with SHA256 to indicate this.
The following use case is presented to help evaluate the SPDX Proposal, DRAFT 20100308. It presents a typical ecosystem, discusses the flow of a facts file within it and the offers some observations. In a future revision, it will be expanded to map the files and other information to the specific fields in a Package Facts File.
In this use case there are six entities each of which plays a different role. The project, names and names of individuals are fictional but based on a real open source project and ecosystem.
[Editorial Note: This Independent Auditor could be a different organization for Company A and B. Also, it is fair to say that this could be two entities? One is an auditing firm and the other a tools vendor. I have combined the two but it can be broken out. ]
Library A Project -> The Project -> Company A -> Company B-> Consumer
Library A Library A Library A’ Library A’
Library B Library B’ Library B’’
Tool Tool
| | ^ ^
| | | |
------------------------------------------------------------
|
Independent Auditor
The files which make up Library A are described in the table below.
|
File |
Copyright in the file |
License Text in the file |
Exception |
|
a1.c |
Josh Brown |
See Exception 1 |
|
|
a2.c |
Josh Brown |
See Exception 1 |
|
|
a3.c |
Josh Brown |
See Exception 1 |
|
|
a4.c |
Josh Brown |
See Exception 1 |
|
|
Makefile |
None specified |
None specified |
None specified |
|
testdata.txt |
None specified |
None specified |
None specified |
|
readme |
None specified |
None specified |
None specified |
|
Package Facts |
Josh Brown |
None specified |
None specified |
Exception 1 – This is part of each BSD license header and reads
“The license and distribution terms for any publically available
version or derivative of this code cannot be changed. i.e. this
code cannot simply be copied and put under another distribution
license including the GNU Public License.”
[Editorial note: okay we can question why they did not automate the generation of the facts from Library A but it’s more interesting that they did not and there are likely many scenarios where facts will be re-used].
Library B and the Tool contain the following source files.
Library B Source Files (sampling for illustrative purposes)
|
File |
Copyright in the file |
License Text in the file |
Exception |
|
b1.c |
A. Glass, Company C |
None specified |
|
|
b2.c |
I. Will |
None specified |
|
|
b3.c |
T. Brown |
None specified |
|
|
Makefile |
None specified |
None specified |
None specified |
|
script |
None specified |
None specified |
None specified |
|
readme |
None specified |
None specified |
None specified |
|
NOTICE |
Apache Software Foundation, A. Glass, Company C, I. Will, T. Brown |
None specified |
None specified |
|
Package Facts |
The Project |
None specified |
Tools Source Files (sampling for illustrative purposes)
|
File |
Copyright in the file |
License Text in the file |
Exception |
|
Tool1.c |
Many |
None specified |
|
|
Tool2.c |
Many |
None specified |
|
|
Makefile |
None specified |
None specified |
None specified |
|
readme |
None specified |
None specified |
None specified |
|
Binary data File |
None specified |
None specified |
None specified |
|
doc.html |
The Project |
None specified |
|
|
NOTICE |
Many |
None Specified |
None specified |
|
Package Facts |
Josh Brown |
None specified |
The files which now make up Library A are described in the table below.
|
File |
Copyright in the file |
License Text in the file |
Exception |
|
a1.c |
Josh Brown, Company A |
See Exception 1 |
|
|
a2.c |
Josh Brown |
See Exception 1 |
|
|
a3.c |
Josh Brown |
See Exception 1 |
|
|
a4.c |
Josh Brown, Company A |
See Exception 1 |
|
|
Makefile |
None specified |
None specified |
None specified |
|
testdata.txt |
None specified |
None specified |
None specified |
|
readme |
None specified |
None specified |
None specified |
|
Package Facts |
Josh Brown, Company A |
None specified |
None specified |
The files which now make up Library B Source Files (sampling for illustrative purposes)
|
File |
Copyright in the file |
License Text in the file |
Exception |
|
b1.c |
A. Glass, Company C |
None specified |
|
|
b2.c |
I. Will, Company A |
None specified |
|
|
b3.c |
T. Brown |
None specified |
|
|
Makefile |
None specified |
None specified |
None specified |
|
script |
None specified |
None specified |
None specified |
|
readme |
None specified |
None specified |
None specified |
|
NOTICE |
Apache Software Foundation, A. Glass, Company C, I. Will, T. Brown, Company A |
None specified |
None specified |
|
Package Facts |
The Project, Company A |
None specified |
[Editorial Note: Company B was not shown modifying the Facts Files and passing on to the consumer. They certainly could have done that though.]
[Editorial Note: This section of the document is for use in analysis of the use case.]
The flow of the Fact files and who modified them, according to the example above, is shown by the table below.
|
Package Fact |
Library A Project |
The Project |
Company A |
Company B |
Independent Auditor |
|
Library A |
Original |
Re-conveys |
Modifies |
Modifies, Consumes or Re-conveys |
Modifies version in source it examines |
|
Library B |
N/A |
Original |
Modifies |
Modifies, Consumes or Re-conveys |
Modifies version in source it examines |
|
Tool |
N/A |
Original |
Re-conveys |
Modifies, Consumes or Re-conveys |
Modifies version in source it examines |
In some of the observations below, a best practice is recommended. I think it is a good idea for the proposal to contain them (even in a separate document). Listing best practices will help to clarify expected behavior which can not be captured in the facts fields alone and should help to create fewer variations on a theme.
In this use case, the Package Facts travelled with the Package vs. being centralized in one location. While the current proposal does not preclude either approach it would seem useful to examine both as each has advantages and disadvantages and may affect the types of fields we need in the proposal. I am thinking the options could be something like: Facts follow a Package, Centralized but the distributor of a Package posts the Facts file for all to see (and comment or possibly update), Centralized but a common entity posts the facts files for all to see (and comment or possibly update). There may be more variations. This is a good area for someone to do an analysis with the pros and cons.
When I asked about the use case one of the responses was how would this information be collected and put into a facts file. It is a fair question but I think the answer would be that one size does not fit all. Instead I propose we re-focus the question and look at the “facts” that we convey and make sure that we allow for the maximum opportunity to automate the their generation (for example, if it were me I would put some doxygen keywords in the source files and call it a day). Information used for the facts like copyright holders for a file may change frequently for very active projects. Without the opportunity to automate I believe larger projects will die under the weight of this and that the information will not be as accurate due to the number of files, etc that need to be documented.
Should the information in a facts file be taken at face value or does the receiver need to decode the package and double check it? If you have to re-decode the entire package I am not sure of the value of a facts value (this should help entities receiving the Package to better understand it is licensing). This level of “reliability” is a key point and may not entirely emerge until the standard matures but we should be cognizant of it and make sure that we do not over specify things (i.e. keep it simple). That said it is fair to dig further if something does not seem right.
What if the facts file from a project is incorrect? This could range from minor typos, to missing file declarations, etc. It is entirely possible that in the course of someone analyzing the files they find some of these things. What should they do at that point? Do they correct it; do they place something in the Independent Audit block? We should specify the behavior or maybe a best practice. The value of this is especially important as we mature the standard so having expectations would be a good thing.
There is currently no way to capture the exception for Library A in the facts file. It is possible it will be listed as a unique license in which case Company A or any of the downstream recipients could have gone to the source file but then I think we are assuming people will get the license field right for the way we intended it to be used. If Library A had listed it as BSD this may not have happened?
Would it be useful to have multiple audit blocks in one facts file? What if The Project had audited the Facts and Company A had audited the facts. It would also be useful to see who made what comments and why at each stage.
It would seem that there could be multiple versions of a Facts File for a particular Package and you could even use Facts files to see a history of the Package (assuming we have a way to track that inside). This seems useful for Company A or Company B when doing the analysis as they can see the original file. For example, if Company A did an independent audit of Library A and the Independent Audit Entity did one as well it would be like getting a second opinion on the package which seems useful.
Are Package Facts only created on a formal release a package? If not, what happens if you access the package through a SCCS like GIT or SVN to get the working tip? Would the facts file be completely up to date? Maybe we do not need to worry about this, but I will throw it out there anyway. This could also be handled through some sort of best practice.
Company B wants to create a single attribution document for their release. In this example that is somewhat of a trivial exercise. In reality they need to mash 30-40+ packages in a consumer product of any size. If the various fact files they want to mash are under different and potentially incompatible licenses this may hamper their ability to do so.
In large distributions where some projects assemble other open source it seems reasonable that a package facts would follow the packages they bundle like they did in this example of The Project using the one from Library A. The organization pulling in these packages could mash them in some way but it if they do not, do we want to specify any guidelines on how to communicate how many there are, where they are, etc. We may want to document some best practices along with the proposal so they are easily discoverable, etc.
Geronimo Sample for SPDX
April 14, 2010
This is a sample of what Geronimo would look like under current spec. Note that I have not provided all of the data – since it would be very large, but just some samples so we can see how it looks.
IDENTIFICATION
Version: 1.0
UniqueID: 123456789abcdef
Tool: OSSDeepDiscovery
Tool: FOSSology
Manual: OpenLogic
Reviewed by: Jane Doe
Created: 20100315-HH:MM:SS
Issues
OVERVIEW
Formal Name: Geronimo
Package Identifier: geronimo-jetty6-javaee5-2.1.4-bin.tar.gz
Official Source Location: http://geronimo.apache.org/downloads.html
Declared License: Apache-2.0
Licenses Present:
Academic-2.1
Apache-1.1
Apache-2.0
Bouncy Castle
BSD
BSD (3 clause)
CDDL
CDDL-1.0
CPL-1.0
CDDL or GPL-2.0 with classpath exception
Dojo
JSON
Jtidy
MIT (modern style with sublicense)
Public Domain
Sun Binary Code License for JDK
Sun Community Source License Version 2.3
W3C-Software
Copyright Holder: The Apache Software Foundation
Copyright Holder: The Dojo Foundation
Copyright Date of Package: 2003-2009 (for ASF)
Copyright Date of Package: 2005-2008 (for Dojo)
Issues
DETAILS
File Name:
assemblies/geronimo-boilerplate-minimal/LICENSES.TXT
assemblies/geronimo-boilerplate-minimal/src/main/underlay/var/config/README.TXT
assemblies/geronimo-jetty6-javaee5/LICENSE.txt
assemblies/geronimo-jetty6-minimal/LICENSE.txt
assemblies/geronimo-tomcat6-javaee5/LICENSE.txt
buildsupport/buildsupport-maven-plugin/LICENSE.txt
buildsupport/geronimo-assembly-archetype/LICENSE.txt
plugins/connector/geronimo-connector-builder/src/test/resources/database.rar
etc….
File Type: How do we handle this at directory level where there may be multiple types
License: Apache-2.0
Copyrights: Various??? Do we want to list all of them?
File Name:
buildsupport/car-maven-plugin/src/main/java/org/apache/geronimo/mavenplugins/car/AbstractCarMojo.java!/java.io.BufferedOutputStream
File Type: source
License: Sun Binary Code License for JDK
Copyrights: Sun Microsystems
File Name:
buildsupport/geronimo-maven-plugin/src/main/java/org/apache/geronimo/mavenplugins/geronimo/ServerProxy.java!/javax.management.remote.JMXServiceURL
File Type: source
License: Sun Community Source License Version 2.3
Copyrights: Sun Microsystems
File Name:
buildsupport/car-maven-plugin/src/main/java/org/apache/geronimo/mavenplugins/car/CreatePluginListMojo.java!/org.xml.sax.SAXException
File Type: source
License: Public Domain
Copyrights: ??
File Name:
buildsupport/testsuite-maven-plugin/src/main/java/org/apache/geronimo/mavenplugins/testsuite/ResultsSummaryMojo.java!/org.w3c.dom.Document
File Type: ????
License: W3C
Copyrights: ??
Issues:
Attached is an example of an RDF file for Apache Tomcat section 3 only. Also attached is an example of a DOAP RDF document for the same package.
Handling of Licenses IDs (Short names)
1. Fedora builds versions into the short name, but it is done in a non-standardized way that seems to vary from license to license, eg
2. Debian proposes a standard way – “license name-version”, eg
3. Both Fedora and Debian also use standard way to deal with the “and later” version options by using a “+”, eg
4. Suggested Solution for SPDX
Handling of “standard” exceptions is different
3. Suggested Solution for SPDX
Spaces in short name
3. Suggested Solution for SPDX
Handling of multiple licenses
2. Both Fedora and Debian address the combining of ors and ands.
3. Suggested Solution for SPDX
Handling of license variations
3. Debian
4. Suggested Solution for SPDX
Attached is the RDFToSpreadsheet tool. See the tools documentation http://spdx.org/wiki/draft-spdx-tool-doc-beta for information on usage.
Updated - 5/9/2011 to include the latest spec changes related to NONE and NOASSERTION values
Note: This page will be moved to spdx.org/tools once the tool output has been reviewed.
Attached is the SPDX Viewer application. See the tools documentation http://spdx.org/wiki/draft-spdx-tool-doc-beta for information on usage.
Updated - 5/9/2011 to include the latest spec changes related to NONE and NOASSERTION values.
Note: This page will be moved to spdx.org/tools once the tool output has been reviewed.
Attached is the SpreadsheetToRDF Tool. See the tools documentation http://spdx.org/wiki/draft-spdx-tool-doc-beta for information on usage.
Updated - 5/9/2011 to include the latest spec changes related to NONE and NOASSERTION values
Note: This page will be moved to spdx.org/tools once the tool output has been reviewed.
This is a placeholder for tabling items that are not going to make it into first version but we want to discuss further for subsequent versions of the spec.
A desire has been expressed to be able to have SPDX be capable of expressing
A rough example of this thought is shown in the diagram below, showing how the coreutils package might be represented:

The simple story behind this diagram is this:
Diagram for a Concrete proposal (very very rough) for structure (note, notes that say 'Concrete' or 'Referential' are just indicating an 'or' in the doc structure):

Description of diagram
This can also be visualized with a UMLish diagram:

Mapping SPDX 1.0 Fields to Proposal
| SPDX 1.0 | SPDX 2.0 Proposal | Notes | ||
|---|---|---|---|---|
| Section | Field | Element | Attribute | |
| Document Information | Version | SPDX | Version | |
| Document Information | Data License | TBD | ||
| Creation Information | Creator | Annotation | Creator | |
| Creation Information | Created | Annotation | Date | |
| Creation Information | Comment | Annotation | Comment | |
| Package Information | Formal Name | Concrete Specifier | Name | |
| Package Information | Package Version Information | Concrete Specifier | Version | |
| Package Information | Package File Name | If the SPDX data is outside the package, then this can be specified with a contained SPDX Element with a Referential Specifier, if the SPDX information is inside the package, otherwise this field is undesirable. | ||
| Package Information | Package Supplier | Concrete Specifier | Supplier | |
| Package Information | Package Originator | Note: As the SPDX 2.0 proposal correctly handles the notion of 'things' being repackaged along the way via nesting, this field is no longer necessary. The coreutils.tar.gz upstream is the supplier for coreutils.tar.gz. Someone like Fedora could be the supplier for coreutils.rpm, which would refer to the SPDX data from coreutils.tar.gz. Full provenance abrogates the need for this field. | ||
| Package Information | Package Download Location | TBD | ||
| Package Information | Package Verification Code | SPDX Sig File + Referential Specifier URIChecksum | ||
| Package Information | Package Checksum | TBD | ||
| Package Information | Source Information | Handle as an Annotation | ||
| Package Information | Concluded License | License Data | Note: Concluding a license different than what is declared upstream of you is handled via Annotations | |
| Package Information | All Licenses Information From Files | Handled by SPDX Element Nesting, not even desirable in a world where an upstream consumer may choice to pick some but not all of the contained parts | ||
| Package Information | Declared License | License Data | ||
| Package Information | Comments on License | Handle as an Annotation | ||
| Package Information | Copyright Text | TBD | ||
| Package Information | Package Summary Description | Concrete Specifier | Summary | |
| Package Information | Package Detailed Description | Concrete Specifier | Description | |
| Other License Information Detected | Identifier Assigned | TBE | ||
| Other License Information Detected | Extracted Text | License Data | TBE | |
| File Information | File Name | Referential Specifier | URI | |
| File Information | File Type | TBD | ||
| File Information | File Checksum | Referential Specifier | URIChecksum | |
| File Information | Concluded License | License Data | ||
| File Information | License Information in File | License Data | ||
| File Information | Comment on License | Handled by Annotations | ||
| File Information | Copyright Text | TBD | ||
| File Information | Artifact of Project Name | TBD | ||
| File Information | Artifact of Project Homepage | TBD | ||
| File Information | Artifact of Project URI | TBD | ||
| Review Information | Reviewer | Annotation | Creator | Handled by SPDX nesting and Annotations. |
| Review Information | Review Date | Annotation | Date | Handled by SPDX nesting and Annotations. |
| Review Information | Comments | Annotation | Comment | Handled by SPDX nesting and Annotations. |
Stealing Java's archive URI syntax:
In the java world, they commonly use a URI syntax <archivename>!<filename> to indicate a particular file within an archive, for example foo.tar.gz!bar.c. I suggest we use this (as there are no other widespread alternatives).
Archiving multiple SPDX files:
It may be desirable to archive together multiple SPDX files so that we have full resolvability for a given package. In that case, those should be rolled into a specific archive format (say foo.spdx.zip) with the various spdx files, their sig files, and an index file. The index file should map URIs (as specified the SPDX files) to filenames in the archive (so we can resolve them).
Example:
file://coreutils.tar.gz!coreutils.spdx: file://upstream/coreutils.spdx
file://coreutils.tar.gz!coreutils.spdx.sig file://upstream/coreutils.spdx.sig
Note: We have to also solve the problem here of how to distinguish when two spdx files contain the same URI (say relative to their archives) but they actually need to be resolved to separate files in the rollup, say if both upstream and the rpm (or deb) packager used file://coreutils.spdx
Provenance
It is desirable to be able to know the provenance of SPDX data. This means being able to reliably know who declared what SPDX information when, and where applicable, for what reason.
Components of SPDX Provenance include
SPDX Data Signing
Since SPDX Data can be represented in both RDF and Tag, and since there is no standard mechanism for signing RDF or Tag data as such (as there is in DSig for XML), we are left to fall back to signing the octets of the file containing that SPDX data. This has a few implications:
SPDX files should optionally be signed using RFC 2440 PGP ascii-armored detached signatures.
GPG Example:Sign a file with GPGsjc-vpn2-814:~ hagbard$ gpg --armor --output example.txt.sig --detach-sig example.txt
You need a passphrase to unlock the secret key for user: "Ed Warnicke " 1024-bit DSA key, ID 9AB88650, created 2001-09-09 See signature filesjc-vpn2-814:~ hagbard$ cat example.txt.sig -----BEGIN PGP SIGNATURE----- Version: GnuPG/MacGPG2 v2.0.17 (Darwin) Comment: GPGTools - http://gpgtools.org
iEYEABECAAYFAk9NCpUACgkQpqzn7Jq4hlA3cACfUOxrlkISMjjLELGlLQuNn93h X6wAniliWFVoi7qfRGI79hwdLhajKcdI =0NsF -----END PGP SIGNATURE-----
sjc-vpn2-814:~ hagbard$ gpg --verify example.txt.sig example.txt gpg: Signature made Tue Feb 28 11:10:45 2012 CST using DSA key ID 9AB88650 gpg: Good signature from "Ed Warnicke " gpg: aka "Ed Warnicke " Primary key fingerprint: 0B87 BC4A F6BF F571 FF9B BF51 A6AC E7EC 9AB8 8650 Implementation Notes:
GPG is available for Linux, Mac, and Windows and provides PGP support. PGP support is available via the Legion of the Bouncy Castle in Java, and they provide an example DetachedSignatureProcessor in their openpgp examples section.
Meeting Minutes for the Technical Team are posted here:
2010-11-16 Weekly Technical Team Meeting
Attendees:
Kate Stewart, Bill Schineller, Peter Williams, Gary O'Neall
Topics:
SPDX RDF/Technical meeting Minutes 11/30/2010:
Attendees:
Bill Schineller
Gary O'Neall
Peter Williams
Kate Stewart
zLib example discussion:
Discussion on the whether the SPDX Doc is necessary. Led to a discussion on having the SPDX Doc contain multiple packages which led to a discussion whether we were constraining the model to a flat model. Decided to table the discussion for version 2.
Discussion on the file being associated to a package - Section 5.5 - need to have a property to associate the file with the package. Needed to have the RDF parse properly and to have the graph represent the file relationships properly
Discussion on non-standard licenses - should it be within the package or at the SPDX Doc level.
Three possibilities - "describes license" creates a separate license resource not associated with the SPDX doc or package; a property of the SPDX doc; property of the package
Discussed the pro's and cons of different approaches. Technically, all three approaches are similar in that the non-standard license will only be valid within the specific SPDX doc (and there is only one package per SPDX doc). Several people felt that the non-standard license should be associated with the analysis - perhaps leading to it being associated with the SPDX doc.
Actions:
Gary to writeup a proposal for hasFile belonging to a package (section 5.5)
Peter to write up the alternatives for the non-standard licenses
Kate to write up a proposal for field to be added for the validation of entire package
SPDX Technical Call
12/21/2010
Attendees:
Bill Schineller
Gary O'Neall
Peter Williams
Kate Stewart
Review of previous meetings
RDF to Tag notation - Kate to provide a grammer. Will include the zlib example in the tag/value format
Key discussion point is how the implicit section boundaries will impact forward compatibility (issue 589)
Review of issues recorded in the issue tracking
Issue 590 - How individual files are referenced:
- Discussed use cases for having a unique reference to a file
- Discussed whether we should have a single URL for a file
- Agreed that in the RDF, there needs to be a single URI (whether created by conventions or auto
generated in rdf/xml)
- Discussed an approach we feel will have merit where the tag/value format has 2 tags for a file
(package + file) and we have some documented conventions for converting between these 2 tags and the RDF
file URI
- We can use the example created for the tag notation to solidify the proposal
Discussion on the repository
- git repositories have been setup - the ontology
- Master will be the official version of the spec
- Proposal to have a post-commit rake task create the ontology
Need the appendices added to the git repository
Peter will send out an email on how to pull down the spdx-spec from the git repo
All - review the spdx-spec and document any questions/issues
SPDX Technical Call
1/11/2011
Attendees:
Bill Schineller
Gary O'Neall
Peter Williams
Kate Stewart
Ann Thornton
Agenda:
- Infrastructure status
- Differentiation a judgment from a fact
- Model for representing a judgment
- DEP 5
Infrastructure status:
- Git up and running for both SPDX spec and pretty printer
- Bugzilla up and running
Request to integrate SPDX mailing list with Bugzilla
Some concern about keeping too much of the comments in Bugzilla if replies to email are added to the
bugs - will pick discussion after we find out if the David can set this up (Peter already sent in the
request)
Should have the default cc on the Bugzilla notifications be the SPDX mailing list
Discussion on posting information to the larger SPDX distribution list
Bill will send meeting announcements to the larger general distribution list
Differentiating judgment from fact
- discussion (not all details not captured)
- agree that when something is stated in a file, it is a fact the file contains that statement
- discussion on whether conclusions from various stated licenses are also facts or judgments
- different interpretation what the file level license represents - the declared license or the inferred
license
- agree file level would distinguish inferred, and detected license
- add a reason to the inferred license. Proposal is that this is either an entry from a standardized short set, or else is a free form text field to act as a comment to explain why the inference occured (ie. results of investigations and caveats/justification for inference conclusion).
- Proposal that the inferred should be a composite license structure. This proposal should be discussed in the next meeting.
Attendees:
Bill Schinelle
Gary O'Neall
Peter Williams
Kate Stewart
Next week - move time to 4:00PM Eastern
- Kate's grammar for the 'tag-value' format / DEB-5
- Gary's slides for tools to be made available
- recap / status of inclusion of new license fields
- Proposal process
Grammar Tag-Value / DEB-5
- Is there a difference between the grammar embedded and the proposed grammar?
- Similar. Purpose of Kate's proposal is to resolve ambiguities.
- Difference in syntax of the grammar - DEB-5 compatibility would require a different grammar
representation
- Concern about forward compatibility - ability of a version X parser to understand version X+N documents
- There is a goal to be compatible with the DEB-5 which would lead more to the DEB-5 based grammar
- Need a way to map between the RDF and tag value and between tag value and RDF
Gary's slides for tools to be made available
- Can the pretty printer output tag-value
- Concern about not having a formal parser for the tag-value - could lead to bugs if hand-coded emitter for the tag-value
- Gary agreed to prototype a tag-value emitter
- Gary will ping Kate for the current Spreadsheet format
- For contribution/feedback switch from emailing spdx.org to use bugzilla
- Mention that in the spec there will be a grammar and an RDF OWL document
recap / status of inclusion of new license fields
- An asserted license field seems to have achieved consensus
- Proposal to split the license field into asserted license, "detected" or "seen" license, and a comment field
- Will continue the proposal process on the spdx-tech mailing list and in bugzilla
Minutes 1/25/2011
Attendees:
Bill Schineller
Gary O'Neall
Peter Williams
Kate Stewart
Summary of follow-up items from the call:
Minute details:
Review spdx overview slides sent by Kate - purpose to align on the current status of the spec:
Section Headers in the spec - Reviewer information has been moved to a separate section at the end
License section - consider renaming non-standard licenses to embedded licenses - has implications on the short form names. Todo: Kate to follow-up on the proposal. Note that embedded is somewhat ambiguous - used for "embedded in the package" as opposed to "embedded in the SPDX file"
Identification section - Version of SPDX - does it make sense in the RDF spec? Topic for future discussion.
Identification section - Method of xor for all file sha's to generate overall checksum - need to publish and review the specific algorithm
The package file sha is optional in case the spdx file is embedded
Source information - change description to reflect additional information on the source rather than anomalies (e.g. the download URL is no longer available)
Package level - agree to add asserted license
Asserted may include logic (and/or disjunctive/etc)
Seen licenses would just be a list
Not clear if asserted license at the package level should be mandatory or optional - future discussion
Copyright - just a string for release 1 of SPDX
Should there be additional optional tags in the non-standard license? Topic for a future proposal.
File - Asserted License -> Asserted Licensing (takes care of possibility of multiple licenses)
File - Seen license - can be multiple licenses
Cardinality - does it make sense to have a mandatory field that may contain 0 items - yes since it confirms that "none were found"
Reviews - should there be a comment for the reviewer? Yes - add this as an optional field.
Todo: reconcile the tag names with the spdx overview
Need a better naming convention - add to topic for next week's call - suggestion to invite the individual providing the feedback to the call.
Minutes 2/1/2011
Attendees:
Bill Schineller
Gary O'Neall
Peter Williams
Kate Stewart
Marshall Clow
Phil Koltun
Pre-meeting discussion on version management of the specification. Need to work through the remaining issues to get the git version of the spec in sync. After that, we can modify the process to automatically push out the defects.
Issues review - please refer to the spreadsheet attached to the minutes. The legend tab describes the priority definitions.
Changes in the spreadsheet from the original proposed priorities:
587 and 625 should probably be merged
617 - leave as priority one since the legal team may require
Move 640, 643, 646 to P1 - these will affect the spec being in sync
623 - comment field for author of the SPDX document - move to P1 since this is relatively easy
Need to add a bug to track the implementation of the xor's for all file hashes to create a unique package signiture
Reference this new bug in bug 593 - the solution referenced above will solve this bug as well
Bill added rought estimates on the effort for the P1 defects
Gary will update bugzilla with all of the priority information from the meeting
From this point forward, all submitters of bugs should assign a priority based ont he following critera:
1 - Must be resolved for beta
2 - Want to resolve for beta, but is a must for the release 1 of the spec (e.g. can be resolved after the start of beta)
3 - Want for release 1
4 - Target for a future release of the spec
We should assign all P1's - if you see any bugs you would like to work on, please assign it to yourself
Some discussion on the support for tag values in Beta. We will raise this question in the call with prospective beta sites on Thursday.
Minutes 2/8/2011
Attendees:
Bill Schineller
Gary O'Neall
Peter Williams
Kate Stewart
Kirsten Newcomer
Three items were discussed during the meeting:
- Bugzilla ID 644 - cardinality of Package Overview Info is missing
- Bugzilla ID 592 - License repo
- Time for next week’s call
Bugzilla ID 644:
We discussed the implications of nesting in RDF/XML and the impact of any changes to the spec.
During the discussion, it was decided that a diagram representing the domain model would be helpful in resolving this and other issues.
Kate agree to draw up diagram(s) representing the domain model.
Bugzilla ID 592:
We discussed the processes for setting up the license repository. It was proposed that we use the license spreadsheet to produce RDFA/HTML pages which would populate the repository.
[Note - since the meeting Peter has proposed a modification to the process to retain the formatting of the license text]
Peter agreed to produce an example RDFA/HTML document.
Gary agreed to write a tool which would translate the spreadsheet into the RDFA/HTML documents.
Next week’s call:
Gary will be calling from Hawaii - we agreed to move the call to 1:00 Eastern time to accommodate the time zone differences.
Summary of Actions:
Kate to draw up diagrams representing the domain model
Peter to draft an RDFA template/document for the license
Gary to write a tool to translate from the spreadsheet to RDFA
Minutes 2/15/2011
Attendees:
Ann Thorton
Kristin Newcomer
Bill Schineller
Peter Williams
Kate Stewart
Gary O'Neall
Note: Next weeks meeting will be at 1:00 Eastern time
Agenda -
License Repository (bug ID 592) - review Peter's draft rdfa html
Domain model diagram (fromt the discussion on bug ID 644) - review Kate's diagram (postponed due to time)
License Repository:
Review of the web pages:
- On the summary web page, there are just 2 columns - full name and short form identifier
- The license detail page would contain the full name, short identifier, other web pages for this license, notes, text, templated version of text, "official header", templated header
- Template column/field - There was a discussion whether the template text should be a separate field from the text field:
- Exact format of the abstract license template text TBD
- Current working guidelines are:
- no capitalization
- white space condense (single blank represents multiple blanks and tabs)
- alternatives denoted as [a|b] for cases of acceptable spelling differences - for instance, british vs american spelling of common word.
- [.*] to denote any value is acceptable - for instance, after a copyright statement.
- Defining the abstract license template format of the license text is out of scope for the technical team, this will come from the legal team. The technical team will review for technical implement ability.
- Suggestion that getting FOSSology/Ninka experts to do the review of the the abstract license template syntax, based on what their tools can recognize, and what they do already as part of their matching. If Open Logic or Black Duck want to contribute information from their recognition algorithms, that would be welcome too. To be discussed in a future meeting once we nail down the format a bit more.
- legal team agreed that having a separate field for template would be useful (ie. it would be good to have both the official human readable formatted version available on the license detail web page as well as the abstract license template version on the license detail web page.)
- for now, this template field will default to the same text as the license text
- no property for for the license name. In the proposal, dc:title is used for the name – Proposal to for the SPDX spec to include a license name. Proposal to add this after beta. To be discussed
- License ID - should it be generated from the URL or have a separate tag? [Gary: I think we agreed on it being a property, but I did not confirm this on the call]
- no property to store the header
- no property to store abstract license template template
- no property to store license notes
- No property to store the other URL’s. owl:sameas currently used for the other urls in the license, should we add it in the SPDX spec as a separate appendix or in a license specific section.
- Header text (could have multiple headers are in the text). The data model will support
multiple headers, but we will only use one for now.
- Issues with spreadsheet license text was discussed throughout the call. There were 2 issues – formatting is lost and some license text is too large for the spreadsheet cell. A proposal was made to have the spreadsheet license text cell reference a file which would be formatted using HTML tags.
- We also talked about headers, and abstract template versions of the headers. To keep things sane for beta at least, only a single header will be recognized for each license initially, preferably the official recognized one, if it exists.
Action: Add the missing properties to the spec. In general, if there is a column in the license spreadsheet from legal, it should be a property in the spec.
Action: Proposal for the license text column to refer (optionally) to a text file which will be included with the license spreadsheet.
Minutes 2/22/2011
Attendees:
Kristin Newcomer
Bill Schineller
Peter Williams
Kate Stewart
Gary O'Neall
Marshall Clow
Review of last week’s minutes – minutes updated and will be posted to the wiki.
Review Kate’s UML diagram:
Discussion on the relationship between the SPDX File and the information. There are basically 2 different conceptual models – one proposed by Kate and a second model where the SPDX Package contains many of the relationships.
A discussion on the impact to the tag/value format and to the RDF format was discussed. A discussion on the impact to Beta was discussed.
Actions resulting from the discussion:
- Obtain information on how the beta customers will use the SPDX spec – will they use the tag/value format or the RDF format? The current assumption is that the beta customers will use the spreadsheet and will not care what the underlying format is. A questionnaire has been sent to the beta sites through the business teams.
- Draft the UML model for the current RDF tools implementation (Gary) – will compare and discuss next week
- Document the new fields that need to be added to implement Kate’s proposed model (Kate)
Minutes 3/1/2011
Attendees:
Kirsten NewcomerBill SchinellerPeter WilliamsKate StewartGary O'NeallAnn Thorton
Review Peter’s UML diagram:
We're in the process of reviewing 2 different conceptual models with the goal of finalizing on one model for beta.
On 2/22, the team reviewed a model proposed by Kate
At this meeting, the team reviewed a model proposed by Peter.
Discussion included: relationships between objects, what abstract classes are necessary, model for licenses. Peter made some real-time modifications to his model during the discussion to address points raised.
There was some discussion of whether we should allow for names to change after beta, given that the spec will be versioned. I don't believe agreement on this was reached.
Actions resulting from the discussion:
Minutes 2/22/2011
Attendees:
Ann Thorton
Kristin Newcomer
Bill Schineller
Peter Williams
Kate Stewart
Gary O'Neall
Agenda:
Compare the models provided by Kate (attached) and the models from the email thread
Review/discuss the SPDX Names spreadsheet provided by Kate (attached)
Model discussion:
There were a lot of similarities between the proposed models.
Two differences in the models were discussed:
1. Abstract License which subclasses a non-standard license and a standard license vs. a License object with one subclass for standard license.
2. Representing the license reference text – either as the text in the non-standard license or text in a LicenseInfo object.
For #2 – The scope was discussed as to whether text for licenses not in the standard license list and not in the file itself. The scenario discussed was if text was found in a file referencing a license which is not in the SPDX standard list of licenses, is there a way to represent the text of the license which is not in the file itself. This was described as out of scope which raised some concerns. Kate raised a concern that if this was in scope, there would be issues with the ID.
We agreed that it was confusing to have the name of the referenced license text “Non-Standard License”. Various names were discussed and we agreed to change name of Non-Standard License to “License Reference”.
Kate to follow-up on updating the diagram based on the discussion. Once that is done we can revisit the scope question and the need for Abstract License.
Kate provided a spreadsheet that compared the names for the SPDX properties used by RDF/XML, Tag/Value and the spreadsheet.
Peter agreed to fill in the RDF/XML column and update the git repository version of the spec with the resultant names.
Minutes 3/15/2011
Attendees:
Kristin Newcomer
Bill Schineller
Peter Williams
Kate Stewart
Gary O'Neall
Agenda:
· Resolve the naming differences based on the spdx-naming-resolution spreadsheet (http://www.spdx.org/wiki/field-names)
· Resolve the complex licensing model – supporting non-std licenses
· Discuss ways to represent the RDF entities in the spec (e.g. artifactOf, DisjunctiveLicensingSet)
Spreadsheet:
· Kate provided a new spreadsheet format with a “proposed” tab to focus in on the remaining items
· Discussed the SPDX version and agreed that, although a bit redundant in the RDF XML format, we can add a property spdx:specVersion.
· Creator/created – matched the name in the RDF to the tag (Creator)
· Need a creator class and possible a comment class to associate the comments with the creator – same general requirements for reviewer – Peter agreed to propose a model
· Package filename – since this isn’t a relative path, should be a different property, agree to change the name to spdx:packageFileName.
· URL: couple issues were discussed, conflict of uniqueness with spec “Unknown”, required field, redundancy with SourceInfo. Peter brought up a good point that if we don’t have URL being the same as the Package resource URI, there is no place to store package resource URI information in the tag value or spreadsheet. Agreed on property DownloadLocation property.
· Seen Licenses in All Files – discussed the change in terms and proposals, should update the bug to reflect the renaming
(2:00 continuation of the meeting)
Discussion of the complex licensing model
· A non-standard license would include text for licenses not in the standard license text and licenses not included in the file or package information. This would only be applicable for a concluded license. This resolves the scope issue.
· An issue was raised where we are losing some information on the structure of a license with this approach. We also will not be able to include the text of the standard licenses in the SPDX Analysis itself. We agreed that this issue can be resolved after beta.
· The proposal of associating text with the AbstractLicensingInfo object (in SPDX-model-v4.png) was discussed. We agreed to log this is a bug and discuss this after beta.
Back to the discussion on the name:
· SeenLicense name – legal proposal is LicenseInfoInFile.
· Concern on consistency on the use of LicenseInfo.
· Decided to leave concludedLicense alone (prefer LicenseInfo)
· Synchronized 3.9 (seen licenses) with this terminology – see spreadsheet for final resolution.
· Note on the spreadsheet – a green cell indicates that this is the preferred terminology for the row. Other columns may need to be updated to synchronize with this cell.
· Copyright statement – agreed to change to copyright text to allow a more structured copyright statement in the future
· NonStandardLicense – changed to LicensingInfo
· LicenseID – discussed various approaches and issues – agreed to keep a property for LicenseID to map between the RDF/XML and non-RDF/XML formats in a consistent manner.
Agenda for next week:
· Complete discussion on names
· Discuss ways to represent the RDF entities in the spec
Minutes 3/22/2011
Attendees:
Nicholas Loke
Branden Robinson
Kristin Newcomer
Bill Schineller
Kate Stewart
Gary O'Neall
Agenda:
· Complete the resolution of the naming differences
· Discuss ways to represent the RDF entities in the spec (e.g. artifactOf, DisjunctiveLicensingSet)
Spreadsheet:
· Started with 4.2 licenseID
· We will color proposed changes in RDF column yellow for Peter’s review
· Agreed on LicenseID as property last time – propose spdx:licenseID
· Per file info -> File Information
· File name – spdx:filename
· File checksum/sha1/identifies – Agree on the name being fileCheckSum.
· To future proof the field, we agreed to make the name generic (not algorithm specific)
· Create a checksum class with 2 properties, algorithm and value
· We changed the Package field to be use the same checksum approach
· For the RDF fields, should we have property names for everywehere we have class names defined in the spreadsheets? We decided to add a property name followed by “/” then the class name for these fields.
· Discussed whether the file verification field should also use the same checksum approach. Decided to keep this as a single field.
· ArtifactOf – To not loose information, we will add a URI property
· Some discussion on the different scenarios with ArtifactOf DOAP documents (external DOAP documents and creating internal DOAP resource nodes within the SPDX document). Agreed to test out some of these scenarios during Beta.
· Some discussion of the comments – agreed to use the rdfs:comment consistently.
· Note: Some of the updates to the spreadsheet may not have been captured in the bullets above – see the Spreadsheet version 9 yellow for all updated names.
Agenda for next week:
· Complete discussion on names – website fields
· Discuss ways to represent the RDF entities in the spec
Minutes 3/29/2011, 3/30/2011
Attendees 3/29/2011:
Nicholas Loke
Branden Robinson
Kristin Newcomer
Bill Schineller
Kate Stewart
Gary O'Neall
Peter Williams
Attendees 3/30/2011:
Jack Manbeck
Bill Schineller
Gary O'Neall
Nicholas Loke
Marshal
Peter Williams
Kate Stewart
Agenda:
· Review naming spreadsheet updates
· Discuss ways to represent the RDF entities in the spec
Spreadsheet:
· Reviewed Creator change name to creationInfo (property) and CreationInfo (Class)
· Discussion on if we should prepend property names with cardinality of 1 to N with “has” – we will decide after completing the rest of the spreadsheet
· Format of the spreadsheet RDF column: propertyName/Range (and/or class)
· Proposal for Beta – remove the CreationInfo class, add back a property for creator – range Agent, add a creatorComment property - string
· Future – proposal to add changelog class and property to Analysis
· Todo: Gary to re-align spreadsheet rows
We decided to have a follow-on call on Wednesday, 2:00PM Eastern. Bill will send out an invite.
Continuation of the call –
· Agreed to go back to a simple model for creator (property spdx:creator) and comment – (property spdx:creatorComment). We discussed whether comment should be spdxcreatorComment or rdfs:comment. Concluded that the semantics are different enough to create an SPDX specific property.
· Discussed the use of the Checksum class and alternatives to providing the extensibility (e.g. separate properties for each algorithm and having the algorithm be identified through the subclass of Checksum rather than a property). Decided on using the checksum class as it allows for additional / different properties based on the algorithm and keeping the algorithm property.
· Change property name from spdx:packageChecksum to spdx:checksum since it is semantically the same property as the file property – Note: we did not (and probably should) update the fileChecksum to checksum.
· Discussed whether we should change the range of the packageVerificationCode to a Checksum class. We decided to leave it as a literal string for now, although most people on the call thought that we should make this field more extensible. We will revisit this during and/or after beta.
· Licensing discussion:
o We discussed the name and meaning of the “NonStandardLicense”. Agreed to rename the field [see spreadsheet for resolved name]
o We discussed whether the RDF model should have the previously named “NonStandardLicense” as a subclass of License. We will pick up this discussion in our face to face meeting.
o The LicenseSets (ConjunctiveLicenseSet and DisjunctiveLicenseSet) will both contain LicensingInfo objects.
Note: there will not be a call next Tuesday, we will meet again at the face to face meeting at the Linux Collaboration Summit
Attendees
--------------
Kate Stewart
Peter Williams
Bill Schineller
Gary O'Neall
Phil Odence
Kirsten Newcomer
Mark Gisi
Marshall Clow
Matt Germon
Michael Herzog
Scott Peterson
Jack Manbeck
Philip Koltun
Steve Cropper
Kim Weins
Martin Michlmayr
Guillaume Rousseau
Agenda
-----------
We reviewed the Specification as a group in order to close on issues and get agreement for the beta/release candidate version of the Specification.
There was a lot of lively and effective discussion.
A number of updates were made to the Specification during the meeting.
Below are the conclusions made during discussion, along with some issues identified for exploration after beta.
Again, please review and send additions/corrections as needed
Conclusions
-----------------
licensing model that enables representation of disjunctive / conjunctive licensing is adopted. This means license cardinality can be 1.
Graphical version of model will be added to the Specification (appendix?)
Action Items
-----------------
Kate will complete first round of edits to Specification
Gary will make additional edits to the Specification to add RDF/XML examples and update the tools and example spreadsheet
Kate will get input on wording changes from legal where appropriate
Technical team will do a final review; date TBD
Open Issues
------------------
Concerns were raised about the verification mechanism (SHA1) not including the relative filename
Will the OWL document be added to the Specification?
Proposed that version two provide support for more hierarchical use cases (package in a package for example)
Concern about the created date being overly specified for the RDF format
Minutes 4/12/2011
Attendees:
Nicholas Loke
Kirsten Newcomer
Peter Williams
Bill Schineller
Kate Stewart
Agenda:
· Plan for what remains
· Review spec – create a list of what’s missing
· Go through all remaining items
Review Spec:
· Discussion on document format. Agreed to add RDF XML examples to the sections and move the tag/value example under the tag/value
· The RDF and tag/value information will be separated out into different appendices.
· Peter will produce a new set of RDF documentation. It will be included in the PDF document and the HTML will be posted to spdx.org/rdf/terms. The documentation will be based on an OWL. This will be provided by Sunday.
· Gary will generate examples for the RDF XML from the tools. This will be done within 2 weeks.
· Section 3 – concern about having structure to the strings, for the RDF. Data format for beta will be simple strings. The tag/value should have a structure. The RDF format for after beta TBD.
· Date Format – should we specify the date format? Agreed to leave the spec as is (was highly discussed a year ago and the current format was the resolution).
· Should creator comments and reviewer comments be rdfs:comment? TBD (Peter – can you include a proposal when you document the RDF)
· Discussion on the RDF specific subsections – will make consistent once we add the documentation from Peter
· SourceInfo 4.6.6 should be changed to multi-line
· LicenseInfo fields – add the new syntax for license sets and mandatory 1
· Review of license terminology – will handle on the list (I’m not sure I completely captured this item)
· Section 5 Identifier Assigned -> Identifier
· Section 5.2 is currently 4.1 – renumber/format issue
· Review free form text fields (e.g. 5.1.13) for consistency for <text> … </text>. Would prefer the subsection for data format to be just free form text and the tag example to include the <text> … </text>
· Possibly add a sentence or two in section 6, add the description for what happens if there is no archive file name for the package (use the package name).
· 6.3.5 lowercase c in checksum
· ArtifactOf structure does not match well to the RDF format – Peter to propose a solution
· Reviewer – name string format – same issue with parsing strings in the RDF
· Inconsistent use of unspecified and unknown licenses – proposal to treat these as standard licenses and include them in Appendix I (and on the spdx.org/licenses website).
· Diagram – Analyzed file – is it a property of SPDX Doc or a just a property of the package? Agreed to add a property at the SPDXDoc level for all file and OtherLicensing info. This will allow for an easy extraction of all file information within an SPDX doc and easy extraction of all OtherLicensing info within a doc.
Plan: Peter will provide the RDF information by Thursday. We will review on Friday. This will allow implementation to begin over the weekend.
Minutes 4/19/2011
Attendees:
Nicholas Loke
Kirsten Newcomer
Gary O’Neall
Peter Williams
Kate Stewart
Agenda:
· Definitions doc – review Kirsten’s emails on consistent terminology
· Resolve differences in spec and html – review email thread on consistency
· Discuss proposals on verification code algorithms – review email thread from Marshal
Review of the terms “Unknown”, “Undetermined”, and “None”:
Discussion of Undetermined/NotSpecified/NotAnalyzed terminology proposal. Outcome: recommendations made to revise proposal to reflect 4 use cases where license/copyright/url cannot be specified:
· 1) analyzed and data is insufficient to draw a conclusion
· 2) analyzed, and conclusion is Not Licensed
· 3) analyzed, and no data found
· 4) not analyzed
· Revised proposal sent out to list on 04/19
· Add “NONE” category for concluded license
· Change “NOTSPECIFIED” to “NONESEEN”
Discussion of cases where no info is available need to be captured affirmatively in RDF license valuesor whether empty value is sufficient
· Conclusion: should be affirmative; provide values that specifically address this use case
Discussion of how best to handle special terms: as literals/constants or try to "shoe horn" into license registry
Review differences between pdf doc and html rdf spec:
· For licenses, change the application to match rdf html spec on the “NONE” (etc.) being spdx/rdf/terms URI’s. Peter to update vocabulary with new terms.
· Spdx:License class – ok as is for beta; revisit after beta
· CreatorInfo cardinality – go with the pdf cardinality for now and revisit after Beta start
· Cardinality of licenseInfoFromFile is 1 .. n
· Cardinality licenseConcluded, … cardinality 1 – if multiple licenses, represented as a conjunctive or disjunctive set
· Cardinality of licenseInfoInFile is 1..n (semantics similar licenseInfoFromFiles)
· Describe which properties of DOAP are used in both the pdf and html (name and homepage)
· Agreed to change licenseID -> licenseId in pdf, html, and app
Minutes 4/26/2011
Attendees:
Kirsten Newcomer
Bill Schineller
Brandon Robinson
Gary O’Neall
Peter Williams
Nicholas Loke
Marshall Clow
Agenda:
· Discuss the email thread on the terms for undetermined/none seen/not analyzed licenses (email thread originated by Peter)
· Review the verification algorithm (email from Gary)
· Discuss the relationship between the SPDX Document and the extracted licensing info
None Seen, None, Not Analyzed, Undetermined:
· Discussed meaning of the terms.
· Discussed need for 4 terms.
· Discussed some proposals for different terms (unfortunately, I did not capture the specifics).
· Did not reach a conclusion on the call, will follow-up on email
· Kirsten to write-up the definition of the 4 terms
· Peter to follow-up with a proposal based on Kirsten’s write-up
Analyzed (effort expended)
Not Analyzed
Seen/factual
Concluded
File Verification Algorithm:
· Reviewed the proposal – consensus on the general approach of generating a sha1 from the filenames + sha1’s of the individual files
· File path – reference the file name in the document rather than define the filepath in the verification section
· Check the file name specification to make sure it specifies forward slash “/” as the separator character
· Sha1 – reference the sha1 in the doc rather than define the format in the verification section
· Change sorting to start with sha1 followed by file path. Note that this resolves case sensitive sorting issues with the file name.
· Change sha1 definition to specify lowercase a-f for the hexadecimal representation
· What to do with the spdx file itself – proposal is to leave it out of the verification algorithm. Peter to review and possibly propose other terms. This will be specific proposal will continue on the email thread.
Extracted Licensing Info at the Doc level
· Agreed to add a property at the SPDX document to capture all of the extracted licensing infos
· Proposed property name “hasExtractedLicensingInfo”
· Range ExtractedLicensingInfo
· Cardinality 0 or more
· The URI associated with this property would be the same URI used in licenseInfoFromFile and licenseInfoInFile
· Peter will update the spec with this information
With the two outstanding items on the spec (terms for unused/none/noneseen licenses and how to treat the spdx fil in the File Verification algorithm), there may be impact on the beta start date. Depending on the outcome of the email discussions, we will alert the business team to the possible schedule impact on Thursday.
Minutes 5/3/2011
Attendees:
Kirsten Newcomer
Bill Schineller
Gary O’Neall
Peter Williams
Nicholas Loke
Marshall Clow
Kate Stewart
Agenda:
Terms – prepare for legal team
Verification – any concern with excluding the spdx file(s) which are being generated or updated?
Push tools for beta?
Re-organizing the web – difficult to find things
Tools:
Overall schedule:
Re-organizing the web:
List of excluded files from hash calculation:
License terms:
· Agree to hold to the proposal (three terms for no-value AMBIGOUS, NONE, NOTANALYZED
· Discussed revised definition of NOTANALYZED – ok with revising definition to try to address Scott Peterson concern or that the preparer of the SPDX document is not making any assertion regarding the value of this field.
· Propose new definition of NOTANALYZED:
Indicates that the preparer of the SPDX document made no attempt to
determine the value of this field or that the preparer of the SPDX document is not making any
assertion regarding the value of this field.
Minutes 5/10/2011
Attendees:
Kirsten Newcomer
Bill Schineller
Gary O’Neall
Peter Williams
Nicholas Loke
Branden Robinson
Kate Stewart
Agenda:
URL’s for beta
Review of open priority 1and 2 bugs
Minutes 5/24/2011
Attendees:
Kate Stewart
Kirsten Newcomer
Bill Schineller
Gary O’Neall
Peter Williams
Marshall Clow
Branden Robinson
Steve Cropper
Agenda:
Report on General team meeting -- Kate
Beta readiness
Web page review and cleanup -- all
As always, please send additions or corrections.
Minutes 6/7/2011
Attendees:
Agenda:
Review
Minutes 6/14/2011
Attendees:
Agenda:
Review of last week’s items:
Update on Kate’s conversation with Steve
Minutes 6/21/2011
Attendees:
Agenda:
Updates since last week:
Web site for usage information for the spec:
Tools update:
Minutes 6/28/2011
Attendees:
Agenda:
Tool defects:
Other beta feedback:
Minutes 7/5/2011
Attendees:
Agenda:
Tools update:
Review open bugs
Additional updates:
Minutes 7/12/2011
Attendees:
Agenda:
Package Version:
Review open bugs
Minutes 7/28/2011
Attendees:
Agenda:
The team had a good discussion about the new proposed Supplier fields, including discussion of:
Spec update
Bug review
We ran out of time to review the bug list, but ask that everyone
Corrections, additions welcome.
Minutes 7/28/2011
Attendees:
Agenda:
Supplier fields discussion
Additional updates to Spec
Open Action Items
Corrections, additions welcome.
Minutes 8/9/2011
Attendees:
Agenda:
Review open bug list
Walkthrough of spec changes
Other status
Minutes 8/23/2011
Attendees:
Agenda:
Logistics:
Feedback from LinuxCon:
Numbering for Spec. version:
Tools source structure:
Note: Bugzilla has a target field to indicate which release the resolution is targeted for. There are no targets for detail “CC” versions; we will use the major version targets for those changes.
Verification code algorithm:
Bug 818 – Composite packages:
“Garbage Files” (e.g. .svn files):
Minutes 8/30/2011
Attendees:
Agenda:
Verification Code:
Minutes 11/29/2011
Attendees:
Agenda:
Updates:
Bugs:
Minutes 12/6/2011
Attendees:
Agenda:
Updates:
Composite Package Proposal:
Minutes 12/13/2011
Attendees:
Agenda:
License Metadata:
Updates:
Review of last week’s minutes:
Minutes 1/3/2012
Attendees:
Agenda:
Review of 1.1 spec draft
Other discussions and updates:
Minutes 1/10/2012
Attendees:
Updates – still can’t upload tools
Gary to forward email to Kirsten for Martin to up the limit
Version 1.1 –
Tools need to be updated to the latest spec, Gary will review 1.1 draft once completed and update the Java tools to the latest spec
Git repo – should we upload the binaries?
Problems configuring Git repo for the python tools – enlisting Peter’s help
Update spdx tech page to display the git repo URL – Gary to update page
Next week – discuss 818, example document – try out an example, move it to something more concrete
Agenda:
Update on tool blockers:
Next Steps on bug 818:
Minutes 1/17/2012
Attendees:
Agenda:
Update on tools:
Hierarchical supply chain:
Minutes 1/24/2012
Attendees:
Agenda:
Discussion on excluded files and relationship to SPDX files. Embedded packages will be addressed in version 2.0 of the spec.
For the embedded packages which are represented by a subdirectory of files, proposal would be that there is an SPDX file at the root of the subdirectory which would detail out the embedded package. The higher level SPDX would reference the SPDX file in the subdirectory. The higher level SPDX does not need to detail out the files contained in the lower level SPDX.
Discussion on references to embedded SPDX files – how does that affect the proposed model? Possibly including a null specifier reference. Possibly including an SPDX reference in the model.
Discussion on including some of the 1.1 model into the proposed model.
[I believe there was general agreement that the license model was useful, however this was not confirmed on the call]
Discussion on the model around packages files and file types. Discussion on whether this model is useful or if it overly complicates and constrains the model. Agreed that it would be nice to allow SPDX to refer to things other than packages. Discussion on using the annotations for this purpose. Will pick up the discussion next week.
Minutes 1/31/2012
Attendees:
Agenda:
Package definitions:
- Start with Wiki’s definitions
- Kate proposed any collection of files
- Jack’s proposal – unit of delivery of software files
- The current RDF Package definition could be used
- Agreed on the usefulness of a definition “{} represent a collection of one or more files that are delivered as a unit" vs "A package represents a collection of software files that are delivered as a single functional component" from http://spdx.org/system/files/spdx-rdf-terms_27.html#Package
Minutes 2/7/2012
Attendees:
· Gary O’Neall
· Bill Schineller
· Savino Sguera
· Peter Williams
· Kate Stewart
· Rana Rahal
· Brandon Robinson
· Steve Cropper
Agenda:
· Date for version 1.1
· Discussion on SPDX package definitions
·
· Discuss proposal for hierarchical supply chain (bug 818)
Update on license text:
Large text issue for spreadsheet – proposal to use external text files for the large text. Will be discussed in the legal team.
Date for 1.1:
· Would need feedback from the verification code implementations first
Model discussion – comparing two proposals from Gary and Peter:
· One difference in the models is how the relationships between SPDX documents are implemented. Gary’s proposal implements it at the Licensable/SPDX Element level while Peter’s proposal implements the relationship at a more concrete level (e.g. SPDX Package and SPDX File).
o Peter’s model is more straightforward – 1 RDF triplet to describe a relationship vs. 3 RDF triplets
o The indirect relationship model has the advantage of being more extensible and will allow applications which only want to deal with the SPDX Element/licensable level
o Question: Is there any use cases which would only use the SPDX Element and not want to go down to the file/package level of detail? No one on the call could think of any examples.
o Is there enough value having a level of abstraction and flexibility to describe the relationship to warrant the additional complexity? [We did not close on this question, but the discussion seemed to trend towards the simpler approach]
Note: the top level element of the combined proposal should be SPDX Document (not SPDX file)
Postpone discussion on package definition for when Ed’s back.
Supply Chain Summit will be held immediately after Linux Collaboration Summit – Question – Can we present/discuss the version 2.0?
Minutes 2/14/2012
Attendees:
Agenda:
Update on license text:
Collab. Summit:
SPDX package definitions
Hierarchical supply chain
Gary will do some homework on mapping the properties into a model where SPDX Package is subclassed from SPDX Licensable. Will also do some thinking about how to implement the specifier mechanism.
Minutes 2/21/2012
Attendees:
Agenda:
Need to figure out planning of breakout session for Linux Collab in April.
SPDX Licensable vs. SPDX Package - no clear decision from last week of how SPDX package relates to SPDX licensable.
Three proposals:
- Ed: original
http://spdx.org/wiki/rough-proposal-signing-and-supply-chain-friendliness-spdx.2.0
- Gary: Updated for property mappings and a proposal for referencing SPDX licensable (note that the referencing proposal is not considered very complete)
http://spdx.org/wiki/2012-feb-1-merged-model-proposal
- Peter(Licensable incorporated into Package) from mail list.
Discussion on annotations - when can it be used?
- Example: a license header that is incorrect creeps into source, email permission from author to correct header prior to release of the package.
- Example: producer after SPDX is created - sign combined entity only?
Annotation - include information you need.
Failure mode example - inbound some source code, upstream too lazy to do it, don't want to be bound by all rights reserved.. but want to put on SPDX data.
Discussion on concluded license vs. declared license - Ed asserting is it really is not needed if we have annotations. Conflicting assertions - arbitrary subsequent opinions may be problematic, using current model.
Example for discussion:
Individual has created SPDX file, 2 files in high level directory,
The asserted license in the SPDX document is incorrect (inconsistent with text in the distribution). How is this handled with annotations and make it clear it is an issue with the asserted license and not a new conclusion on the license?
Basically there exists some complex scenarios as to when you need fine semantic differences to be explicit. GPLv3 is going to be lots of opportunity for confusion adding in to mess.
To what extent is the review field able to compensate for annotations?
Under discussion.
Very complicated networks that emerge, and want to know providence.
Want to preserve this... duplicate vs. backward chains. (copy or annotate on backward chain).
How to get closure & conclusions? Mixing a couple of things here:
1) how SPDX licenseable elements refer to one another
- problem that needs to be solved.
2) what is the model for an SPDX document (licensable, but what else is really needed, and what is modeled)
3) heirarchy mechanisms - URI/hashed/etc. (annotations vs. concluded licenses vs. reviewers.)
Concern: supply chain day, can use this as a way of picking brains once these proposals are fleshed out and structured for more working conversation. Collaborative to work through problems rather than marketing to people. Ed wants to have input from technical team into agenda.
Assertion that all the proposals are wrong size - either too big or too small. Too much vague around the edges. Reach conclusion and agree on.
Can we disconnect the mechanism we use for linking Licensable elements from the model? Proposed as a way to move the discussion forward.
Some of the proposals for the linkage mechanism work well for RDF but not for tag/value.
Gary proposed there may be a way to represent the RDF in a text file in a readable format using triplets.
Gary to send ideas.
Minutes 3/20/2012
Attendees:
· Gary O’Neall
· Bill Schineller
· Kirsten Newcomer
· Kate Stewart
· Peter Williams
· Jack Manbeck
· Marshall Clow
· Ed Warnicke
· Rana Rahal
Agenda:
· 1.1 spec
· Signing proposals
1.1 Spec
Verification code has not been tested. A single implementation in the SPDX tools has been provided, but has not been verified. We have not heard anything back on the Python implementation.
Proposal to move forward as specified.
Kate will review bug DB and update spec.
Peter will update RDF terms, then Gary will update the tools app and compare the doc to the RDF to the tools implementation.
Kate to put draft licensing changes in SPEC and get signoff from legal team
2.0 Specification - Signing proposals:
· Backwards compatibility requirements
o Ed asserts that there are mandatory fields in 1.0 that do not make sense in the supply chain scenarios.
§ Proposal to review these mandatory fields and decide if they make some of these mandatory fields as optional in version 2.0
§ Agree to discuss what is mandatory and what is not in the in person meeting
§ Agree to document use cases
· Agree that signing is optional
· Compatibility – inline would probably break existing tools if the document was signed
· Put to a vote – Most participants expressed the opinion that both would work. Vote yielded a majority to the detached proposal. Rana – pass, Marshall – pass , both should work, Jack – detached, Gary – detached, Bill – detached, Kirsten – detached, at that point it was clear that we had trended to detached, so voting stopped.
Plan for the face to face meeting:
· Wednesday PM session: discussion of Use Cases & Mandatory field migration from 1.0 to 2.0
· Thursday AM: proposal and discussion with wider group on what fields do it make sense to change what is mandatory, and what is not. Get wider group feedback – before moving forward
· Thursday PM: Working through Ed's wider 2.0 proposal, incorporating feedback from earlier sessions on mandatory fields vs. not, and whiteboarding against the use cases.
Pre-work before Face to Face.
· Create a table of the mandatory fields and properties, and list the use cases that support and those that are contraindicated by them. Have this work done before we get to face to face meeting. - Kate put a wiki page framework up. Others to add use cases against the fields as they think of them.
· Create a consolidated use cases for 2.0 list. Bill has transferred work from pad onto this site. All – please review and add other cases for consideration.
Minutes for April 4, 2012 Face to Face meeting at Linux Collaboration Summit
Attendees:
Marshall Clow
Kate Stewart
Ed Warnicke
Jack Manbeck
Gary O’Neall
Peter Williams
Bill Schineller
Kirsten Newcomer
Discussed proposed agenda for Thursday afternoon (4/5) meeting
Steps needed to close on v 1.1 of the spec
Proposed governance model for SDPX Technical group
Brief discussion of signing & review fields
Discussed schedule for 2.0. Potential schedule:
Proposed To-Do list for next 12 months
SPDX 2.0 Use Case review & discussion: changes based on discussion captured in wiki changes
As always, comments and corrections are most welcome!
Kirsten
Minutes 4/10/2012
Attendees:
Agenda:
https://bugs.linuxfoundation.org/show_bug.cgi?id=1017
Overview Linux collab Meeting: All attendees on the call participated in the face 2 face meeting
File comments proposal (https://bugs.linuxfoundation.org/show_bug.cgi?id=1017)
Use Cases
Minutes 4/17/2012
Attendees:
Collecting use cases – concern on the deadline – 1 ½ weeks isn’t enough. Suggest 5 from today deadline. Agreed to 5 weeks. Ed will update the email and resend to the groups. Will send out updates weekly until the deadline.
Agreed to grouping the existing items.
Grouped the first set of use cases – results are on the use case Wiki.
Grouped up through build system (10). Next week we will start at the build system.
Minutes 4/24/2012
Attendees:
Continue consolidating use cases:
Reviewed current groups
Going from the bottom up to group the less sorted
NDA (#38) – Agreed to refer to legal
Discussion on the “meeting license obligations use case” – has been discussed as “out of scope” for SPDX in previous discussions.
SPDX Lite – not really a use case, but it is a topic which affects many use cases – suggest to move to cross-cutting concerns
Stopped at #24 working from th bottom
Beta Feedback Meeting 7/7/2011
Attendees
HP - Scott Lamons
How well did the SPDX format cover information you need to exchange?
The most useful part for our review process is the higher level package information because we require product/project teams to enter information into our tracking system about the open source package they are using/distributing -- often these teams make mistakes or enter incomplete information. SPDX potentially provides a better and more trustworthy way for teams to enter this information into our system.
What was effort involved in converting to/from SPDX format?
Very straight forward using the tools that Gary provided although it might be helpful to have a GUI based tool for non-expert users. We did encounter a few bugs but I believe these have since been corrected.
Did the SPDX format help you understand what was in the software?
Yes, the spreadsheet format is well organized and easy to follow.
How did the standard license information work for you?
Can you see how using SPDX could save your organization time/money?
Are any changes needed to make SPDX meet your needs?
Separate package name and version fields would be helpful. Combining name and version into the PackageName field will require additional processing and interpretation which we would rather not do since our system has seperate fields for FOSS name and version.
Some corrections and comments in the specification are attached in MS Word format.
Issue: Spearate package name and version fields
Issue: Confusion/Disagreement over package level licenses - what they mean, how they should be used, what's important
Issue: Time it takes to do the analysis
Antelink -- Freddy Munoz
Additional issues:
Email blurb for recruiting beta sites
----------------------
As you may know, SPDX is a new standard for companies that need to exchange information about the open source licenses included in a software package. SPDX is being developed by dozens of organizations as a working group of the Linux Foundation. This standard will greatly streamline the disparate disclosure processes that exist through the software supply chain.
We Want You
We are looking for a few companies or organizations that would like to participate in the SPDX Beta Program. Beta participants will be asked to use the SPDX spec to exchange information with one of their trading partners (a supplier or a customer/user of their software) and provide feedback on the specification and the process.
You Can Count on Us
The SPDX support team will be helping you through the process – providing you with advice and information and gathering feedback on your experiences.
Be an SPDX Star
By participating in the Beta program, you can help further the SPDX initiative – reducing the time and effort involved to understand and analyze software for open source licenses.
Here are the potential beta sites so far:
HP
Wind River
Mentor Graphics
Motorola
Fedora
ASUS
Antelink
Alcatel-Lucent
See attachments. These are still a work in progress.
Here are the latest slides for the Beta Orientation
These are the final slides we used on the Beta call in PDF and PPT format.
Here is the recording from the Beta Orientation if anyone wants to listen/watch.
Attached is a draft of the technical training slide deck.
Feed back and/or revisions are welcome.
Here are potential events where we would like to have a talk on SPDX. We will create an abstract that anyone can use. If you are planning to be at one of these events (or an event that's not listed) and would like to submit a talk on SPDX, please let Kim know kim.weins@openlogic.com.
Here are the initial ideas for the rollout plan.
Frequently Asked Questions
General
Using the SPDX Spec
Licenses (i.e. the SPDX License List)
Tools
- The SPDX Group has developed some open source tools to assist with creation, viewing and validation of SPDX documents. The tools are intended to:
• Reduce the effort of creating, consuming and validating SPDX Documents
• Provide a translation from the technical document (e.g. RDF/XML or tag-value format) to a more readable format
• Provide a mechanism for validating SPDX documents
• Enable contributions and review of the tool implementation by the broader technical community through open source licensing- In addition, we expect that additional open source and proprietary tools will be created to help with these tasks.
- See the Tools page for more information and to download documentation.
Meeting Minutes for the Business Team are posted here:
Attendees
Agenda/Minutes
Agenda/Minutes 2010 Dec 9
1. Beta program
2. User content -didn't get to this
3. Outreach and evangelism - talked a little about this
Participants
Thoughts for Beta Program (for discussion)
Beta program
-Start with RC1 (Q1 sometime?)
-Need spec and license list available. PO - asked could we get started with license list incomplete?
-Ideally 3-5 trading partner pairs (assuming some will not complete it)
-They agree to designate at least one project where one partner will create an SPDX file and the other partner will receive and review it
-(they could do this in parallel with a “spreadsheet process”)
-They provide feedback on what worked, what didn’t, issues, questions
-SPDX group will provide support – available for ad-hoc and regular calls on technical or other issues
-Time period – feedback by Jun
-Want people willing to be quoted in announcement
-Try to get mix of use cases if possible (ex HP HW supplier and Linux distro, Mobile supply chain, Linux distro/upstream projects, consumer and supplier sides of supply chain)
-Where to find people
-SPDX members - Kim
-LF Member Council - Talk to Karen C or Rockett
-ELN - Mark Radcliffe
-Others we know of
To Dos
-Brainstorm list – divide and conquer to reach out
-Write up program info/email to solicit interest – Kim
-Presentation on beta program - Kim
-Set up conference call to present further & get organized
-Put together “beta support team”
-Need a “beta program manager”
-Need training/doc/how to for the beta sites (these will be beta docs for final release)
-Will need a beta email list
-What do we discuss/do at OSBC (Mark has speaking slot and can mention it, work with Matt to get separate seminar)), LF Collab Summit, ELN
-Mark R - can talk at qtrly wine dinner and ask
Brainstorm List of possible participants to approach
Attendees
Notes
Attendees
Agenda
Notes
Web site
Community outreach
2012 Goals
Agenda/Minutes 2011 Jan 06
1. Beta program - interested companies, next steps
2. User content - brainstorm list of content
3. Review Action Items
Participants
Notes
Action Items from last time
-Brainstorm list – divide and conquer to reach out - Done
-Write up program info/email to solicit interest – Kim - Done
-Presentation on beta program - Kim - Not done yet
-Set up conference call to present further & get organized - Kim to do
-Put together “beta support team”
-Need a “beta program manager”
-Need training/doc/how to for the beta sites (these will be beta docs for final release) - discuss on next call
-Will need a beta email list
-What do we discuss/do at OSBC (Mark has speaking slot and can mention it, work with Matt to get separate seminar)), LF Collab Summit, ELN
-Mark R - can talk at qtrly wine dinner and ask
Brainstorm List of possible participants to approach
Agenda/Minutes 2011 Jan 06
1. Beta program - review beta program slides
Participants
Notes
Agenda/Minutes 2011 Feb 17
1. Beta program update
2. Volunteers for beta coordinator
3. Beta materials
4. Product management question on tools reqts
Participants
Notes
Attendees
Process for Adding New Standard Licenses.
We did not finish discussion, so will continue at next meeting. Notes so far are below.
Attendees
BMW Questions -- We will add these to the FAQ in the Wiki
Kim to add these to FAQ in wiki and broadcast to various lists
Training
Process for Adding New Standard Licenses.
We did not finish discussion, so will continue at next meeting. Notes so far are below.
Attendees
Agenda --
Attendees
Agenda
Minutes
Attendees
Agenda
Attendees
Agenda
Minutes
Attendees
Agenda
Minutes
Attendees
Minutes
Jilayne Lovejoy, OpenLogic
Pierre Lapointe, nexB
Gary O'Neall, Source Auditor
Phil Odence, Black Duck
Scott Lamons, HP
Phil Koltun, Linux Foundation
Kirsten Newcomer, Black Duck
Steve Cropper, Cisco
Kim Weins on vacation, so Phil Odence held court
Press Release -
- various people trying to get quotes; contact person with Kim out is Jen Cloer from Linux Foundation
- no update on quotes from people on call
- see email from Kim on 7/27 (went direct to people who were going to get quotes)
FAq's
- different people have different sections: need to have done by time press release goes out
Website
- update from Kirsten: web team meeting and updating sandbox, not finished yet, want folks to start taking a look at sandbox (with understanding that it's a work in progress)
- link for comments in the sandbox on Blogs & Discussions page and "Web Site Refresh Forum" link on left side - add comments there; if you have privilege, you can also edit pages for content
- sandbox.spdx.org
LinuxCon Vancouver:
- Birds of a Feather session - probably more for informing new people than real working session, only 1 hour. Very few people from technical team attending event, so not enough time to real working session.
- Booth participation - have a booth space, Kim putting together signage. Need people to staff booth to talk to new people. Booth area open full-time throughout conference, important to have it staffed at breaks/meals in particular. John Ellis sent out an email to coordinate this - if you can help out, respond to John's email
Attendees
Agenda
Notes
Web site
Software Supply Chain Compliance and SPDX Meeting
Community Outreach
Events for 2012
Attendees
Agenda
Notes
Attendees
Agenda
Notes
Attendees
Agenda
Web site
End User Meeting
Attendees
Agenda
Web site
SPDX Forum: April 6
Collab Summit (April 3-5)
Attendees
Agenda
Attendees
Agenda
Minutes
Attendees
Agenda/Minutes
The Legal Team meets every other Wednesday at 8am Pacific Time US / 11am Eastern Time US time during the same weeks as the General Meeting. If you have any questions, email Jilayne Lovejoy at: jlovejoy@openlogic.com
Current issues/topics (this is a general list and may not touch upon everything) -- updated May 16
1) Mission/Vision statement
A) Legal Work Group - revised version posted in 5/16 meeting minutes - to be finalized on 5/30 call
B) License List description and overview -revised version posted in 5/16 meeting minutes - to be finalized on 5/30 call
2) Website updates and refresh
A) aligning language and updates on various parts of the current site:
B) Website refresh - fill in pages, link over content ?? need update from Mark Gisi on this
3) License List
A) License List updates for v1.16
B) OSI updates from emails (changes to v1.16) and then summarize outstanding issues - Jilayne, in progress
C) Other issues (see issues column on latest License List download for details - to start covering with v1.16 update)
D) Community outreach and list coordination
3) License Match Guidelines - pick up where we left off and complete
4) Formatting and "master list" for License List (i.e. actual license text files)
Currently the "master" consists of spreadsheet with list + individual .txt files for license text field = downloadable zip file. This is then converted into html pages for website. Peter, Gary, and Jilayne have had initial discussion on this issue; to be discussed further with more fleshed out proposal
A) PROPOSAL: License text files formatted in HTML instead of .txt files as default; can convert from there into text file with tool if people want that too; Option to use HTML to indicate some of matching rules?
B) For back-end management of License List overall: proposal to use and GIT repository in background for management - easier tracking of changes and gets it off Jilayne's desktop
4) Recommendations or guidance on how to best determine license for a particular file
how to identify the license for an open source project - ex. Within the file versus whether there's a copying file on top of the directory → provide guidance/suggstion (industry practice?) that license in the file is more determinate than the license in the directory
Should the legal group aggregate industry best practices and come up with a group of guidelines and provide some influence on that?
Requirements to submit:
To request a new license to be added to the SPDX License List, please submit to the legal workstream via SPDX-legal at lists.spdx.org the following information:
Method of approval:
This page includes the most recent version of the SPDX License List by version number and in spreadsheet format. Contents from this master spreadsheet are then published to: www.spdx.org/licenses
5 April 2012: new version of license list (v1.15) uploaded.
Notable changes:
Guidelines for SPDX License List nomenclature, fields, etc.:
The following information describes how each column/field is treated.
Full Name of License
License Identifier
Notes
OSI Approved?
Source/url
Standard License Header
Text
SPDX License List Match Guidelines
This documents provides guidelines for matching licenses to licenses found on the SPDX License List. There is no intent here to make a judgment or interpretation, but merely to ensure that when one SPDX user identifies a license as “BSD 3-clause,” for example, it is indeed the same license as what someone else identifies as “BSD 3-clause” and the same license as what is listed on the SPDX License List.
1. Whitespace
1.1 Purpose: By having a rule regarding whitespace, we avoid the possibility of a non-match due to different spacing of words, line breaks, or paragraphs
1.1.1 Guideline: All whitespace will be treated as a single blank space
2. Capitalization
2.1 Purpose: By having a rule regarding capitalization, we avoid the possibility of a non-match due to lower case or upper case letters in otherwise the same words
2.1.1 Guideline: All upper case and lower case letters will be treated as lower case letters
3. Punctuation
3.1 Purpose: Because punctuation can change the meaning of a sentence, punctuation needs to be included in the matching process
3.1.1 Guideline: Punctuation must be matched.
4. Bullets and Numbering
4.1 Purpose: By having a rule regarding bullets and number, we avoid the possibility of a non-match due to the otherwise same license using bullets instead of numbers for a list of clauses.
4.1.1 Guideline: Where a line starts with a bullet, numbering, or some form of a list item, ignore the list item.
5. Varietal Word Spelling
5.1 Purpose: English uses different spelling for some words. By identifying the spelling variations for words found or likely to be found in licenses, we avoid the possibility of a non-match due to the same word being spelled differently. This list is not meant to be an exhaustive list of all spelling variations, but meant to capture the words most likely to be found in open source software licenses.
5.1.1 Guideline: The words in the following columns are considered equivalent and interchangeable:
| Column 1 | Column 2 |
| 1. Acknowledgement 2. Analog 3. Analyze 4. Artifact 5. Authorization 6. Authorized 7. Caliber 8. Canceled 9. Capitalizations 10. Catalog 11. Categorize 12. Center 13. Emphasized 14. Favor 15. Favorite 16. Fulfill 17. Fulfillment 18. Initialize 19. Judgement 20. Labeling 21. Labor 22. License 23. Maximize 24. Modeled 25. Modeling 26. Offense 27. Optimize 28. Organization 29. Organize 30. Practice 31. Program 32. Realize 33. Recognize 34. Signaling 35. Utilization 36. While 37. Wilfull 38. Noncommercial 39. Percent | 1. Acknowledgment 2. Analogue 3. Analyse 4. Artefact 5. Authorisation 6. Authorised 7. Calibre 8. Cancelled 9. Capitalisations 10. Catalogue 11. Categorise 12. Centre 13. Emphasised 14. Favour 15. Favourite 16. Fulfil 17. Fulfilment 18. Initialise 19. Judgment 20. Labelling 21. Labour 22. Licence 23. Maximise 24. Modelled 25. Modelling 26. Offence 27. Optimise 28. Organisation 29. Organise 30. Practise 31. Programme 32. Realise 33. Recognise 34. Signalling 35. Utilisation 36. Whilst 37. Wilful 38. Non-commercial 39. Per cent |
6. Copyright Symbol
6.1 Purpose: By having a rule regarding the use of “©”, “(c)”, or “copyright,” we avoid the possibility of a mismatch based on these variations.
6.1.1 Guideline: “©”, “(c)”, or “Copyright” will be considered equivalent and interchangeable
7. Copyright Notice
7.1 Purpose: To avoid a license mismatch merely because the copyright notice (usually found above the actual license text) is different. The copyright notice is important information to be recorded elsewhere in the SPDX file, but for the purposes of matching a license to the SPDX License List, it should be ignored because it is not part of the substantive license text.
7.1.1 Guideline: Ignore copyright notices. A copyright notice consists of the following elements, for example: "2012 Copyright, John Doe. All rights reserved." or "(c) 2012 John Doe."
pick up here at 15 Feb 2012 Legal Workstream call
8. License Headers
8.1 Purpose: To identify standard headers that are used to indicate a particular license. These could be specific headers mandated by the license itself or common shorthand ways to indicate the license. (e.g. “This file is licensed under GPL v2.” can then be matched to GPL v2... (need to identify what theses might be and come up with a list.... TBD
8.1.1 Guideline:
9. Verbatim Text
9.1 Purpose: To ensure that when matching licenses to the SPDX License List, the substantive text of the license is the same balanced against disregarding parts of the text that do not alter the substantive text. A conservative approach is taken in regards to rules about replaceable text here.
9.1.1 Guideline: License text must be the same verbatim text (except for the rules stated here). The text must be in the same order, e.g., differently ordered paragraphs would not be considered a match.
9.1.2 Guideline: Certain oft-used licenses (i.e. BSD, Apache 1.1) have inline text that refers to the copyright holder or author generically. Sometimes the actual name of a company or individual is used, yet the rest of the license is exactly the same as a generic version. Where text is highlighted in the licenses below, that highlighted text can be ignored when determining a match. This rule only applies to the licenses and highlighted text identified below:
SPDX Metadata is licensed under the CC0 1.0 Universal public domain dedication with the following preamble. A link to the license is included below. ***
Preamble
The SPDX specification requires populating the SPDX fields with certain data related to such fields. In addition, the SPDX specification also contains numerous fields where an SPDX author may provide relevant explanatory text. These data and explanatory information are the “SPDX-Metadata”. Without opining on the lawfulness of "database rights" (in jurisdictions where applicable), such explanatory text is copyrightable subject matter in most Berne Convention countries.
By using the SPDX specification, or any portion hereof, you hereby agree that any copyrightable work (as determined by your jurisdiction) in any SPDX-Metadata, including without limitation explanatory text, shall be subject to the terms of the Creative Commons CC0 1.0 Universal license (reproduced in its entirety below).
Further, for SPDX-Metadata not containing any copyrightable work, you hereby agree and acknowledge that the SPDX-Metadata is provided to you "as-is" and without any representations or warranties of any kind concerning the SPDX-Metadata, express, implied, statutory or otherwise, including without limitation warranties of title, merchantability, fitness for a particular purpose, non-infringement, or the absence of latent or other defects, accuracy, or the present or absence of errors, whether or not discoverable, all to the greatest extent permissible under applicable law.
Overview
SPDX files represent a summary of license information extracted from software source code. The SPDX Legal working group evaluated different licenses that can be used to cover the data contained in a SPDX file. One challenge was that the working group did not want to imply that the data contained in a SPDX file is potentially copyright protected. On the other hand, in some jurisdictions, data could be considered intellectual property. In those jurisdictions the working group stride to provide a license that mitigates the risk of someone obtaining controlling IP rights over SPDX data. The following were the core requirements driving the license evaluation process. We sought a license that:
After careful consideration the Creative Commons Zero 1.0 Universal license was chosen. The rationale for each of the license candidates considered can be found below.
License Candidates:
Public Domain Dedication and License (PDDL)
PDDL is the current designated license for SPDX files as required by the SPDX 1.0 specification. PDDL was initially chosen because it was a “data” license. That is, it was initially design to be used with data as opposed to software or other copyrightable works. The reception of PDDL as the SPDX file data license has been mixed and somewhat controversial at times. A copy of the PDDL license can be found here: PDDL link.
MIT Style SPDX Draft
The license text is based on the MIT open source license. A copy of the MIT Style license draft can be found in the appendix of this document.
CC0 1.0 - Universal Public Domain Dedication license
Creative Commons (CC) is a non-profit organization devoted to expanding the range of creative works available for others to build upon legally and to share. The organization has released several copyright-licenses known as “Creative Commons” licenses, free of charge to the public. One such license is the CC0 1.0 which allows one to contribute their work to the public domain. A copy of the PDDL license can be found here: CC0 1.0 link.
No License Provided
One option is to take the position that no license applies.
Does not prevent one from trying to obtain controlling rights in jurisdictions where data is potentially considered intellectual property.
Meeting Minutes for the Legal Team are posted here:
SPDX License Meeting Notes – 9/24/2010
Attendance
Kate Stewart
Kim Weins (OpenLogic
Dave McLoughlin (OpenLogic)
Peter Williams (OpenLogic)
Jilayne Lovejoy (OpenLogic)
Manny Wool (BlackDuck)
Mike Herzog (NexB)
Jeff Luszcz (Palamida)
Dan German
Notes:
Participants
We spent the whole call discussing how to handle Python licensing. Tom iIncorvia did a bunch of research on the Python license. Essentially it was owned by 3 different groups prior to the Python Software Foundation - CWI, CNRI, BeOpen. This happened as the primary author, Guido van Rossum, moved from company to company.
As the owner changed, the license changed, so there are several licenses that apply to different components of Python. In addition, there appear to be tweaks to the license terms with each release, even when the owner did not change.
On the call, we determined that we should separate the Python licenses into separate licenses in the list. However, we also felt that more research was required to see if different Python licenses might apply simultaneously to a single version.
Note:
After the call, I did further research to determine that there are, in fact, multiple licenses that can apply to any version of Python -- with older code under older licenses and newer code under the PSF license.
From the PSF website http://www.python.org/psf/summary/
"(1) In the earlier days of Python, employee contracts and related law ensured that the organizations that released Python under the various licenses had the rights to the code that was added in each release. The open source licenses used by those organizations granted all the necessary rights to the world in general, which of course includes the PSF. The only significant right the PSF does not have to this code is to re-license it. This is the reason for the continued existence of the older licenses in the license stack. Since some of the organizations involved no longer exist, it is unlikely that the PSF could obtain relicensing rights in the future. Thus, the older licenses cannot be removed from the license stack."
We will revisit this topic at the next meeting.
The meeting was attended by:
Discussion
Python
Older licenses
zlib/libpng license
GPL exceptions
GPLv3 Section 7
Finalizing the license list
Going forward
Legal Worksteam Meeting Minutes - 20101215
SPDX Legal Worksteam Meeting Minutes – 15-December-2010
Attendees:
Esteban Rockett (Motorola)
Kate Stewart (Canonical)
Kim Weins (OpenLogic)
Phil Odence (Blackduck)
Amanda Brock (Canonical)
Andrew Sinclair (Canonical)
Karen Copenhaver (Linux Foundation)
Scott Peterson (HP)
Tom Incorvia (Microfocus)
Allison Randal (Python Software Foundation, The Perl Foundation, Canonical)
Mansour Ghomeshi (Motorola)
McCoy Smith (Intel)
Soeren Rabenstein (Asus)
Paul Madick (HP)
Jilayne Lovejoy (OpenLogic) Andy Wilson (Intel)
Terry Ilardi (IBM)
Michael Herzog (NexB)
Minutes:
Legal Worksteam Meeting Minutes - 20110112
SPDX Legal Worksteam Meeting Minutes – 12-January-2011
Attendees:
Esteban Rockett (Motorola)
Kate Stewart (Canonical)
Kim Weins (OpenLogic)
Peter Williams (OpenLogic)
Mark Gisi (WindRiver)
Paul Madick (HP)
Scott Peterson (HP)
Jilayne Lovejoy (OpenLogic)
Tom Incorvia (Microfocus)
Andy Wilson (Intel)
Scott Lamons (OpenLogic)
Michael Herzog (NexB)
Karen Copenhaver (Linux Foundation)
Minutes:
A. Review of December Meeting Minutes - Team was asked to review December meeting minutes by 20-Jan-2011; for approval at meeting scheduled for 26-Jan-2011.
B. "Create Process/Method to Add Licenses" - Team agreed with moving the process/method to created/add new licenses (to the standard SPDX license list) to the SPDX Business Workstream.
C. SPDX Metadata License - Team agreed to pick a default license for the SPDX metadata, such default license to be agreed by this team and Linux Foundation Member counsel. BSD-based/MIT-like was the general consensus. Whether additional proprietary licenses would be allowed was tabled, pending the decision on the default metadata license. Rockett and Karen Copenhaver to lead.
D. Required use of Standard License Acronyms - Michael Herzog proposed that this requirement be limited to those publishing SPDX metadata. No objections from the team.
E. Issue raised from Tech Workstream on the need for a Legal Policy on "SPDX Not Validating License Recited" - This topic lead into a detailed discussion of "objective" verse "subjective" metadata. A second meeting was scheduled for 14-Jan-2011 to conclude this issue. See minutes from 14-Jan-2011 meeting.
Legal Worksteam Meeting Minutes - 20110114
SPDX Legal Worksteam Meeting Minutes – 14-January-2011
Attendees:
Esteban Rockett (Motorola)
Kate Stewart (Canonical)
Kim Weins (OpenLogic)
Peter Williams (OpenLogic)
Scott Peterson (HP)
Jilayne Lovejoy (OpenLogic)
Tom Incorvia (Microfocus)
Michael Herzog (NexB)
Phil Odence (BlackDuck)
Minutes:
- This meeting was a continuation of "Item E" from the regular Legal Workstream Meeting of 12-Jan-2011.
- Subject to refining terminology (where attendees will email terminology/minor revisions or do so on Bugzilla), attendees agreed to the following:
***
(minor edits consistent with meeting done below by Rockett)
Proposal: section 5.3 (License(s)) of the spec will
become 3 fields:
5.3a Asserted/Concluded License
5.3a.1 Purpose: This field contains the license
governing the file if it can be determined. If no license
information can be determined, the license is denoted as
"Unknown". The licenses should use the standard short
form names. See Appendix I for standardized license short
forms. If a Asserted/Concluded License is not one of the
standardized license short forms, this field must contain a
reference to the full licenses text included in this SPDX
file in section 4. If more than one license is asserted/concluded in
the file, then each should be listed. If any of the
asserted/concluded licenses offer the recipient a choice of licenses,
then each of the choices will be declared as a "disjunctive"
license.
5.3a.2 Intent: Here, the intent is to have a uniform
method to refer to the license that is determined to
represent the file with specificity to eliminate any license
confusion. For example, the 3 clause BSD would have a
different license identifier then the 4 clause BSD.
5.3a.3 Cardinality: Mandatory, one.
5.3a.4 Tag: "LicenseAsserted:"
5.3a.5 RDF: TBD (include Disjunctive form here)
5.3a.6 Data Format: <short form identifier in
Appendix I> | "FullLicense"-N
5.3a.7 Example:
LicenseAsserted: GPL-2.0
5.3b Detected License(s)
5.3b.1 Purpose: This field contains the license recited
in the file, if any. It will be explicit
from the file header or other information found in the
file's source code. If no license information is found
it should be denoted as "NotSpecified". If no license
information can be determined, the license is denoted as
"Unknown". The licenses should use the standard short
form names. See Appendix I for standardized license short
forms. If a Detected License is not one of the
standardized license short forms, this field must contain a
reference to the full licenses text included in this SPDX
file in section 4. If more than one license is detected in
the file, then each should be listed. If any of the
detected licenses offer the recipient a choice of licenses,
then each of the choices will be declared as a "disjunctive"
license.
5.ba.2 Intent: Here, the intent is to have a uniform
method to refer to each license with specificity to
eliminate any license confusion. For example, the 3 clause
BSD would have a different license identifier then the 4
clause BSD.
5.3b.3 Cardinality: Mandatory, one or many.
5.3b.4 Tag: "LicenseDetected:"
5.3b.5 RDF: TBD (not including disjunctive form, if
multiple many should be specified )
5.3b.6 Data Format: <short form identifier in
Appendix I> | "FullLicense"-N
5.3b.7 Example:
LicenseDetected: GPL-2.0
LicenseDetected: FullLicense-2
5.3c License Comments
5.3c.1 Purpose: This field is a detailed description
of the analysis and any relevent background references that
went in to making the asserted license for a file, if the
asserted/concluded license does not match the detected license that
the person creating the SPDX file wants to share with the
reviewers.
5.3c.2 Intent: Here, the intent is to provide
technical readers/reviewers with a detailed technical
explanation of how the asserted license was determined if it
does not match the detected license.
5.3c.3 Cardinality: Optional, single instance
5.3c.4 Tag: "LicenseComments:"
5.3c.5 RDF: TBD
5.3c.6 Data Format: free form text than can span
multiple lines, preceded with <text> and ending with
</text>.
5.3c.7 Example: LicenseComments: <text> The
asserted license was taken from the package level that the
file was included in. </text>
***
SPDX Legal Team Meeting Minutes – 26-January-2011
Attendees:
Esteban Rockett (Motorola)
Jilayne Lovejoy (OpenLogic)
Tom Incorvia (Microfocus)
Mark Gisi (WindRiver)
Steve Grandchamp (OpenLogic)
Andy Wilson (Intel)
Steve Mc (OpenLogic)
Paul Madick (HP)
Kate Stewart (Canonical)
Phil Odence (BlackDuck)
Michael Herzog (NexB)
Minutes:
- This meeting focused on revising the text of Section 5.3 consistent with the meeting of 14-January-2011.
- The text discussed is below.
- Workstream members are requested to review and provided comments and/or bring comments to the next meeting scheduled for 9-February-2011.
***
Proposal: Section 5.3 (License(s)) of the SPDX Specification will become 3 fields:
5.3a Concluded License(s)
5.3a.1 Purpose: This field contains the license the reviewer has concluded as governing the file, if it can be determined. The options to populate this field are limited to: (a) the SPDX standardized license short form identifier; this should be used when the concluded license is on the SPDX standardized license short list; (b) a verbatim copy of the concluded license when the concluded license is not on the SPDX standardized license short list (“non-standard license”); (c) “UNDETERMINED”; this should be used (i) if the reviewer has attempted to but cannot reach a reasonable objective determination of the concluded license, or (ii) if the reviewer is uncomfortable concluding a license, despite some license information being available; or (d) left blank; this should be used if the reviewer has made no attempt to arrive at a concluded license. With respect to “a” and “b” above, if there is more than one concluded license, all should be recited. If the recipient has a choice of multiple licenses, then each of the choices should be recited as a "disjunctive" license. With respect to “c”, a written explanation must be provided in the License Comments field below. Lastly, if the Conclude License(s) conflicts with the License Information in File, a written explanation must be provided in the License Comments field below.
5.3a.2 Intent: Here, the intent is to have the reviewer analyze the License Information in File and other objective information, e.g., “COPYING FILE”, etc., together with the results from any scanning tools, to arrive at a reasonably objective conclusion as to what license is governing the file.
5.3a.3 Cardinality: Mandatory, one or many.
5.3a.4 Tag: "LicenseConcluded:"
5.3a.5 RDF: TBD (include Disjunctive form here)
5.3a.6 Data Format: <short form identifier in Appendix I> | "FullLicense"-N | UNDETERMINED | (left blank)
5.3a.7 Example:
LicenseConcluded: GPL-2.0
5.3b License Information in File
5.3b.1 Purpose: This field contains the license information actually recited in the file, if any. Any license information not actually in the file, e.g., “COPYING FILE”, etc., should not be reflected in this field. This information is most commonly found in the header of the file, although it may be in other areas of the actual file. The options to populate this field are limited to: (a) the SPDX standardized license short form identifier; this should be used when the license is on the SPDX standardized license short list and has no ambiguous or superfluous text; (b) a verbatim copy of the license information the file when the license information in the file is not on the SPDX standardized license short list (“non-standard license”); (c) “NONE”; this should be used if the actual file contains no license information; or (d) left blank; this should be used if the reviewer has not examined the contents of the actual files. With respect to “a” and “b” above, if license information for more than one license is recited in the file, all should be reflected in this field. If the license information offers the recipient a choice of licenses, then each of the choices should be recited as a "disjunctive" licenses.
5.ba.2 Intent: Here, the intent is to provide the reader with the license information actually in the file, as compared to the Concluded License field.
5.3b.3 Cardinality: Mandatory, one or many.
5.3b.4 Tag: "LicenseInformation:"
5.3b.5 RDF: TBD (not including disjunctive form, if multiple many should be specified )
5.3b.6 Data Format: <short form identifier in Appendix I> | "FullLicenseInformation"-N | NONE | (left blank)
5.3b.7 Example:
LicenseInformation: GPL-2.0
LicenseInformation: FullLicenseInformation
5.3c License Comments
5.3c.1 Purpose: This field is a detailed description of the analysis and any relevent background references that went in to arriving at the Concluded License(s) for a file. If the Concluded License(s) does not match the License Information in File, such rationale must be recited by the reviewer in this field. This field is also where an explanation must be recited if the reviewer placed “UNDETERMINED” as the Conclude License(s).
5.3c.2 Intent: Here, the intent is to provide the reader with a detailed explanation of how the Concluded License(s) was determined if it does not match the License Information in File, is marked “UNDETERMINED”, or other helpful information for the reader relevant to determining the license of the file.
5.3c.3 Cardinality: Optional, single instance
5.3c.4 Tag: "LicenseComments:"
5.3c.5 RDF: TBD
5.3c.6 Data Format: free form text than can span multiple lines, preceded with <text> and ending with </text>.
5.3c.7 Example: LicenseComments: <text> The Concluded License(s) was taken from the package level that the file was included in. This information was found in the COPYING.txt file in the xyz directory. </text>
***
SPDX Legal Team Meeting Minutes – 9-February-2011
Attendees:
Esteban Rockett (Motorola)
Karen Copenhaver (LF/Choate)
Jilayne Lovejoy (OpenLogic)
Kim Weins (OpenLogic)
Tom Incorvia (Microfocus)
Mark Gisi (WindRiver)
Kate Stewart (Canonical)
Phil Odence (BlackDuck)
Scott Peterson (HP)
Minutes:
- This meeting focused on finalizing the text of Section 5.3. The final text is below.
- Lastly, logistics for "housekeeping matters", namely the License Template, default license for the SPDX metadata, and suggested license for SPDX tools, were discussed. More to come on those items in the meetings to follow.
- The next meeting is scheduled for 2-March-2011, when many will be in Boston for the Project Harmony meeting.
***
Final Draft: Section 5.3 (License(s)) of the SPDX Specification will become 3 fields:
5.3a Concluded License(s)
5.3a.1 Purpose: This field contains the license the reviewer has concluded as governing the file, if it can be determined. The options to populate this field are limited to: (a) the SPDX standardized license short form identifier; this should be used when the concluded license is on the SPDX standardized license short list; (b) a verbatim copy of the concluded license when the concluded license is not on the SPDX standardized license short list (“non-standard license”); (c) “UNDETERMINED”; this should be used (i) if the reviewer has attempted to but cannot reach a reasonable objective determination of the concluded license, or (ii) if the reviewer is uncomfortable concluding a license, despite some license information being available; or (d) left blank; this should be used if the reviewer has made no attempt to arrive at a concluded license. With respect to “a” and “b” above, if there is more than one concluded license, all should be recited. If the recipient has a choice of multiple licenses, then each of the choices should be recited as a "disjunctive" license. With respect to “c”, a written explanation must be provided in the License Comments field below. Lastly, if the Conclude License(s) conflicts with the License Information in File, a written explanation must be provided in the License Comments field below.
5.3a.2 Intent: Here, the intent is to have the reviewer analyze the License Information in File and other objective information, e.g., “COPYING FILE”, etc., together with the results from any scanning tools, to arrive at a reasonably objective conclusion as to what license is governing the file.
5.3a.3 Cardinality: Mandatory, one or many.
5.3a.4 Tag: "LicenseConcluded:"
5.3a.5 RDF: TBD (include Disjunctive form here)
5.3a.6 Data Format: <short form identifier in Appendix I> | "LicenseConcluded"-N | UNDETERMINED | (left blank)
5.3a.7 Example:
LicenseConcluded: GPL-2.0
LicenseConcluded: FullLicenseInformation
5.3b License Information in File
5.3b.1 Purpose: This field contains the license information actually recited in the file, if any. Any license information not actually in the file, e.g., “COPYING FILE”, etc., should not be reflected in this field. This information is most commonly found in the header of the file, although it may be in other areas of the actual file. The options to populate this field are limited to: (a) the SPDX standardized license short form identifier; this should be used when the license is on the SPDX standardized license short list and has no ambiguous or superfluous text; (b) a verbatim copy of the license information the file when the license information in the file is not on the SPDX standardized license short list (“non-standard license”); (c) “NONE”; this should be used if the actual file contains no license information; or (d) left blank; this should be used if the reviewer has not examined the contents of the actual files. With respect to “a” and “b” above, if license information for more than one license is recited in the file, all should be reflected in this field. If the license information offers the recipient a choice of licenses, then each of the choices should be recited as a "disjunctive" licenses.
5.ba.2 Intent: Here, the intent is to provide the reader with the license information actually in the file, as compared to the Concluded License field.
5.3b.3 Cardinality: Mandatory, one or many.
5.3b.4 Tag: "LicenseInfoInFile:"
5.3b.5 RDF: TBD (not including disjunctive form, if multiple many should be specified )
5.3b.6 Data Format: <short form identifier in Appendix I> | "LicenseInfoInFile"-N | NONE | (left blank)
5.3b.7 Example:
LicenseInfoInFile: GPL-2.0
LicenseInfoInFile: FullLicenseInformation
5.3c License Comments
5.3c.1 Purpose: This field is a detailed description of the analysis and any relevant background references that went in to arriving at the Concluded License(s) for a file. If the Concluded License(s) does not match the License Information in File, such rationale must be recited by the reviewer in this field. This field is also where an explanation must be recited if the reviewer placed “UNDETERMINED” as the Conclude License(s).
5.3c.2 Intent: Here, the intent is to provide the reader with a detailed explanation of how the Concluded License(s) was determined if it does not match the License Information in File, is marked “UNDETERMINED”, or other helpful information for the reader relevant to determining the license of the file.
5.3c.3 Cardinality: Optional, single instance
5.3c.4 Tag: "LicenseComments:"
5.3c.5 RDF: TBD
5.3c.6 Data Format: free form text than can span multiple lines, preceded with <text> and ending with </text>.
5.3c.7 Example: LicenseComments: <text> The Concluded License(s) was taken from the package level that the file was included in. This information was found in the COPYING.txt file in the xyz directory. </text>
***
SPDX Legal Team Meeting Minutes – 02-March-2011
Attendees:
Esteban Rockett (Motorola)
Karen Copenhaver (LF/Choate)
Kim Weins (OpenLogic)
Jilayne Lovejoy (OpenLogic)
Tom Incorvia (Microfocus)
Phil Odence (Blackduck) Paul Madick (HP)
Kate Stewart (Canonical)
Michael Herzog (NexB)
Scott Peterson (HP)
**
- At Kate's suggestion, in revised Section 5.3, the following changes were agreed:
(1) change "License Information in File" TAG VALUE from "License Information:" to "LicenseInfoInFile:"; and
(2) normalize "Standard and Non-Standard License Information" across all Section 5.3 fields.
- Other minor suggested revisions to the Section 5.3 "field names" were discussed, but then withdrawn.
***
SPDX Legal Team Meeting Minutes – 09-March-2011
Attendees:
Esteban Rockett (Motorola)
Karen Copenhaver (LF/Choate)
Jilayne Lovejoy (OpenLogic)
Tom Incorvia (Microfocus)
Phil Odence (Blackduck)
Andy Wilson (Intel)
Michael Herzog (NexB)
Scott Peterson (HP)
**
- This meeting was limited to discussion of the below proposals:
- The Apache 2.0 license was proposed as the license for all tools created by the SPDX group, inclusive of shell scripts.
- Further, the Apache 2.0 license was proposed as the suggested license to 3rd parties for any 3rd party desiring to open source a SPDX tool.
- All in attendance were in agreement to the above. No objections.
***
SPDX Legal Team Meeting Minutes – 23-March-2011
Attendees:
Esteban Rockett (Motorola)
Jilayne Lovejoy (OpenLogic)
Karen Copenhaver (LF/Choate)
Tom Incorvia (Microfocus)
Phil Odence (Blackduck) Paul Madick (HP)
Kate Stewart (Canonical)
Michael Herzog (NexB)
Scott Peterson (HP)
**
Minutes:
- The group re-reported that the SPDX Tools License is concluded to be Apache 2.0. Further, the SPDX team will recommend that any 3rd party desiring to open source SPDX tools, also license such 3rd party tools under the Apache 2.0 license. No objections.
- Kate confirmed that revised section 5.3 was being placed into the SPDX Beta Specification.
- Discussions began on "whether there is a need for the Author/Creator" field.
- A changelog approach to revisions of SPDX metadata was initially suggested by Kate. Tom and others substantially added.
- The "Confidentiality Statement/Field" was discussed, and generally agreed, but no specific implementation(s) was been concluded.
- Update on the "Templatizing" effort was given. See http://spdx.org/wiki/guidelines-templatizing-licenses
- It was suggested that we provide a public facing site of all known SPDX tools, when such tools are available.
***
SPDX Legal Team Meeting Minutes – 13-April-2011
Attendees:
Esteban Rockett (Motorola)
Jilayne Lovejoy (OpenLogic)
Karen Copenhaver (LF/Choate)
Tom Incorvia (Microfocus)
Phil Odence (Blackduck) Paul Madick (HP)
Kate Stewart (Canonical)
Michael Herzog (NexB)
Scott Peterson (HP)
Andy Wilson (Intel)
**
Minutes:
- Reports from FSFE Conference (Amsterdam) and Linux Foundation Summit (San Francisco) were given by workstream representatives. Comments, reactions, and support from all events was extremely positive. Most notably, Eben Moglen, Mark Radcliff, and Bradley Kuhn have also given their support for SPDX.
- The 3 big issues for the next few months were then opened for discussion. Those issues are:
(1) The "licensing/legal terms/disclaimer" for the SPDX meta-data;
(2) Method to revise SPDX metadata, including the option of using a changelog; and
(3) Confidentiality-state of SPDX metadata.
- Discussion on all 3 of the above began.
- Karen and Rockett introduced the team to the Open Data Commons PDDL 1.0 (http://www.opendatacommons.org/licenses/pddl/1.0/) as a potential candidate to resolve #1 above.
- Discussion of the above topics to be continued at the next meeting.
***
SPDX Legal Team Meeting Minutes – 20-April-2011
Attendees:
Esteban Rockett (Motorola)
Jilayne Lovejoy (OpenLogic)
Karen Copenhaver (LF/Choate)
Tom Incorvia (Microfocus)
Phil Odence (Blackduck)
Paul Madick (HP)
Kate Stewart (Canonical)
Michael Herzog (NexB)
Scott Peterson (HP)
Andy Wilson (Intel)
**
Minutes:
- The group continued to drive on the below key issues:
(1) The "licensing/legal terms/disclaimer" for the SPDX meta-data;
(2) Method to revise SPDX metadata, including the option of using a changelog; and
(3) Confidentiality-state of SPDX metadata.
- For #3 above, the group concluded that both a mandatory "radio-button" style confidentiality feature should be included in the specification, with an optional open text field for additional text, if needed.
- For #2, the group began discussing the Open Data Commons PDDL 1.0 (http://www.opendatacommons.org/licenses/pddl/1.0/), and other alternative approaches. Creative Commons was re-visited and explained that CC is problematic if the author/creator can be anonymous as previously agreed.
***
SPDX Legal Team Minutes - 10-August-2011
Attendees:
Esteban Rockett, Motorola
Kim Weins, OpenLogic
Peter Williams, OpenLogic
Kirsten Newcomer, Black Duck
Bill Schneiller, Black Duck
Tom Incorvia, Microfocus
Jack Manbeck
Terry Ilardi, IBM
Adam Cohn, Cisco
Kate Stewart, Canonical
Jack Manbeck, TI
Michael Herzog, NexB
Gary O'Neal, Source Auditor
Jordan Hatcher, ARM
Jilayne Lovejoy, OpenLogic
Agenda:
- focus on review and comments to the below draft SPDX Trademark license
- further discussion re: confidentiality of spec as between users
-- Rockett circulated the proposed trademark license text prior to meeting, copied here:
---
SPDX Trademark License
The SPDX and Software Package Data Exchange trademarks (collectively, SPDX Trademarks) are owned by the SPDX Workgroup, which is sponsored by the Linux Foundation (LF). LF holds the SPDX Trademarks in trust for the SPDX Workgroup. The SPDX Workgroup hereby grants you a royalty-free, non-exclusive, non-assignable, non-transferable, non-sublicensable, world-wide license to use its SPDX Trademarks in connection with files containing software licensing information if you:
(i) solely use the SPDX Trademarks in connection with files containing all of the SPDX Mandatory Fields as defined in the applicable version of the SPDX specification;
(ii) solely uses the SPDX Trademarks in connection with files that do not utilize additional fields, unless such additional fields are “Optional Fields” as defined in the applicable version of the SPDX specification;
(iii) recite the applicable SPDX Specification version in, or with, your use of any of the SPDX Trademarks; and
(iv) fully comply with (a) the SDPX Specification and (b) the license (Creative Commons Attribution License 3.0 (also known as CC-BY-3.0)) under which the SPDX Specification is offered in its entirety.
This SPDX TM License shall automatically be revoked in perpetuity if you fail to comply with any of the above requirements. A revoked SPDX TM License may only be restored by (i) you submitting a petition for restoration to the Legal Team of the SPDX Workgroup (Legal Team), (ii) attending any required meetings for inquiry in the circumstances, and (iii) a consensus of the Legal Team to restore your license.
---
MEETING:
- Rockett went through the trademark license and gave an overview of the what/why of each part
-- CC-BY-3.0 version issue: (raised via email prior to meeting) CC licenses currently have ports to various jurisdictions, so you need to identify the jurisdiction type. I'm not sure what we are using, but if it is the Unported (raw) version, then suggest we slightly tweak it and change the reference to " Creative Commons Attribution 3.0 Unported License"
- DECISION: add "Unported" to designation in spec;
-- Discussion about meaning of compliance with CC license: current license only requires attribution (but still could sell it)
- Discussion on whether we want to allow selling it - okay b/c might be case where spec is built into a tool or larger product
-- Clarification: CC applies to spec itself, whereas PddL covers the SPDX file itself
- DECISION: Should add to (iv)(a) - the SPDX Specification authored/published by the SPDX Working Group and provide url location of spec
-- Also need to specify where and how to do the attribution (CC license assumes author will designate this) and include this info in the spec (and trademark license?)
- Give a couple versions of this for full compliance versus based-on-SPDX scenario?
- DECISION: Rockett to make a cut on this and circulate to Legal and Technical and then let people comment with goal of closing on this during General Call tomorrow
-- Section (ii) issue: (raised via email prior to meeting) This requirement provides no value and does significant harm to future prospects of SPDX. It will stifle innovation by making experimentation with new fields and types of data illegal. It also will drive people out of the SPDX community if they have business requirements that not meet by the current version of SPDX. In both of these cases we should actively encourage people to extend SPDX to their needs. We can use information resulting from such experimentation to guide improvements in future versions. Some might be concerned that allowing data other than that in the specification will cause technical problems with interoperability butthis is not a problem. RDF is designed to support safe and easy extension so SPDX data encoded in RDF will be readable by any compliant SPDX consumer regardless of any extra "fields" that are included. The syntax of tag format does not allow any ad hoc extensions at all so consumers of the tag format are also safe.
- Discussion/concerns/comments raised:
-- most standard groups allow people to add other fields
-- what about tag values and interoperability ‚Üí nothing enforceable and could have potential diversions
-- some of extensions that could be added could veer into "making an interpretation" that we have tried to avoid and these fields could be added without review
-- but anyone who added a field, doesn't mean field gets added to the spec
-- if add field, then person getting SPDX file may assume its part of spec
-- Currently, users can put other ideas into various existing free form comment fields
- Want to allow extensibility over time - how to do this? May be that optional fields will grow faster than mandatory fields. Want ability to have user defined fields → how to do this requires later more in depth discussion…
- the boundaries of change are spec issues, not trademark license discussion - trademark license need only be flexible enough to refer to spec and quality guidelines therein, while balancing trademark law concern with quality control
- Fields in spec now are "mandatory" or "optional" - can be interpreted different ways, but by being specific, could be limiting, if add other language to allow room for adding other fields in future with less confusion
-- DECISION: put an "out" in clause (ii) - "as defined in applicable version of the SPDX… or as extensions as defined…" - Rockett to draft something and table larger discussion of whether, and how to change spec to allow additional fields (what, if anything, and how much and how you can modify it)
-- Interplay of confidentiality and SPDX: idea of labelling SPDX file as confidential raises concern that that labelling would only impact the parties to the NDA and downstream recipients would still see the label and shouldn't have to be concerned under PddL. Downstream recipients may treat it as confidential or not.
- No confidentiality field at all right now (was previously and just decided to drop this field) - no place to enter this in section 2, SPDX Information. Parties would use a separate confidentiality agreement to achieve this goal, i.e. outside wrapper, you come up with this on your own, not part of SPDX spec or file itself
- How do we allow parties to have confidentiality, but non-parties not see the label?
-- DECISION: Defer to technical team to propose solutions for next version of spec?
SPDX Legal Team Meeting Minutes - 24-August-2011
Attendees:
Esteban Rockett, Motorola Mobility
Kim Wiens, OpenLogic
Michael Herzog, NexB
Phil Odence, BlackDuck
Mark Gisi, WindRiver
Tom Incorvia, Microfocus
Nichlos (protocode)
Paul Maddock, HP
Jilayne Lovejoy, OpenLogic
Karen Copenhaver, Choate
Adam Cohen, Cisco
Update on how LinuxCon went - announcement on Wednesday; session on Thursday and birds of a feather on Thursday evening
SPDX Legal Workstream Minutes - 7-September-2011
Attendees:
- The Modified MIT license (prepared by Karen Copenhaver) was discussed at length.
- The agreed that adoption of SPDX was more important than safeguarding against european database statues.
- CC-0 was re-introduce as a candidate for the metadata license. The group agreed to re-visit at the next bi-weekly meeting.
SPDX Legal Team Meeting Minutes - 21 Sept 2011
Esteban Rockett, Motorola
Jilayne Lovejoy, OpenLogic
Kim Wiens, OpenLogic
Terry Ilardi, IBM
Jordan Hatcher, ARM
Mark Gisi, Wind River
Adam Cohn, Cisco
Tom Incorvia, Microfocus
Kate Stewart, Canonical
Mansour Ghomeshi, Motorola
Michael Herzog, NexB
Linux.org still down; spdx emails also do not seem to be working…
(1) Discussion on "Modified MIT/CC-0/PDDL"; with populating Mark Gisi's spreadsheet and reminder from Karen on "why we initially avoided CC-0"
http://creativecommons.org/publicdomain/zero/1.0/
http://opendatacommons.org/licenses/pddl/1.0/
--> Rockett, Karen, Adam, Jordan, Kim → to prepare the preamble and get that to legal group for review in a week, then Kim can bring this to foundation/community people to get feedback (or buy-in); with goal of closing on this issue by two weeks/next legal meeting
(2) Discuss "Confidentiality" treatments.
(3) Discuss finishing license "templatizing"
SPDX Legal Workstream Meeting Minutes
5 October 2011
Esteban Rockett, Motorola
Adam Cohn, Cisco
Karen Copenhaver, Choate Hall
Jilayne Lovejoy, OpenLogic
Kirsten Newcomer, Black Duck
Peter Williams, OpenLogic
Mark Gisi, Wind River
Tom Incorvia, Microfocus
I) LInux website update: coming online again slowly, but SPDX site still not up. Issues:
II) Update on Discussion w/ Breakout Group on CC-0 & Draft Preamble
** Draft SPDX CC-0 Preamble **
Compliance with the SPDX specification includes populating the SPDX fields therein with data related to such fields ("SPDX-Metadata").
The SPDX specification contains numerous fields where an SPDX author may provide relevant explanatory text in SPDX-Metadata.
Without opining on the lawfulness of "database rights" (in jurisdictions where applicable), such explanatory text is copyrightable subject matter in most Berne Convention countries.
By using the SPDX specification, or any portion hereof, you hereby agree that any copyright rights (as determined by your jurisdiction) in any SPDX-Metadata, including without limitation explanatory text, shall be subject to the terms of the below recited Creative Commons CC0 1.0 Universal license (reproduced in its entirety below).
III) European OpenSource & Free Software Law Event (EOLE) http://eolevent.eu/enon Nov 4 in Barcelona
Malcom Bain might be going - Karen to reach out to him, could get him up to speed easily even though he has not been involved
IV) Update on Discussion w/Breakout Group on Templatizing
Jilayne sent around draft document setting forth guidelines (if you didn't get this, let someone know to forward)
Outstanding issues: "BSD" license issue regarding where/how to allow replaceable text and how/what to allow matching on for headers alone
- Jilayne and Rockett to draw up straw mans on these issues and distribute for feedback at next meeting
- Distribute to tech group at this point as well for feedback there
SPDX Legal Workstream Meeting Minutes - 19 October 2011
update on the Linux Foundation websites - no word on change as to timing for it being back up, so should be any day now.
update on outstanding to-do's:
SPDX Legal Team Meeting Minutes - 16 November 2011
Esteban Rockett, Motorola
Karen Copenhaver, Choate Hall
Tom Incorvia, Microfocus
Paul Madick, HP
Jilayne Lovejoy, OpenLogic
Data license update: Rockett still trying to schedule with Eben re: any concerns about CC-Zero and his opinion on the preamble we have drafted
- seeing some disengagement as a result of this issue; probably want to run it by Fedora and some of the Cisco guys who objected before full-sale announcement as well.
1) Now that the website is back up - are we comfortable we have a back-up?
2) Communication channel - do we want communications to be separate than server? And if so, what channel?
Action items:
- schedule talk with Jim and Mike re: mirroring/back-up
- communications rqmts - discuss at General Meeting tomorrow
- continue using Bugzilla for text documents - people to re-familiarize and/or use more
SPDX Legal Workstream Meeting Minutes - 14 December 2011
attendees:
Phil still trying to schedule debrief with Linux Foundation re: outage and mitigation going forward; to discuss further at next all-hands meeting
legal group to-dos for 2012:
SPDX Legal Workstream Meeting Minutes - 11 January 2012
(started late due to miscommunication b/w Rockett and Jilayne re: who was leading call, apologies to anyone who joined and then dropped off from waiting)
TOPICS:
I) new data license - CC-Zero + preamble
Mark has a document explaining the rationale for the data license discussions of late last year, which he will update now that we have decided. This will be posted in the legal section of the website, once the new site is up.
ACTION ITEM: Jilayne to get latest version (with any minor edits) to Mark; to Kim; and post on new site
ACTION ITEM: Mark to update/complete rationale document and post on new site
II)Templatizing Licenses Jilayne previously sent latest version of guidelines. feedback on that:
ACTION ITEM: Jilayne to update templatizing guidelines as per above notes/observations
ACTION ITEM: GROUP to review and further discussion needed at next meeting
III) License List
no progress, but next version in the works still; Tom suggested a review of shortnames and licenses as long as we are in process
ACTION ITEM: Jilayne to circle back with OSI re: outstanding issues and get list uploaded
IV) Other
A) License approval process - we need to get up to date on this. Where is the latest iteration? Needs to be vetted, finalized, and posted on website
** Jilayne spoke to Kim; latest iteration is thought to be somewhere in business team minutes, so she will look for and to be discussed at next general and business team meetings;
B) License v. license notice
discussed issue when generating SPDX file of identifying a license via a license notice versus the license itself. That is, we do not want license notices to be added to the license list as a license - how to decide when a notice means XYZ license where XYZ license does not have a standard notice/header
ACTION ITEM: Michael to come up with a couple examples for further discussion
SPDX Legal Workstream Meeting Minutes - 25 January 2012
In attendance:
AGENDA
I - update on CC-0 Preamble
ACTION ITEM: Jilayne to update this on SPDX wiki page with preamble
II - Review draft License List Match Guidelines (templatizing)
went through guideline document by section; change focus from normalizing on guidelines - to just offering guidelines and let tools makers implement
White Space
Capitalization - okay as is
Puncuation - okay as is
Bullets and Numbering
Varietal Word Spelling
Copyright Symbol
Copyright notice
→ next time pick up here with discussion and may tie into conversation re: headers
ACTION ITEM: update License List Match Guidelines and post on wiki page on spdx.org (current page posted is outdated)
SPDX Legal Workstream Meeting Minutes - 8 February 2012
attending:
AGENDA:
i - License List Match Guidelines - pickup at #7 Copyright Notice guideline:
see http://spdx.org/wiki/spdx-license-list-match-guidelines for updated guidelines. No more Word document.
II - License List format issue
on last business call the issue of several license text being too long for the character limit in Excel then resulting in that license text missing in the html pages was discussed and how to remedy this so that all info was in one place. Need to have a downloadable (spreadsheet) format for people who want to download the license list for their own purposes. Eventually we will transition to the html pages being the "original" and have some kind of tool to generate a downloadable file, but in the meantime, the spreadsheet is the "original" and the html files are created from that.
Gary, Bill, and Jilayne had a call on Monday about various options. proposal to move the license text into separate text files named according to the short identifiers and then the spreadsheet would have a link to the text file. spreadsheet and text files would be one downloadable tar ball.
Update and discussion of this issues at legal meeting:
SPDX Legal Team Meeting Minutes - 22 Feb 2012
AGENDA:
1) agenda for April 6 SPDX Summit
2) License List
for next call: To-do items in License List are either GPL or later issue, GPL + exception question or other smaller issues. Next time, we will try to dispense with the smaller (easier) issues on list first to get those out of the way. GPL "or later" issues ties to license match discussion, so probably best to discuss all together.
SPDX Legal Team - meeting minutes for 7 March 2012
Agenda:
("assignments" and action items in all caps)
1) License List is getting more attention as seen by recent correspondance by persons outside the group looking to use the license list as a reference/standard/resource for referring to licenses. Take-away of this is the the License List is shaping up to be an "entry point" from SPDX generally, i.e. easier to adopt names, as many organizations have a need to have a standard way to refer to licenses. from there may lead to adoption of spec. Sub-text - even higher priority/pressure to resolve outstanding issues and create guidelines for matching, etc. so we can move to a more stable maintenence role.
2) To-dos:
SPDX Legal Team Meeting Minutes - 21 March 2012
in attendance:
I - new conference dial-in number. Some people still dialing into the old number.
II - Upcoming events
III - Website refresh update from Mark
IV - License List - various items
SPDX Legal Work Group meeting minutes - 5 April 2012
Linux Foundation Collab Summit - SPDX face-to-face
Thursday, April 5, 2012
1) Different headers for the same license issue:
How to capture in License List where the same license text has different "meanings' indicated by different headers. Key examples: MPL v2.0 (Exhibit A or Exhibit A & B); L/GPL licenses ("or later" or "only"). Complete agreement that this information needs to be captured. Question is how to capture/implement?
DISCUSSION:
DECISION
leave as is = separate "line items" for GPL v2 only and GPL v2 or later
TO-DOs
OTHER RELATED DISCUSSION
SPDX Legal Work Group- Meeting Minutes - 18 April 2012
Attendees:
The meeting discussion was focused on the SPDX "license list".
1. The attendees agreed that the proposed process for adding new licenses to the list should be forwarded to the wider team for review. That proposal is attached below.
2 We also discussed, but did not resolve:
After some robust discussion of these points, it was agreed that we needed greater cross-team consensus on what problems, exactly, the license list is designed to solve. There is high-level agreement of the benefit of having a canonical list of key licenses, but when it comes down to making specific tradeoff decisions such as those above, it would be helpful to have additional guiding principles. The attendees agreed that these guiding principles should not be owned by the legal team, but should be agreed across the three teams.
The attendees also agreed that it would be valuable to start collecting “use cases” that serve as examples of real life scenarios in which SPDX will have to function. For example, if a product has several nested components, some of which are licensed under GPLv3, and some of which are marked with a license header allowing choice between MIT and GPLV2 or later, the SPDX license list needs to both capture this information and enable the user to take action and pass along an SPDX accurately reflecting these choices to the next link in the chain.
Summary:
============================================
Proposed process for submitting new licenses
============================================
· Submit via SPDX-legal email address.
· Provide a functioning URL reference to the license text, either from the license author or a or community recognized source for the license text (License URL):
· Create and attach a formatted text file with the license text from the URL posted above
· Proofread license text file to ensure that:
o information has not been lost or modified
o formatting is clean and consistent with the License URL
o only appropriate headers and information are included in the text file [link to protocol]
· Indicate if the license is OSI approved [Yes/No]. If yes, provide link to OSI license, verify that it is the same text as supplied in #1 above.
· Briefly explain the need for this license to be included, including identifying at least one program that uses this license or a prior version of this license.
· Please provide a proposed Full Name for the license, in line with the SPDX naming guidelines [LINK]
· Please provide a proposed License Identifier, in line with the SPDX naming guidelines
· Tools: Guidelines for the tools group to match this license [need to flesh this out]
Method of approval:
1. Legal Team meets every 2 weeks to review submissions of new licenses. If volume of license submissions becomes too great for Legal Team, we would create a separate Subteam to handle these reviews.
2. License submissions that meet requirements above reviewed and approved at next available Team/Subteam meeting. If further information is required, Team/Subteam responds to requestor to re-submit.
3. Publish recommended new license on the license list page as “proposed”, wait 2 weeks for review and comment then approval at next Legal Team/Subteam, following which the license gets posted as final.
SPDX Legal Work Group Meeting Minutes - 1 May 2012
Attendees:
1) Discuss status of Adding Licenses process
2) somewhat related and mildly circuitous discussion regarding license headers/notices, the standard header field on the license list
3) statements on vision for: a) SPDX work groups, b) legal group specifically, and c) license list more specifically. Adam proposed the following as to the first - did not have time to discuss, but would like to do so and then distribute to other groups. need to draft items for b and c.
Adam's proposed text:
"To enable any party in the software supply chain, from the original author to the final end user, to accurately communicate and understand the licensing information for any piece of copyrightable material that such party may create, alter, pass on, or receive, and to make such information available in a consistent, understandable, and re-usable fashion, with the aim of facilitating license and other policy compliance."
TASKS FOR NEXT CALL:
SPDX Legal Work Group Meeting Minutes - 16 May 2012
Attendees:
Agenda:
1. SPDX total vision: review Adam's proposed text to discuss on next call - done on Business Team call last week - any need to further discuss here, or leave to that next call?
--> did not discuss, leaving it to business calls (and general group) at this point
2. Legal Group vision/description: draft vision/goals statement for legal group and discuss -
PAUL's proposed text:
"The SPDX Legal Team supports the SPDX working groups by providing recommendations to the SPDX working groups regarding licensing issues for the specification itself; providing input that will result in increased legal certainty of the licensing attributes of open source projects; maintain the SPDX License List; and to promote the SPDX specification to the legal community at-large."
REVISED VERSION:
"The SPDX Legal Team supports the SPDX working groups by providing recommendations to the SPDX working groups regarding licensing issues for the specification itself; providing input that will result in increased legal certainty of the licensing attributes of open source projects; maintain the SPDX License List; and to promote the SPDX specification to the legal community at-large."
3. SPDX License List description: draft vision/goals statement for license list and discuss - JILAYNE's proposed text:
"The SPDX License List is a list of commonly found open source software licenses for the purposes of being able to easily and efficiently identify such licenses in an SPDX document. The SPDX License List includes a standardized short identifier and full name for each license, as well as other basic information. By providing a short identifier, SPDX creators (as well as others beyond SPDX) can efficiently refer to a license without having to redundantly reproduce the full license. The SPDX website (spdx.org) maintains the full text of each license on the SPDX License List. In keeping with the overall goal of the SPDX project, no interpretation of the licenses has been made and the SPDX Licenses List endeavors to only provide a factual list of licenses and short identifiers that can be consistently relied upon by users of the list."
REVISED VERSION:
"The SPDX License List is a list of commonly found open source software licenses for the purposes of being able to easily and efficiently identify such licenses in an SPDX document. The SPDX License List includes a standardized short identifier, full name for each license, vetted license text, other basic information, and a canonical permanent URL. By providing a short identifier, users can efficiently refer to a license without having to redundantly reproduce the full license."
4. Review current to-do list: - Jilayne updated last night, see http://spdx.org/wiki/legal-team-current-issues-last-updated-may-15 - anything missing? prioritization?
TO-DO'S and NEXT CALL 5/30:
SPDX Forum: Managing Open Source Licenses with Suppliers and Customers
April 6, 2012
San Jose, CA
The SPDX Forum is a one-day forum that will help companies learn how to streamline their open source license compliance processes. The forum will bring together procurement, supply chain, legal and technical staff at companies that use open source technologies in their products to discuss challenges and best practices for complying with open source licenses across the software supply chain.
We will also discuss how the SPDX(TM) (Software Package Data Exchange) standard, developed by a workgroup of the Linux Foundation, can help companies to improve and streamline compliance efforts.
Topics covered will include:
The SPDX Forum is hosted by the SPDX Workgroup of the Linux Foundation. The SPDX Workgroup is an industry group that is developing a standard that enables companies to share information about open source licenses with suppliers and customers. The SPDX Workgroup includes members from over 20 companies, including Alcatel-Lucent, Antelink, Black Duck Software, Canonical, Cisco, HP, Micro Focus, Motorola Mobility, nexB Inc, OpenLogic, Palamida, Protecode, Source Auditor, Texas Instruments and Wind River.
When
April 6, 2012
9:00am to 3:00pm
Where
The SPDX Forum will be hosted by Cisco
10 West Tasman Drive
San Jose, California 95134
United States
Building O
First Floor
Chess Meeting Room
Register
There is no charge for attendance. You must register to attend. Register now.
Questions?
Have questions about the SPDX Forum, please contact Kim Weins kim.weins@openlogic.com
SPDX Forum Agenda
We are splitting up the work to migrate content to our new website. If you want to volunteer, please feel free to add your name next to one of the items.
This is the working area for the Website Refresh team.
The web team meets weekly on Wednesdays at 19:00 GMT (12:00 Noon Pacific Time, 3:00 PM Eastern Time).
Toll-free dial-in number (U.S. and Canada): (877) 435-0230
International dial-in number: (253) 336-6732
Conference code: 7438902829.
URL: http://blackducksoftware.adobeconnect.com/r59605444/
Goals & Assumptions
This team has been formed to review current website content and navigation with an eye towards readiness for SPDX specification GA.
Based on initial feedback, the team is currently focused on a top-down view, with an emphasis on new visitors.
We've also asked individual work teams to take a first pass at consolidating their Participation wikis.
The team will use a sandbox web-site to test out ideas asking for feedback from the broader group as we go.
New feature requests or other feedback can be added by going to this wiki:
Click here Web Site Refresh Comments and Feedback
We've organized the feedback collected to date by the following categories:
Information Architecture
Visual
Navigation
Technology
2011-05-03: Strawman mockups for priming the pump.
SPDXweb1.png shows a proposed new layout for the home page
SPDXweb2.png shows proposed drop down items for the main links on the home page
Mockups for additioinal pages you navigate to by the big buttons won't be done until we have some initial feedback on these mockups.
Learn
Use
Participate
2011-05-12: Reviewed mockups with Biz Team. Great discussion, lots of input. Decided that best approach going forward will be to use a sandbox website to test out ideas so that folks can actually navigate links and explore.
Sandbox can be found here: http://sandbox.spdx.org/
The website refresh team has put together a proposed information map for the SPDX web site refresh initiative.
We've decided to capture this using FreeMind, a free tool for creating mind maps. You can find information about Free Mind here: http://freemind.sourceforge.net/wiki/index.php/Main_Page
Below, you'll find two PDF versions of the mind map we've created.
Version 1 shows the SPDX Home Page with 9 proposed child pages that would be available from the Home page. Many of those child pages have additional children. Open it up, and take a look!
Version 2 shows the same mind map, but with one more level displayed. This final level, in small, black, italic text, is used to indicate child nodes that, on the actual web site, would be links to another node. The text tells you which node the link points to.
Note: The mind map does not show page layout or graphics placeholders, but is simply intended to show the flow of information and likely links.
Feedback on this proposed map is most welcome.
If you'd like to provide your feedback in FreeMind, send me an email (knewcomer@blackducksoftware.com) and I'll send the .mm version of the mind map, since I can't post it here.
Next steps:
First feedback session is being hosted by the Business team on Thursday, July 7th. We'll be happy to host additional sessions upon request.
Volunteers Needed! Once we have something close-to-consensus, we'll proceed to implement in the SPDX web site sandbox that Martin Michlmayr was kind enough to create. We're looking for volunteers who might know Drupal or are willing to learn to help with the implementation. We're also looking for volunteers to create content that might not already be present on ths site. If you're interested in helping, please send email to knewcomer@blackducksoftware.com.
Attendees:
Pierre, LaPointe, Kirsten Newcomer
Discussion
Initial focus is on reworking the Home page for spdx.org; we'll tackle other pages after that. Discussion points covered items such as format, navigation, work group wiki pages, and analytics.
Format & Navigation
The http://www.linuxfoundation.org/ home page provides a possible model we might want to follow.
There are at least 3 major categories that need to be easy to access from the home page:
We might use the kind of format shown on linuxfoundation.org for "Attend a Linux Event," "Enroll in Linux Training," and "Read a Publication."
Having drop downs for the links across the top of the page (as is done on linuxfoundation.org) would help to provide additional info as to what's available on those pages so that users don't have to navigate there first to figure out what's available.
The contents of the blue bar at the bottom of spdx.org should use larger fonts and might also have more links to help folks find more items.
The navigation links that appear on the right hand side should be moved to the left (assuming we decide to keep them)
Work group wiki pages
Working group wiki pages: We will reach out to the leads for each working group and ask them to gather feedback from their groups as to:
Analytics
It would be helpful to have analytics on use/page visits of the existing spdx.org web pages
Action Items
Attendees:
Steve Cropper, Pierre LaPointe, Kirsten Newcomer
Topics:
Discuss feedback from Biz Team on initial set of mockups.
Based on detailed input and number of questions about where links on mockups would take you, we determined that a sandbox website would server better for presenting ideas and collecting feedback. This approach also allows us to understand what's technically possible using the web site tools available to us.
We also decided that storyboards or user scenarios would be helpful, and identified the following personas:
We agreed to use Mindmap as the format: http://freemind.sourceforge.net/wiki/index.php/Main_Page
Once we have an initial set of story boards, the web team will review to look for common patterns, refine the scenarios and then share more broadly and/or implement in sandbox for feedback loop.
We came up with the following set of questions to use for collecting feedback:
Feedback collected to date is available here: http://www.spdx.org/wiki/collected-feedback
New Action Items:
Open Action Items:
Completed Action Items: