Legal Team/Templatizing/ActionPlan

We came up with a timeline and action items on the July 21 legal call for going live with the new SPDX License List. That list is posted here, so we can track progress and update on one place.

Timing

Timing:

Goal to have full conversion and live by end of October 2016 As such, we decided it's okay to not have a Q3 release.

Update (as per Sept 16 meeting):

• decided to do a 2-stage release, as described below
• a bit behind for first stage by end of October, but will push on!

Action Items - Stage 1: Initial Release

Update as of Nov 10th legal call

Finish main review of all licenses so that all can merged (Who: ALL)

This also includes:

• add exceptions to repository and review (KRIS to add by Dec 8th // ALL to review)
  • note from Gary: tools don't care whether in same or different directory
• how to deal with deprecated licenses (KRIS and GARY discussed)
  • outcome: Proposed solution to add a boolean attribute named deprecated to the SPDX element with a default value of false. For the "+" deprecated licenses, we would copy the XML file, rename it to include the "+" and add deprecated=true to the SPDX attributed.
  • add deprecated licenses to repository and review? (Gary to add // ALL to review)
• licenses tagged as "required acknowledgment" do not merge, need another tag (KRIS // determine timeframe on Dec 8th call)
  • may need input from legal team?
• get rid of HTML escaped characters - they are distracting; will still have some, like for < and > b/c can’t have those in XML -should this be part of general clean-up or done sooner>
• do another pass and some other general clean-up, e.g., remove body tag, fix lower case spdx tags, and update tags as per tech team recommendations (KRIS // determine timeframe for this on Dec 8th call)
• true-up with most recent version of SPDX License List, new licenses or any other updates since v2.3 (now on 2.6)

Finalize XML tag names

• Gary to bring to tech team for Sept 20 call, tech team to decide, with final review/sanity check by legal team - DONE
  • process: build a table for existing field name (machine-readable name for these from current spec) and new XML tag
  • Gary took to tech team, and had joint call with legal and tech team to finalize. notes here: http://wiki.spdx.org/view/Technical_Team/Minutes/2016-10-25
• update tags as per tech team recommendations (KRIS // determine timeframe for this on Dec 8th call)

Check website generation / tools

• As of Sept 16 call, Gary had done a first pass on tools to generate website and caught a bunch of validation errors, many of which were from lower case <spdx> tag. Gary to see what other validations were and fix and merge if simply or create pull request/submit to legal team if needs review
• other updates to spdx-tools for new XML format (including website generation) - for 5 different formats? (Gary?)
• preview of website before release?

Documentation

• Update info for README on Github (Dennis to draft, ALL review)
  • first review completed on Nov 10th call. second review via email/remote - DONE (add link here)
• Review various webpages for updating (changes to be made now? or what until stage 2?) - Alan did first pass, which raised various questions and other things to address, need to revisit now that naming issue has been resolved with tech team
  • license matching guidelines page
  • license list overview page,
  • info about XML tags (http://wiki.spdx.org/view/Legal_Team/Templatizing/tags-matching) - this may be more likely stage 2 and become part of spec as an appendix

Action Items - Stage 2: Full XML conversion

Coordination with tech team and SPDX Spec v2.2

• revisions to current appendix in spec as to markup (e.g., var v. alt markup tag)
• explanation of XML tags - to go in markup appendix or new appendix?

Define a new process for License List via Github and with new XML format

• i.e., how to request a new license, what kind of pull requests we want, underlying process etc.
• included checking with Kate re: moving license list to Github primary (instead of LF Git and mirrored to Github)

Documentation

• see stage 1 list - any further updates?

SPDX tools and website generation

• see stage 1 list - any further updates?

Create new tool to take text of new license and convert to XML file (WHO: Kris? // When: doesn't have to be done for release in Oct)

• to do so by hand is a bit tedious. Will still need human review before finalizing