source-brainstorming: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
No edit summary
Line 25: Line 25:
     <li><code>sourcecode</code></li>
     <li><code>sourcecode</code></li>
</ol>
</ol>
=== Use when linking to project source code ===
Could this really be used to link to a project’s (rather than the current document’s) source code?
Using the Unison.js example, with all HTML attributes removed except <code>rel</code> and <code>href</code>:
<pre><nowiki>
<a rel="source" href="https://github.com/bjork24/Unison">View on GitHub</a>
</nowiki></pre>
Following the [[rel-faq]], this would be interpreted as:
:The resource indicated by https://github.com/bjork24/Unison is a "source" for the current document.
But it isn’t. [http://responsivedesign.is/resources/javascript-jquery/unison.js The Unison.js project page on responsivedesign.is] does not seem to use Unison.js in any way.


== Examples ==
== Examples ==

Revision as of 14:50, 5 February 2014

<entry-title> Source Brainstorming </entry-title>

Per the microformats process, this page is for brainstorming about ideas, proposals, constraints, requirements for a microformat for indicating the link relationship between a document (or site) and its source code.

Usage

<a href="https://github.com/adactio/html5forwebdesigners" rel="source">the source for this book</a>
<link href="https://github.com/adactio/html5forwebdesigners" rel="source" />

Use Cases

When an author links to a project's (or document's) source code (e.g. on GitHub, Google Code, etc.) a rel value of "source" could be used to explicitly define that relationship.

Discussions

rel="code"

source could be better used to define a source where the information came from. When someone writes an article, which is based on informations somewhere else, rel="source" would be a more appropriate name.

Better naming recommendations for the case of this rel-Attribute:

  1. code
  2. sourcecode

Use when linking to project source code

Could this really be used to link to a project’s (rather than the current document’s) source code?

Using the Unison.js example, with all HTML attributes removed except rel and href:

<a rel="source" href="https://github.com/bjork24/Unison">View on GitHub</a>

Following the rel-faq, this would be interpreted as:

The resource indicated by https://github.com/bjork24/Unison is a "source" for the current document.

But it isn’t. The Unison.js project page on responsivedesign.is does not seem to use Unison.js in any way.

Examples

These examples demonstrate situations where an explicit rel value could be used to mark up an existing document (or project's) link to its source.