Skip to content

Commit

Permalink
update
Browse files Browse the repository at this point in the history
  • Loading branch information
kinlane committed Jul 14, 2013
1 parent ac9d60e commit dcc9f3c
Showing 1 changed file with 47 additions and 0 deletions.
@@ -0,0 +1,47 @@
---
layout: post
title: 'Hacker Storytelling: Open and Machine Readable By Default'
url: 'http://apievangelist.com/2013/07/13/hacker-storytelling-open-and-machine-readable-by-default/'
image: 'http://kinlane-productions.s3.amazonaws.com/api-evangelist-site/blog/open-machine-readable.png'
---


<p>
<img src="https://s3.amazonaws.com/kinlane-productions/hacker-storytelling/open-machine-readable.png" alt="" width="225" align="right" />
</p>
<p>
The primary reason I'm switching all of my <a href="http://apievangelist.com/2013/07/01/the-expanding-api-evangelist-network/">35+ research projects</a> in the API space to my new <a title="Hacker Storytelling" href="http://hackerstorytelling.com">Hacker Storytelling</a> format, is to make everything I do open and machine readable by default.
</p>
<p>
Every project I'm working on is a Github project, with the public side of the research always available via an API Evangelist subdomain and pointed at a Github page. I publish a series of static pages, wrapped in an API evangelist template, combined with a blog to help organize my curated news and analysis in a chronological way.
</p>
<p>
Along with all the pages and blog I make all data available as JSON files, which I display across the research project using JavaScript templates. My goal is to make every bit of my research machine readable by default, and ensure the widest possible re-use and distribution.
</p>
<p>
One active example of this in the wild, is my r<a title="Backend as a service" href="http://baas.apievangelist.com">esearch around backend as a service</a>, also known as Baas. I've been monitoring all the providers in the space for the last year, and tracking on some of the common building blocks they use, much like I have been doing with APIs for last three years.
</p>
<p>
As part of my BaaS research I've published two datasets:
</p>
<ul class="mainlist">
<li>
<a title="BaaS Providers" href="http://baas.apievangelist.com/companies.html">BaaS Providers</a>
</li>
<li>
<a title="Common Building Blocks of BaaS Providers" href="http://baas.apievangelist.com/building-blocks.html">Building Blocks</a>
</li>
</ul>
<p>
<img src="https://s3.amazonaws.com/kinlane-productions/hacker-storytelling/machine-readable-toolbar.png" alt="" align="right" />
</p>
<p>
You can view the data on the website, using JavaScript templates that display the JSON data on HTML pages. When you view the page that lists the BaaS providers or the common BaaS building blocks, you can choose to get at the data behind the display as JSON, via API, as well as being able to grab the script I use to display the JSON data.
</p>
<p>
All of my research is ongoing, and I publish news, analysis and new companies and research on a regular basis. My goal with this evolving approach, is to remove machine readable from being after thought, making it default in all my work.
</p>
<p>
With data available via JSON and API, everything published publicly via Github, in lightweight formats like HTML, CSS, JavaScript and JSON, combined with a CC BY-SA licensing, everything in my world is open and machine readable by default.
</p>

Expand Down

0 comments on commit dcc9f3c

Please sign in to comment.