licensing-brainstorming

From Microformats Wiki
Revision as of 18:09, 31 July 2009 by Tantek (talk | contribs) (→‎item as container: clarify versions/resolutions as additional item-url items)
Jump to navigation Jump to search

<entry-title>Licensing Brainstorming</entry-title>

Brainstorming proposals toward a licensing microformat per the microformats process.

Discussion

Set of classes pertinent to supporting licensing and attribution requirements and complements. These classes could be used at webpage level or within relevant microformats, e.g., media-info.

reuse limitations

rel-license has already been specified to apply to the entire document, and thus many current implementations (e.g. search engines) already assume that whenever they see rel="license" that it applies to the whole page.

If we tried to re-use rel-license in the licensing microformat to refer to part of a page or an external resource, existing implementations would mis-interpret such a use as applying to the whole page.

Thus in order to not break backward compatibility with existing rel-license implementations, if we want something like rel-license for the licensing microformat, we must use a new rel value.

table of possible properties

The first column may be too URL-centric, see notes for parent work, may apply to others.

Overly descriptive strawman not intended to conform with any conventionExisting class(es); sourceNotes
work title fn; hCard See examples#title
attribution name, creator? author; hAtom, hcard Might be a vcard with fn, may also be an organization
See examples#attribution
attribution url url; hCard An author might have a url, should this be taken as the attribution url? If a work has a url, should it be taken as the attribution url?
See examples#link
donation url payment; rel-payment
offer; hListing
How to disambiguate from commercial licensing and purchase?
See examples#donation
commercial licensing url payment; rel-payment

sell, offer; hListing

copyright; HTML LinkType
How to disambiguate from donation and purchase?
See examples#commercial
purchase url payment; rel-payment
sell, offer; hListing
How to disambiguate from donation and commercial licensing?
See examples#purchase
content hash checksum, sha1; hash-examples See examples#hash
provenance url See examples#provenance
parent work url?, derivitave-source Should this be a url? Maybe it should be a TBD "media" microformat which may be otherwise described.


See examples#derivative

Probably should be a URL -- a uf can have a #URL if it has an id.
attribution, copied-source Shows where the media was immediately copied from (not necessarily the same as its original source). Has the same challenges as derivative-source. Perhaps use the approach loosely outlined in Attribution Challenges
source Like 'copied-source' but points to the original source.


Attribution Challenges

Tags dealing with specifying sources and tracking a piece of media's path through the Web (any of the -source tags above) are a little ambiguous in terms of what they can reference. For instance when specifying a derivative work it could be from another image on the Internet, in which case an URL would be appropriate, or it could be a quotation from a magazine or other "real" world source where an URL doesn't really work. Perhaps we can encourage the content of these 'media source' tags to be one of the following:

Media source type Format Notes
Internet source An URL
Person hcard
Publication
(book, magazine, etc.)
citation Citation appears to be heavily weighed towards academia but it looks like it should work for most purposes
Film/Video  ?? I'm not sure about this one. Would citation stretch over visual media? Perhaps media-info?

containing vs being contained

Based on the markup in the licensing-examples, in may be useful to consider two ways that licensing information could be expressed:

  1. A license microformat that contains the item on the page that is being licensed, as well as the license URL and attribution requirements (if any).
  2. A license microformat that contains just a link to the license URL, and has:
    • a) an ID reference to the item outside the licensing markup OR implied item applicability by a containing media-info, hAtom hentry etc.
    • b) and contains OR has an ID reference to the attribution requirements (if any)

Both these options should be explored, and tried out with markup from actual licensing-examples to see which of today's use cases each option would work well/better with.

It may be that we want/need a licensing microformat that allows for either method (containing or being contained) of indicating the license.

brainstorms

Various thoughts, proposals, strawman examples of how licensing information could be marked up.

class attribution

Perhaps there should be an 'attribution' class which might hint that a fn or url should be used for attribution? Something like (webpage scope):


<a class="url attribution fn" href="http://example.com">My First Cookbook</a>
<div class="author vcard">
  <div class="fn attribution">J Doe</div>
</div>
<a rel="license" href="http://creativecommons.org/licenses/by/2.5/">(cc)</a>
<a rel="payment" href="http://paypal.com/...">don't let me starve</a>


media info with attribution

Here is an example of media-info with class 'attribution'.


<div class="media">
  <img class="url attribution mediaitem" src="http://example.com/cake.jpg"/>
  <span class="fn">Picture of a giant cake</span>
  <div class="author vcard">
    <div class="fn attribution">J Doe</div>
  </div>
  <a rel="license" href="http://creativecommons.org/licenses/by-nc/2.5/">(cc)</a>
  <a rel="payment" href="http://paypal.com/...">don't let me <s>starve</s>eat cake</a>
  <a rel="payment" href="http://artdelivery.example">buy this pic, framed</a>
  <a rel="payment" href="http://photoclearing.example">get commercial rights</a>
  ...
</div>


reuse CC vocabulary

Here is an example using the Creative Commons vocabulary, with CamelCase conventions converted to dash separated lowercase words per microformats naming-principles.

<div class="license">
  <a rev="license" href="http://example.org/work">The work</a> 
  is licensed under the 
  <a rel="legal-code" href="http://example.org/foo">Foo License</a>. 
  Summary: it permits 
  <abbr title="derivative-works" class="permits">derivative works</abbr> 
  but requires 
  <abbr title="attribution" class="requires">attribution</abbr>. 
  The credit to give when reusing the work is 
  "<span class="vcard">
    <a href="http://tobyinkster.co.uk" class="fn url attribution-name" rel="attribution-url">
     Toby Inkster
    </a>
   </span>
  ".
</div>

The microformat could use the following terms:

  • license {1} (root class name)
    • legal-code ? (rel value, not class)
    • more-permissions * (rel value, not class)
    • permits * ("reproduction" | "distribution" | "derivative-works" | "high-income-nation-use" | "sharing")
    • requires * ("copyright-notices" | "attribution" | "share-alike" | "source-code")
    • prohibits * ("commercial-use")
    • jurisdiction * (text | hCard | adr)
    • attribution-name ?
    • attribution-url ? (rel value, not class)
    • deprecated-on ? (ISO date)

The license linked to using rel="legal-code" (if any) should be taken to be the definitive license. When such a license is present, the "permits", "requires", "prohibits" and "jurisdiction" classes are taken to be merely advisory. When no "legal-code" license is linked to, these classes are definitive.

rel-license SHOULD be used to link from the work to the license (an ID attribute on the license will help). A license MAY link back to the work using rev="license", but forward links are preferred.

As an extension to the creative commons vocabulary (which focuses on open-source-like licenses) a payment URL MAY be linked to using an anchor element simultaneously carrying class="requires" and rel="payment". Example:

<a class="requires" rel="payment" href="https://payment.example.org">buy</a>

If rel-payment is used without a class of "requires", then the link is taken to be an optional payment link - i.e. a donation.

ccREL issues

  • The permits, requires, prohibits properties enable (and thus encourage) a combinatorial explosion in license proliferation, which is well known/understood to be a bad thing in open source circles as well as in/by the Creative Commons community itself - e.g. in a presentation on 2005-11-03, Lawrence Lessig indicated that license proliferation was a threat to interoperability, and that that was one of the biggest problems that the open source and content communities needed to address. Note that this is an issue with ccREL itself, independent of the syntax, whether converted to microformats class names or not. Tantek 21:50, 29 May 2009 (UTC)
  • The above mapping creates a new en-us content enumeration ('derivative-works', etc). Shown here in abbr form, which as in hCard, will not internationalize acceptably. As per the advice we given to page authors, further use of the value-class-pattern as a DRY-violating get-out for this should be an absolute last resort to specification authors too. (Personally, I'd favour declaring prescribed enumeration an anti-pattern for future development.) --BenWard 22:28, 29 May 2009 (UTC)
    • +1 I agree with Ben Ward, new enumerations will likely be problematic and should be avoided. -- Tantek 18:02, 31 July 2009 (UTC)

rel item license

Since rel-license already applies to an entire page, we likely need another rel value to indicate that a license only applies to a specific item on or referenced by the page. Thus:

rel="item-license"

class license

Licensing information about an item could be contained in an element with class name "license", e.g.

<div class="license">
  This 
  <span class="item">
   <a class="url" href="photo.jpg">photograph</a>
  </span>
  is licensed under a
  <a rel="item-license" href="http://creativecommons.org/licenses/by-nc/2.0/deed.en">
   Creative Commons attribution non-commercial 2.0 license
  </a>.
</div>

class names license and attribution

Attribution information could be added with the above-mentioned class name 'attribution':

<div class="license">
  This 
  <span class="item">
   <a class="url" href="photo.jpg">photograph</a>
  </span>
  is licensed under a
  <a rel="item-license" href="http://creativecommons.org/licenses/by-nc/2.0/deed.en">
   Creative Commons attribution non-commercial 2.0 license
  </a>.
  Please provide the following attribution with any re-use of the photo:
  <div class="attribution">
   Photo by Mary Smith.
  </div>
</div>


with hyperlinks in attribution:


<div class="license">
  This 
  <span class="item">
   <a class="url" href="photo.jpg">photograph</a>
  </span>
  is licensed under a
  <a rel="item-license" href="http://creativecommons.org/licenses/by-nc/2.0/deed.en">
   Creative Commons attribution non-commercial 2.0 license
  </a>.
  Please provide the following attribution with hyperlinks to the original and author with any re-use of the photo:
  <div class="attribution">
   <a href="photo.jpg">Photo</a> 
   by 
   <a href="http://mary.example.com/">Mary Smith</a>.
  </div>
</div>


item as container

It may be possible to simplify even further and only use the containing class "item" to indicate the scope of the thing that is being licensed, the license, and any optional attribution.

Here is an example of a chunk of hypertext content that is being licensed:

<div class="item">
  <p>... blog post or article text content ...</p>
  <p>This is licensed under a
  <a rel="item-license" href="http://creativecommons.org/licenses/by-nc/2.0/deed.en">
   Creative Commons attribution non-commercial 2.0 license</a>.
  </p>
</div>

To specify a license on an external resource like a photograph, we can use a new class name "item-url" to identify the external resource as being the actual item:

<div class="item">
  This 
  <a class="item-url" href="photo.jpg">photograph</a>
  is licensed under a
  <a rel="item-license" href="http://creativecommons.org/licenses/by-nc/2.0/deed.en">
   Creative Commons attribution non-commercial 2.0 license
  </a>.
</div>

item-url details:

  • Authors should provide one item-url for an external resource that is being licensed.
  • If more than one item-url is provided, they are assumed to be copies/mirrors/versions (perhaps different resolutions) of the same item, and all have the same license and attribution terms (if any) applied to them, e.g. a link to the photo and embedding a thumbnail or small version of the photo:
<div class="item">
  This 
  <a class="item-url" href="photo.jpg">photograph:
   <img class="item-url" href="smallphoto.jpg" alt="small version of a photograph" />
  </a>
  is licensed under a
  <a rel="item-license" href="http://creativecommons.org/licenses/by-nc/2.0/deed.en">
   Creative Commons attribution non-commercial 2.0 license
  </a>.
</div>

item with attribution

Attribution information could be added with the class name 'attribution':

<div class="item">
  This 
  <a class="item-url" href="photo.jpg">photograph</a>
  is licensed under a
  <a rel="item-license" href="http://creativecommons.org/licenses/by-nc/2.0/deed.en">
   Creative Commons attribution non-commercial 2.0 license
  </a>.
  Please provide the following attribution with any re-use of the photo:
  <div class="attribution">
   Photo by Mary Smith.
  </div>
</div>

item with hyperlink attribution

With hyperlinks in attribution:

<div class="item">
  This 
  <a class="item-url" href="photo.jpg">photograph</a>
  is licensed under a
  <a rel="item-license" href="http://creativecommons.org/licenses/by-nc/2.0/deed.en">
   Creative Commons attribution non-commercial 2.0 license
  </a>.
  Please provide the following attribution with hyperlinks to the original and author with any re-use of the photo:
  <div class="attribution">
   <a href="photo.jpg">Photo</a> 
   by 
   <a href="http://mary.example.com/">Mary Smith</a>.
  </div>
</div>

to do

  • Answer questions above and those not posed
  • Discover and fix gratuitous problems with the above
  • Examples working with media-info

see also