code-brainstorming: Difference between revisions

From Microformats Wiki
Jump to navigation Jump to search
No edit summary
 
m (fmt)
Line 2: Line 2:


This is a brainstorm for the code microformat. See also [[code-examples|examples of code]] in the wild.
This is a brainstorm for the code microformat. See also [[code-examples|examples of code]] in the wild.
=Code Brainstorming=


== The Problem ==
== The Problem ==


There are numerous sites on the Internet that seek to: Teach a programming language, Document a programming language, Collect examples or bits of code for reuse in the general community, or Show off a particularly interesting section of code. Examples are, [http://docs.python.org/tut/ tutorials], [http://php.net/ language documentation], [http://aspn.activestate.com/ASPN/ programming communities], or just plain old [http://www.b-list.org/weblog/2006/11/16/django-tips-get-most-out-generic-views blogs]. Each of these sites encapsulates their source code in different fashions and wraps up the metadata in different ways, this makes the source code found around the web largely indigestible by machines.
There are numerous sites on the Internet that seek to:
*Teach a programming language
*Document a programming language
*Collect examples or bits of code for reuse in the general community
*Show off a particularly interesting section of code.
 
Examples are:
*[http://docs.python.org/tut/ tutorials]
*[http://php.net/ language documentation]
*[http://aspn.activestate.com/ASPN/ programming communities]
*[http://www.b-list.org/weblog/2006/11/16/django-tips-get-most-out-generic-views blogs].
 
Each of these sites encapsulates their source code in different fashions and wraps up the metadata in different ways, this makes the source code found around the web largely indigestible by machines.
 
So by consolidating common practices into a standard format, you a) allow web developers a standard representation of source code online, and b) offer it in a format that is digestible by computers. This more than anything allows for interesting use by users. It would for instance allow users to collect code examples from the web and store them on their local machines in meaningful ways, which in turn allows them to organize and search that new source code repository for examples, classes or snippets that relate to their problem, and further gives them the information necessary to safely use that source code (license, author, language, etc.)
 
=+See also==


So by consolidating common practices into a standard format, you a) allow web developers a standard representation of source code online, and b) offer it in a format that is digestible by computers.  This more than anything allows for interesting use by users.  It would for instance allow users to collect code examples from the web and store them on their local machines in meaningful ways, which in turn allows them to organize and search that new source code repository for examples, classes or snippets that relate to their problem, and further gives them the information necessary to safely use that source code (license, author, language, etc.)
*[[code-examples]]


== Elements that come up often in practice ==
== Elements that come up often in practice ==


=== Base Elements ===
=== Base Elements ===

Revision as of 21:25, 26 January 2007

Code Brainstorming

This is a brainstorm for the code microformat. See also examples of code in the wild.

Code Brainstorming

The Problem

There are numerous sites on the Internet that seek to:

  • Teach a programming language
  • Document a programming language
  • Collect examples or bits of code for reuse in the general community
  • Show off a particularly interesting section of code.

Examples are:

Each of these sites encapsulates their source code in different fashions and wraps up the metadata in different ways, this makes the source code found around the web largely indigestible by machines.

So by consolidating common practices into a standard format, you a) allow web developers a standard representation of source code online, and b) offer it in a format that is digestible by computers. This more than anything allows for interesting use by users. It would for instance allow users to collect code examples from the web and store them on their local machines in meaningful ways, which in turn allows them to organize and search that new source code repository for examples, classes or snippets that relate to their problem, and further gives them the information necessary to safely use that source code (license, author, language, etc.)

+See also=

Elements that come up often in practice

Base Elements