<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Labs</title>
	<atom:link href="http://labs.creativecommons.org/feed/" rel="self" type="application/rss+xml" />
	<link>http://labs.creativecommons.org</link>
	<description>by Creative Commons</description>
	<lastBuildDate>Mon, 09 Nov 2009 17:29:34 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.8.4</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>One click PayPal donations with CiviCRM</title>
		<link>http://labs.creativecommons.org/2009/11/09/one-click-paypal-donations-with-civicrm/</link>
		<comments>http://labs.creativecommons.org/2009/11/09/one-click-paypal-donations-with-civicrm/#comments</comments>
		<pubDate>Mon, 09 Nov 2009 17:28:39 +0000</pubDate>
		<dc:creator>Nathan Kinkade</dc:creator>
				<category><![CDATA[Uncategorized]]></category>

		<guid isPermaLink="false">http://labs.creativecommons.org/?p=383</guid>
		<description><![CDATA[About a month ago CC launched its annual Fall fundraising campaign.  Along with it we also rolled out a streamlined donation process.  I wrote about this on the CiviCRM blog, and also wrote up some documentation on the CC Wiki.  This new donation method required some custom code, and leveraging an existing [...]]]></description>
			<content:encoded><![CDATA[<p>About a month ago CC launched its <a href="https://support.creativecommons.org/donate">annual Fall fundraising campaign</a>.  Along with it we also rolled out a streamlined donation process.  I <a href="http://civicrm.org/node/660">wrote about this</a> on the CiviCRM blog, and also wrote up <a href="http://wiki.creativecommons.org/OneClickDonate.php">some documentation</a> on the CC Wiki.  This new donation method required some custom code, and leveraging an existing CiviCRM <a href="http://svn.civicrm.org/civicrm/trunk/bin/ContributionProcessor.php">script</a> written by <a href="http://civicrm.org/blog/810">Donald Lobo</a>.</p>
]]></content:encoded>
			<wfw:commentRss>http://labs.creativecommons.org/2009/11/09/one-click-paypal-donations-with-civicrm/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>CC @ Mozilla Service Week</title>
		<link>http://labs.creativecommons.org/2009/09/09/cc-mozilla-service-week/</link>
		<comments>http://labs.creativecommons.org/2009/09/09/cc-mozilla-service-week/#comments</comments>
		<pubDate>Wed, 09 Sep 2009 22:36:54 +0000</pubDate>
		<dc:creator>Nathan Yergler</dc:creator>
				<category><![CDATA[Uncategorized]]></category>
		<category><![CDATA[community]]></category>
		<category><![CDATA[irc]]></category>
		<category><![CDATA[mozilla service]]></category>
		<category><![CDATA[mozservice09]]></category>

		<guid isPermaLink="false">http://labs.creativecommons.org/?p=373</guid>
		<description><![CDATA[Next week is Mozilla Service Week and Creative Commons is participating by hosting a week long help desk in IRC.  You can find more details on our earlier blog post or in the wiki.  Several CC staff members and community volunteers will be available during the week to answer questions about using CC [...]]]></description>
			<content:encoded><![CDATA[<p>Next week is <a href="http://mozillaservice.org">Mozilla Service Week</a> and Creative Commons is participating by hosting a week long help desk in <a href="http://wiki.creativecommons.org/IRC">IRC</a>.  You can find more details on our <a href="http://creativecommons.org/weblog/entry/17450">earlier blog post</a> or <a href="http://wiki.creativecommons.org/Mozilla_Service_Week">in the wiki</a>.  Several CC staff members and community volunteers will be available during the week to answer questions about using CC licenses and the associated tools.  We&#8217;ll be answering questions about:</p>
<ul>
<li>General CC help</li>
<li>CC technology (ccREL and software projects)</li>
<li>Where and how to publish CC works</li>
<li>Where and how to find CC works</li>
<li>CC in education and science </li>
</ul>
<p>If you&#8217;d like to help out and educate others about using CC licenses and tools, you can sign up on the <a href="http://wiki.creativecommons.org/Mozilla_Service_Week#Volunteers">wiki page</a>.  </p>
]]></content:encoded>
			<wfw:commentRss>http://labs.creativecommons.org/2009/09/09/cc-mozilla-service-week/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Creative Commons Drupal Module &#8212; GSoC 2009</title>
		<link>http://labs.creativecommons.org/2009/09/03/creative-commons-drupal-module-gsoc-2009/</link>
		<comments>http://labs.creativecommons.org/2009/09/03/creative-commons-drupal-module-gsoc-2009/#comments</comments>
		<pubDate>Thu, 03 Sep 2009 00:29:05 +0000</pubDate>
		<dc:creator>Blaise Alleyne</dc:creator>
				<category><![CDATA[development]]></category>
		<category><![CDATA[software]]></category>
		<category><![CDATA[summer of code]]></category>
		<category><![CDATA[tools]]></category>
		<category><![CDATA[drupal]]></category>
		<category><![CDATA[GSoC]]></category>

		<guid isPermaLink="false">http://labs.creativecommons.org/?p=358</guid>
		<description><![CDATA[This past year was my last at the University of Toronto, making this summer my last chance to participate in the Google Summer of Code. I searched hard for a project and mentor organization that would suit my interests, and when I noticed that the Creative Commons Drupal module was in need of some developer [...]]]></description>
			<content:encoded><![CDATA[<p>This past year was my last at the <a href="http://individual.utoronto.ca/balleyne">University of Toronto</a>, making this summer my last chance to participate in the Google Summer of Code. I searched hard for a project and mentor organization that would suit my interests, and when I noticed that the <a href="http://drupal.org/project/creativecommons">Creative Commons Drupal module</a> was in need of some developer love, I knew exactly what I wanted to spend my summer doing. With <a href="http://creativecommons.org/about/people#112">John Doig</a> as my CC mentor, and <a href="http://drupal.org/user/48877">Kevin Reynen</a> (the module&#8217;s maintainer and initial author) as an unofficial Drupal mentor, I&#8217;ve been privileged to have spent the past few months updating and extending the module.</p>
<p>A couple years ago, development for Drupal 4.7 was begun, but it was never quite completed. <a href="http://drupal.org/project/creativecommons_lite">CC Lite</a> came to be the reliable choice for Drupal 6. However, CC Lite&#8217;s scope is limited &#8212; it allows you to attach a license to content in Drupal, but that&#8217;s about it. The main CC module&#8217;s vision is broader &#8212; to fully integrate CC technology with the Drupal platform &#8212; and I hope I&#8217;ve helped to realize that just a little.</p>
<p>Some of the module&#8217;s features:</p>
<ul>
<li>it uses the CC API for license selection and information (so, for example, when <a href="http://creativecommons.org/weblog/entry/15990">new license versions are released</a>, they become available on your Drupal site automatically)</li>
<li>you can set a site-wide default license/jurisdictoin, and user&#8217;s can set their own default license/jurisdiction</li>
<li>ccREL metadata is supported, output in RDFa (and, optionally, RDF/XML for legacy systems)</li>
<li>supports CC0, along with the 6 standard licenses and the Public Domain Certification tool</li>
<li>you can control which licenses and metadata fields are available to users</li>
<li>basic support for the Views API has been added (including a default /creativecommons view)</li>
<li>there&#8217;s a CC site search option</li>
</ul>
<p>The module is still listed as a beta release, as some folks have been submitting bug fixes and patches over the past few weeks, though it&#8217;s quite usable. Special thanks to <a href="http://drupal.org/user/463154">Turadg Aleahmad</a>, who&#8217;s helped with a lot of the recent bug fixes towards the end of the GSoC term, and committed to being active in future development. If you&#8217;re into Drupal development, we could use help with testing, and any translations would be greatly appreciated too.</p>
<p>Right now, the focus is on getting to a stable release, but we&#8217;ve got lots of ideas for the future too. Thanks to John and Kevin for their support through the summer, and to Turadg for his recent help. I look forward to seeing the module put to good use!</p>
<p><a href="http://drupal.org/project/creativecommons/"><strong>Check it out!</strong></a></p>
<p><em>I&#8217;m a musician, writer, software developer, free culture / free software advocate and recent graduate of the University of Toronto &#8212; get in touch at <a href="http://blaise.ca/">http://blaise.ca/</a></em></p>
]]></content:encoded>
			<wfw:commentRss>http://labs.creativecommons.org/2009/09/03/creative-commons-drupal-module-gsoc-2009/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Developers landing page revamp</title>
		<link>http://labs.creativecommons.org/2009/08/11/developers-landing-page-revamp/</link>
		<comments>http://labs.creativecommons.org/2009/08/11/developers-landing-page-revamp/#comments</comments>
		<pubDate>Tue, 11 Aug 2009 20:08:22 +0000</pubDate>
		<dc:creator>Greg Grossmeier</dc:creator>
				<category><![CDATA[development]]></category>

		<guid isPermaLink="false">http://labs.creativecommons.org/?p=336</guid>
		<description><![CDATA[If you haven&#8217;t looked at the Developers landing page on the Creative Commons wiki lately, you&#8217;re missing out!  We&#8217;ve recently put a lot of effort into reorganizing the information, making the important things easier to find, and overall just making the whole place a bit more welcoming.

First of all, we&#8217;ve made the semantic split [...]]]></description>
			<content:encoded><![CDATA[<p>If you haven&#8217;t looked at the <a href="http://wiki.creativecommons.org/Developers">Developers</a> landing page on the Creative Commons wiki lately, you&#8217;re missing out!  We&#8217;ve recently put a lot of effort into reorganizing the information, making the important things easier to find, and overall just making the whole place a bit more welcoming.</p>
<p><img src="http://labs.creativecommons.org/files/2009/08/developer_redesign_screenshot1.png" alt="developer_redesign_screenshot" title="developer_redesign_screenshot" width="500" height="387" class="alignnone size-full wp-image-342" /></p>
<p>First of all, we&#8217;ve made the semantic split between information for <a href="http://wiki.creativecommons.org/Desktop_Integration">desktop-based development</a> and <a href="http://wiki.creativecommons.org/Web_Integration">web-based development</a>.  At each page there is a list (and short description) of the various tools to help you integrate CC-license metadata functionality and a short list of <a href="http://wiki.creativecommons.org/Developer_challenges">open Developer Challenges</a>.  These challenges are things the developer community think would be cool to have; a wishlist everyone can help with!</p>
<p>Also, we&#8217;re starting to produce some more &#8220;HowTo&#8221; guides for developers who are interested in the best practices of integrating CC-license metadata.  Thus far we have one for <a href="http://wiki.creativecommons.org/Web_Integration/HowTo">Web Integration</a> which lists the various ways a service could support CC licenses with best practices examples (pictoral and code) of how they did it.  See, for example, the page on <a href=http://wiki.creativecommons.org/Web_Integration/FileUploadExample>adding license choice when uploading content</a>.</p>
<p>We hope this redesign will make it easier for developers to find the information they need to improve their services.  If you have any other suggestions, don&#8217;t hesitate to send an email to <a href="mailto:greg@creativecommons.org">greg@creativecommons.org</a></p>
]]></content:encoded>
			<wfw:commentRss>http://labs.creativecommons.org/2009/08/11/developers-landing-page-revamp/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>License Engine path changes</title>
		<link>http://labs.creativecommons.org/2009/07/21/license-engine-path-changes/</link>
		<comments>http://labs.creativecommons.org/2009/07/21/license-engine-path-changes/#comments</comments>
		<pubDate>Tue, 21 Jul 2009 23:19:57 +0000</pubDate>
		<dc:creator>Nathan Yergler</dc:creator>
				<category><![CDATA[development]]></category>

		<guid isPermaLink="false">http://labs.creativecommons.org/?p=332</guid>
		<description><![CDATA[We just pushed out a resolution to Issue 381, updating the path to the license engine.  The license engine (the cc.engine application) is responsible for handling the license selection portions of the website as well as the deeds.  Some background may be helpful.
When we launched CC0 earlier this year we made a conscious [...]]]></description>
			<content:encoded><![CDATA[<p>We just pushed out a resolution to <a href="http://code.creativecommons.org/issues/issue381">Issue 381</a>, updating the path to the license engine.  The license engine (the <a href="http://code.creativecommons.org/viewsvn/cc.engine/">cc.engine</a> application) is responsible for handling the license selection portions of the website as well as the deeds.  Some background may be helpful.</p>
<p>When we launched CC0 earlier this year we made a conscious decision to locate the deed on a different path than the rest of the license deeds.  CC0 is a <em>waiver</em>, not a <em>license</em>, so the deed appropriately is located at <a href="http://creativecommons.org/publicdomain/zero/1.0/">http://creativecommons.org/publicdomain/zero/1.0/</a> (as opposed to the license deeds which URLs that look like <a href="http://creativecommons.org/licenses/by/3.0/">http://creativecommons.org/licenses/by/3.0/</a>).  At the time we decided to leave the CC0 chooser in the same group as the other choosers.  This unfortunately gave us a URL that contained <code>license</code> in it &#8212; <code>http://creativecommons.org/license/zero/</code> &#8212; which caused confusion for some users.  Is it a license or isn&#8217;t it?</p>
<p>It&#8217;s not.  </p>
<p>So starting this afternoon we&#8217;ve relocated the license engine to <a href="http://creativecommons.org/choose">http://creativecommons.org/choose</a> and CC0 to <a href="http://creativecommons.org/choose/zero">http://creativecommons.org/choose/zero</a>.  Redirects are in place so you shouldn&#8217;t notice any changes.</p>
]]></content:encoded>
			<wfw:commentRss>http://labs.creativecommons.org/2009/07/21/license-engine-path-changes/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>git-svn with svn:externals</title>
		<link>http://labs.creativecommons.org/2009/07/21/git-svn-with-svnexternals/</link>
		<comments>http://labs.creativecommons.org/2009/07/21/git-svn-with-svnexternals/#comments</comments>
		<pubDate>Tue, 21 Jul 2009 18:16:10 +0000</pubDate>
		<dc:creator>Nathan Yergler</dc:creator>
				<category><![CDATA[development]]></category>
		<category><![CDATA[gcs]]></category>
		<category><![CDATA[git]]></category>
		<category><![CDATA[git-svn]]></category>
		<category><![CDATA[svn]]></category>

		<guid isPermaLink="false">http://labs.creativecommons.org/?p=328</guid>
		<description><![CDATA[We&#8217;ve been slowly but surely moving projects from Subversion to git, but there are still large pieces of code that are sort of deadlocked in Subversion.  We make extensive use of svn:externals in our repository as a way to pull in dependencies and shared code (both within our repository and from other repositories, like [...]]]></description>
			<content:encoded><![CDATA[<p>We&#8217;ve been slowly but surely moving projects from Subversion to git, but there are still large pieces of code that are sort of deadlocked in Subversion.  We make extensive use of <code>svn:externals</code> in our repository as a way to pull in dependencies and shared code (both within our repository and from other repositories, like <a href="http://pypi.python.org/pypi/zc.buildout">zc.buildout&#8217;s</a> bootstrap).  This means that in order to convert something like the license engine (cc.engine) we need to also convert cc.license (which uses license_xsl), license.rdf and i18n.  Of course, the <a href="http://api.creativecommons.org">API</a> also uses license_xsl and the main site uses license.rdf.  Taking the time to move all of that wholesale isn&#8217;t something we have the time or desire to do right now.  It&#8217;s not just converting the repository &#8212; that&#8217;s the easy part; converting the deployments and surrounding tools is the real pain.</p>
<p>Last week I decided I wanted to use git to work on code currently in Subversion (my supporting tool chain really is that much better for git) and decided to check it out using git-svn.  And once again I was burned by our use of svn:externals.  So I wrote <strong>gsc</strong> &#8212; git subversion clone.  You can read more details <a href="http://yergler.net/blog/2009/07/21/git-svn-and-svnexternals/">on my blog</a> or find the code <a href="http://gitorious.org/gsc">on gitorious</a>.</p>
<p>Incidentally, cleaning up that dependency graph is very much on our radar.  I&#8217;m hoping to land work that we started last summer this fall that will remove some duplicated code and clean up the dependencies of the remaining code.</p>
]]></content:encoded>
			<wfw:commentRss>http://labs.creativecommons.org/2009/07/21/git-svn-with-svnexternals/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>OpenOffice.org Add-in Updates &#8211; GSoC 2009</title>
		<link>http://labs.creativecommons.org/2009/07/06/openofficeorg-add-in-updates-gsoc-2009/</link>
		<comments>http://labs.creativecommons.org/2009/07/06/openofficeorg-add-in-updates-gsoc-2009/#comments</comments>
		<pubDate>Mon, 06 Jul 2009 15:22:02 +0000</pubDate>
		<dc:creator>NiMaL</dc:creator>
				<category><![CDATA[Add-In]]></category>
		<category><![CDATA[OpenOffice]]></category>
		<category><![CDATA[summer of code]]></category>

		<guid isPermaLink="false">http://labs.creativecommons.org/?p=321</guid>
		<description><![CDATA[I&#8217;ve been working on the GSoC 2009 project, where I&#8217;m working on certain updates to the existing Creative Commons Add-in for OpenOffice.org. This project is mentored by Nathan Yergler.
The main goals for this project is to provide the following updates to the existing plugin.

Update the codebase to the OOo 3 SDK
The license selection UI could [...]]]></description>
			<content:encoded><![CDATA[<p>I&#8217;ve been working on the GSoC 2009 project, where I&#8217;m working on certain updates to the existing Creative Commons Add-in for OpenOffice.org. This project is mentored by <a href="http://creativecommons.org/about/people/#31">Nathan Yergler</a>.</p>
<p>The main goals for this project is to provide the following updates to the existing plugin.</p>
<ul>
<li>Update the codebase to the OOo 3 SDK</li>
<li>The license selection UI could be refined to provide help around what each option means (”what is Share Alike”).</li>
<li>Display license information when opening CC licensed documents</li>
<li>Internationalization – prepare the code for translation and write the scripts to integrate PO files prepared by translators</li>
<li>Support for OOo Draw</li>
<li>Add support for CC0</li>
<li>Make a release incorporating Flickr Image Re-Use for OpenOffice.org.</li>
</ul>
<p>As there are many distinct tasks, I&#8217;m working on complete the most I can. I have been struggling a bit in the past couple of weeks with my progress, but I&#8217;m now bouncing back and coming back to track.</p>
<p>I hope I&#8217;ll be able to present the CC community with an updated version of the Add-in at the end of the project completion.</p>
]]></content:encoded>
			<wfw:commentRss>http://labs.creativecommons.org/2009/07/06/openofficeorg-add-in-updates-gsoc-2009/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Updates to CC Network OpenID Provider</title>
		<link>http://labs.creativecommons.org/2009/04/13/updates-to-cc-network-openid-provider/</link>
		<comments>http://labs.creativecommons.org/2009/04/13/updates-to-cc-network-openid-provider/#comments</comments>
		<pubDate>Mon, 13 Apr 2009 22:44:29 +0000</pubDate>
		<dc:creator>Nathan Yergler</dc:creator>
				<category><![CDATA[Uncategorized]]></category>
		<category><![CDATA[CC Network]]></category>
		<category><![CDATA[openid]]></category>

		<guid isPermaLink="false">http://labs.creativecommons.org/?p=315</guid>
		<description><![CDATA[We received a couple bug reports over the weekend about the CC Network OpenID provider.  Users were seeing a situation where they were asked to log into the CC Network with a username that was similarto their&#8217;s, but not quite right &#8212; specifically, the final character was omitted.  When they put in their [...]]]></description>
			<content:encoded><![CDATA[<p>We received a couple bug reports over the weekend about the CC Network OpenID provider.  Users were seeing a situation where they were asked to log into the CC Network with a username that was <em>similar</em>to their&#8217;s, but not quite right &mdash; specifically, the final character was omitted.  When they put in their correct username and password they were just redirected to the login screen again and again.</p>
<p>After some digging we arrived at <a href="http://code.creativecommons.org/issues/issue308">Issue 308</a>.  The problem occurs when a non-compliant OpenID-enabled site asks for the OpenID URL and the user supplies something that <em>should</em> work, but isn&#8217;t canonical.  For example, my CC Network profile is at <code>https://creativecommons.net/nathan/</code>.  I should be able to use any of the following as my OpenID and have the site get to the canonical version:</p>
<ul>
<li>creativecommons.net/nathan</li>
<li>http://creativecommons.net/nathan</li>
<li>http://creativecommons.net/nathan/</li>
<li>https://creativecommons.net/nathan</li>
</ul>
<p>The process of getting from one of these to the canonical version is called <a href="http://openid.net/specs/openid-authentication-2_0.html#normalization">normalization</a>.</p>
<p>So if an OpenID enabled site (such as, say, sourceforge.net or intensedebate.com) doesn&#8217;t do normalization, the user ends up asking to be validated for some URL other than their own canonical identity.  And our server kicks that back as an invalid OpenID URL.  Intense Debate seems to be aware of the issue; someone already reported it on their <a href="http://getsatisfaction.com/intensedebate/topics/openid_url_must_match_exactly_when_logging_in">Get Satisfaction forum</a>.</p>
<p>We briefly considered working around this bug (and it is a bug) but ultimately decided against it.  It didn&#8217;t &#8220;smell&#8221; right and after some thought we realized that it could cause users more problems down the road.  For example, if we implemented the proposed fix (making the trailing slash optional, which would have fixed it in most cases, it appears), a user could end up logging in at a broken site with the URL <code>https://creativecommons.net/foo</code>.  If that site later fixed their code to correctly perform normalization, the user would suddenly be asking to validate a <em>different</em> URL &#8212; <code>https://creativecommons.net/foo<strong>/</strong></code>. I suppose a site that has this bug and needs to fix it could normalize all the OpenID URLs stored in their database before pushing out the patch.  </p>
<p>Instead we went ahead and added an error screen so that instead of the completely frustrating never-ending login loop, you at least get a hint that something&#8217;s wrong (and how to fix it).</p>
<p>The moral of the story? If you run into a problem logging into an OpenID-enabled site, first make sure you&#8217;re using your &#8220;real&#8221; URL (and if you still have a problem, at least with your CC Network ID, please <a href="http://code.creativecommons.org/issues/issue?@template=item">report it</a>).</p>
]]></content:encoded>
			<wfw:commentRss>http://labs.creativecommons.org/2009/04/13/updates-to-cc-network-openid-provider/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Enumeration descriptions in CC Web Services</title>
		<link>http://labs.creativecommons.org/2009/04/02/enumeration-descriptions-in-cc-web-services/</link>
		<comments>http://labs.creativecommons.org/2009/04/02/enumeration-descriptions-in-cc-web-services/#comments</comments>
		<pubDate>Thu, 02 Apr 2009 21:14:05 +0000</pubDate>
		<dc:creator>Nathan Yergler</dc:creator>
				<category><![CDATA[Uncategorized]]></category>
		<category><![CDATA[api]]></category>
		<category><![CDATA[rst]]></category>
		<category><![CDATA[sphinx]]></category>

		<guid isPermaLink="false">http://labs.creativecommons.org/?p=311</guid>
		<description><![CDATA[We had a request come in from a developer using the CC web services for better contextual information about the choices users make when selecting a license.  In particular, they wanted to present users with information about what &#8220;ShareAlike&#8221; means.  As I dug into it I realized that the existing &#60;description&#62; we provided [...]]]></description>
			<content:encoded><![CDATA[<p>We had a request come in from a developer using the <a href="http://api.creativecommons.org/">CC web services</a> for better contextual information about the choices users make when selecting a license.  In particular, they wanted to present users with information about what <em>&#8220;ShareAlike&#8221;</em> means.  As I dug into it I realized that the existing <code>&lt;description&gt;</code> we provided for the questions themselves are&#8230; well, bad.  I can only imagine how hard it&#8217;d be to craft a user interface using <strong>those</strong> as help text.</p>
<p>I just pushed an update to the <a href="https://api.creativecommons.org/docs/readme_dev.html">development version</a> of the API that adds <code>&lt;description&gt;</code> elements to the individual <code>&lt;enum&gt;</code> elements.  These map to the help pop-ups we use on the main license chooser.  If all seems well we&#8217;ll push this down to <a href="https://api.creativecommons.org/docs/readme_15.html">1.5</a> as well.</p>
<p>I should also note that this update includes two new, very nice (for me) improvements:</p>
<ul>
<li>I finally landed Frank&#8217;s test suite work from last summer.  We had intended to replace the whole API with a leaner version, but that&#8217;s still in the works.  So in the interim, we have a test suite and I&#8217;m not afraid of change anymore (on this project at least).</li>
<li>I&#8217;ve updated the documentation to use <a href="http://sphinx.pocoo.org/">Sphinx</a>.  <a href="http://en.wikipedia.org/wiki/ReStructuredText">ReStructured Text</a> is the secret weapon of many a Python project; Sphinx makes it even more powerful, providing a set of directives and tools to generate something that looks, well, at least decent.</li>
</ul>
]]></content:encoded>
			<wfw:commentRss>http://labs.creativecommons.org/2009/04/02/enumeration-descriptions-in-cc-web-services/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>CC Technology Summit 3: Turin, Italy</title>
		<link>http://labs.creativecommons.org/2009/03/29/cc-technology-summit-3-turin-italy/</link>
		<comments>http://labs.creativecommons.org/2009/03/29/cc-technology-summit-3-turin-italy/#comments</comments>
		<pubDate>Sun, 29 Mar 2009 16:03:04 +0000</pubDate>
		<dc:creator>Nathan Yergler</dc:creator>
				<category><![CDATA[Uncategorized]]></category>
		<category><![CDATA[techsummit]]></category>

		<guid isPermaLink="false">http://labs.creativecommons.org/?p=308</guid>
		<description><![CDATA[As you may have see on the blog or one of the mailing lists, we&#8217;ve announced the third CC Technology Summit.  The CFP is currently open (presentations due April 24) and full details are in the wiki.
]]></description>
			<content:encoded><![CDATA[<p>As you may have see on the <a href="http://creativecommons.org/weblog/">blog</a> or one of the mailing lists, we&#8217;ve <a href="http://creativecommons.org/weblog/entry/13682">announced</a> the third CC Technology Summit.  The CFP is currently open (presentations due April 24) and full details are <a href="http://wiki.creativecommons.org/Creative_Commons_Technology_Summit_2009-06-26">in the wiki</a>.</p>
]]></content:encoded>
			<wfw:commentRss>http://labs.creativecommons.org/2009/03/29/cc-technology-summit-3-turin-italy/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>
