Regarding the Indie Web : Who

Who is the Indie Web?

The Indie Web is made of people. It’s made by me. It can be made by you too. There’s no gatekeeper. You can join anytime without anyone’s permission. The Indie Web is made by everyone.

The Indie Web community is a small but growing group of people from several countries. We’re on a few but not not continents. We are hiding in plain sight, or rather we’re not hiding at all. We have jobs in tech and not in tech. We build our own software or install other’s (like WordPress or Known). We are designers, developers, devops, UX and non-technical folks.

The Indie Web community is not as diverse as it could be and needs to be. Admittedly, the community is overwhelmingly white men. There are some women and some people of color. But we need to do much better at reaching out to people, at being more inclusive and at sustaining a diverse community. Because if the Indie Web is going to succeed, it must represent the rich plurality of people in the world.

We are working hard at making the Indie Web not just for us by us, but for all of us by all of us.

Originally published at veganstraightedge.com on June 5, 2016.

Regarding the Indie Web : Where

Where is the Indie Web?

The Indie Web is everywhere. The Indie Web is nowhere. The Indie Web is anywhere you can access the internet.

Personal Websites

The Indie Web is simply the web when it’s owned and controlled by individuals on their own domains. The Indie Web is that place where someone publishes a creative work to her own website. The Indie Web is on individual’s personal domains and in the interactions directly between them. The Indie Web is when just a copy is syndicated out to imperialist website silos. The Indie Web is of the internet on our personal websites.

Conversation

The Indie Web is, of course, just made of people. The Indie Web community regularly gathers in an IRC channel #indiewebcamp on freenode.net (with a Slack bridge called, indiewebcamp). There’s also a web version at http://indiewebcamp.com/irc/today.

IndieWebCamp

Once per year, we meet in Portland, Oregon, United States for the Indie Web Summit (started in 2011). Additionally, other IndieWebCamps have been organized in multiple cities in the United States and in Europe. We hope to add more cities and in more continents.

Homebrew Website Club

Also, in multiple cities in the United States and in Europe smaller groups meet up more frequently and more informally at a meet up called Homebrew Website Club. At HWC, we share with each other our progress in building and improving our websites. We encourage each other to continue our improvements. And in some cities, there is a silent writing hour where attendees simply write new material for their website.

Both Homebrew Website Clubs and IndieWebCamps are free and available to anyone who owns their domain or wants to. Anyone can also organize a Homebrew Website Club or an IndieWebCamp in their city.

Originally published at veganstraightedge.com on June 5, 2016.

Regarding the Indie Web : How

How Can You Get on the Indie Web?

The Indie Web is not a place separate from the web that you already know and use. The web that you’re probably reading this article on right now.1 The Indie Web can be almost anywhere on the web.

Domain

The first step to getting on the Indie Web is to own your domain. 2

A domain (or sometimes called a “domain name”) is the part of a URL that looks like example.com. On my website, my domain is veganstraightedge.com. It doesn’t have to end in “.com”. It could be .org, .net, .info, .biz, .me or country codes 3 like .io, .it, .co or all kinds of new TLDs4 like .limo, .club, .ninja.

You can buy a domain from any number of registrars. I recommend hover.com if you’re just buying one or a few domains. If you find yourself owning 10 or more, I suggest using dnsimple.com. I implore you to avoid godaddy.com. Even if they’re selling the domain you want for a few dollars cheaper than others. Everyone I’ve ever known that used GoDaddy regretted using them later.

Try to think about the longevity of your the name you choose. Will you still want to use this domain in ten years? In fifty? Always a reliable classic is your name at some TLD. shanebecker.com, shanebecker.me, etc.

Some websites that provide the publishing software (like SqaureSpace or WordPress) will also sell you a domain directly through your account settings. And when you buy it through them, they also configure it to Just Work™ for your site.

For example, when you sign up with WordPress.com you choose a subdomain for your WordPress blog: veganstraightedge.wordpress.com. But when you buy veganstraightedge.com through WordPress, they set it up so that only veganstraightedge.com is ever shown to the world instead of veganstraightedge.wordpress.com.

It’s critically important that you don’t use a subdomain (like veganstraightedge.wordpress.com or veganstraightedge.tumblr.com) as your primary website. The reason is that you don’t really own any subdomain.5 If you ever decide to move to different publishing software (like from Tumblr to WordPress) none of your URLs can be moved. And good URLs don’t change.

Publish

Once you’ve got a domain, publish something. Publish lots of somethings. Publish to your heart’s content. And then publish some more.

Publish short text notes. Publish longer structured articles with titles and HTML formatting (if you want). Publish bookmarked links, photos and videos. Anything that you currently publish on other sites, like Twitter, Facebook, Instagram, YouTube, etc.

Later on in the process of expatriation from the corporate silos that currently control what and how we publish to the autonomy of the Indie Web, there’s a process called syndication where a copy of your post is sent to a silo for greater distribution or visibility for people you want to see your post but don’t go to your site. E.g. friends and family on Facebook.

We call this process of syndication POSSE. That stands for Publish (on your) Own Site, Syndicate Elsewhere. I’ll cover POSSE in more depth in a syndication specific post.

About Me

Or about you, really.

On your site, there’s probably a header, sidebar or footer place for you to put some information about yourself. Your name, your photo or avatar, some URLs and usernames on other sites. If you feel comfortable doing so, your phone number and/or email address. Maybe even a short paragraph or two bio about you. You can expand this even further by creating a page (typically called “About” at the path of /about). You can also add a resume/cv and/or portfolio. Or you can do something completely different. It’s your site, your identity.

Summary

Get a domain. Find some publishing software (or if you’re feeling adventurous, build your own). Publish some posts. Include an about me section. Write an about me page (and for bonus points, a resume).

Now you’re on the Indie Web!

There’s some additional technology under the covers that will improve your experience, but all of that requires that you’ve done these parts first.


1. Unless someone printed this article from a webpage and handed it to you.^

2. Technically we only ever rent our domains from registrars who in turn rent them from ICANN, but that’s a different post for a different time.^

3. Something to consider when buying a country-specific domain is the longevity of that domain. Are there certain rules that apply to who can own a domain in that country? Eg, do you have to be a citizen of that country? Does that country have laws that don’t apply to you as a non-citizen, but would apply to your domain that might cause your domain to get shut down by a foreign government? Some countries have a “morality” clause and if you’re LGBQT, they might shut down your website at anytime. See for example .ly domains, like Violet Blue’s short domain, getting shut down by the Libyan government.^

4. The part that comes after the dot in a domain is called a Top Level Domain. The “com” in “veganstraightedge.com” is the TLD.^

5. Unless, of course, you also own the domain that the subdomain is on. Like if I decided to use blog.veganstraightedge.com instead of veganstraightedge.com. I still own veganstraightedge.com so the blog subdomain is still completely under my control.^

Originally published at veganstraightedge.com on June 5, 2016.

Regarding the Indie Web : Why

Why Get on the Indie Web?

In a word, autonomy.

Call it freedom or agency or control or ownership. Call it any number of things, but no one knows how to live your life better than you do.

The current state of the web for most of us most of time looks like this. We go to one website or app and publish some post. Then we go to another site or app to publish a different kind of post. Or maybe we cross post it from one site to another. All of those sites and apps are by other people or corporations. They all have a different set of users with different usernames, and different networks, with their own cultures and norms.

New sites and apps come along. We try them out. Some go out of business or get acquired and “sunsetted”. The sites get shut down. Our posts and URLs get destroyed forever. Rinse and repeat on another site over and over.

Nevermind the communities that take shape on these sites. Nevermind that when these sites get shut down the communties get disappeared too. We all find support through communities. If a community that we’ve come to depend on disappears, that can have a real impact on our lives.

Get Free

All good things are wild and free. But we can’t be wild and free on an imperialist website silo1 that’s owned and controlled by someone else, especially a silo owned and controlled by a corporation whose business model is surveillance and advertising. We can only be wild and free through a model of self-determination and mutual aid.

Any website that we publish our creative works to controls the terms and context under which we publish.

Some reasons to control your own website instead of solely trusting silos are: content censorshipterms of serviceprivacyadvertising / monetizationthe algorithmidentitylongevity.

If they want to delete our posts or account, they can for any reason with no warning. If they want to sell or give information about us and our activity to advertisers, law enforcement or governments, they can without our knowledge or consent. If any money is made from your published posts (say, from advertising views), you don’t see any of that money.

Stay Wild

We love power and hate authority.
— Crimethinc

By participating in the Indie Web, you are helping to create an alternative to the corporate-owned, advertising-subsidized surveillance state of imperialist websites like Facebook, Twitter, Instagram, YouTube (and all the rest).

The  Indie Web looks like owning your personal website and publishing all of your creative works there. Notes, articles, photos, videos, events, rsvps, likes, bookmarks… all of the things. You publish how and where you want. Your friends, family, followers and fans can read and view your posts how and where they they want.


1. When I say a “silo”, think of a corn silo. There’s stuff inside of it. There is not stuff outside of it. It does not connect to other things. Everything is just inside of it. Some people call these “walled gardens”, but I think that’s giving them too rosy of a description. I don’t think Facebook is a garden where things bloom and grow. I don’t want to eat anything that’s grown in there. ^

Originally published at veganstraightedge.com on June 5, 2016.

Regarding the Indie Web : What

What is the Indie Web?

It’s not a place. It’s not social network. It’s not a website, Slack channel or secret club. It’s not on the dark web. It’s not a new protocol. It’s not a new format. It’s not an app or specific software.

Fundamentally, the Indie Web is an idea!

The idea is that any person can and should have their own website on their own domain that they own and control.

I can’t speak for anyone else, but I believe that as a culture we must expand our definition of human rights to include two more things.

  1. All humans have the right to access, read and participate on the Internet free of restriction, censorship and surveillance.
  2. All humans have the right to own a website that they have complete control of free from censorship for the entirety of their life and that is preserved after their death.

The Indie Web is a small step forward toward these goals.

Originally published at veganstraightedge.com on June 5, 2016.

Rorschach and Roomba

The Great Drowning

The ocean cracked and told us with a smile, “the world will flood”.

And to prove it was serious, the ocean flooded one particular coastal city. Calling a “flood” is being too generous. It was a drowning. There was no safe ground high enough, no rooftop above it all. There was no time for escape and nowhere to escape to. Everyone, everything, was just gone, completely lost.

There are no words to describe what that was like, to see a city of millions swallowed up by the ocean, disappearing like it never even existed. No words are big enough or surreal enough. None are scary enough.

That snapped us all awake. Cities started organized plans. Politicians made speeches. Religious buildings were swarmed with both devout followers and new believers. Some people “headed for the hills,” literally. Military vehicles seemed to be everywhere all the time: on the roads passing in front of us, in the sky flying above us and in the sea launching from our docks. Where they were coming from or going to was completely unknown. They never stopped. We never asked.

We all knew what was coming, but not when. After some days (it’s all a blur now) the all-consuming, urgent feeling that screamed “we’ve got to do something, anything” began to subside. We were struck by a combination of “seriously, what can we do against a city-sized flood the whole world over” and “I don’t want to think about it, maybe it’s not going to happen” and “this is the fates, I’ll make it or I won’t (probably won’t).” Whatever the motivation, the end result was a lot of us went back to our daily routines. We stopped planning our bug-out bags, stopped tabulating what we wanted to take with us, to wherever we’ll be sent to, by whomever would be coordinating some rescue evacuation… for the whole planet.

The Watchmen

It was Halloween. Or there was a comic book convention. (Again, it’s all kind of a blur and these details don’t really matter now.) We were all wearing costumes… of comic book characters. Well, everyone but me. I don’t remember why I wasn’t, but I wasn’t. They were dressed as The Watchmen: The Comedian, Silk Spectre II, Dr. Manhattan, Ozymandias, Nite Owl II and Rorschach.

She was the most excited about it all. Even though the world was going to end in a giant flood and we’d likely all die from it, we were going to dress up as comic book characters and have some fun. She insisted and her insistence was contagious. She was Silk Spectre II, of course. It was a pretty hot day to be in full costume, but no one really cared.

Except Rorschach. It’s like he completely put on Rorschach’s character, not just Rorschach’s costume. He wouldn’t budge. “This is stupid. It’s too hot. I’m wearing a million layers. I’m not doing this.” It was a standoff. They couldn’t be The Watchmen without Rorschach, but he wouldn’t be Rorschach. Not in this heat. “This is stupid.”

Again, I don’t remember why I wasn’t wearing a costume to begin with, but there I was. So, I got enlisted to be Rorschach. The world was going to flood… sometime, but today we were going to dress up as The Watchmen and have some fun. Or so we thought.

I put on the Rorschach costume. Which to his credit, was very hot with all the layers on, but it didn’t matter right then. Things like “these clothes are too hot” weren’t important anymore. The one change I made to the Rorschach costume was that I didn’t want to paint my face, I wanted to wear a mask. We found some muslin in the closet, did a quick cut/sew job and applied the Rorschach Test inkblots with some permanent marker.

“Good enough! Let’s get going before…” I don’t remember what I was going to say. Before what? No idea. It doesn’t matter. Our “normal” lives completely ended right then. For the second time. Really, they had ended with The Great City Drowning. And then again here, in the middle of my sentence about going before something, when I saw a snake fall (jump really) out of a tree.

My first thought was, I didn’t know we had snakes in the city, let alone really, really big snakes. Snakes measuring several feet long. My second thought was to (almost) convince myself that it wasn’t a snake at all, but instead a really big branch that had fallen. But then another snake jumped from the tree. Then a third. A fourth. We all crowded to the window to watch. And what we saw was our world disappearing and every living thing in the world realizing that.

It turned out that the flooding of the world wasn’t a giant crashing wave out of some old Japanese painting. It was more like the draining of a bathtub in reverse. There was water in the streets. It had a current. It was slowly rising. (We couldn’t see any cars anymore.) And it would soon be as high as the stoop at the front of our house.

I had tried to imagine this moment so many times. How would I feel? What would I do? In none of those scenarios did I imagine this. Somehow, right then, we were all fine with it. We felt no panic, no urgency. Anything that resembled “a plan” was instantly forgotten. We didn’t grab our bags that we had packed and re-packed. We didn’t run in circles and scream about. We were calm and accepting. This was it.

Still in costume as The Watchmen, we all left the apartment and made our way down the long series of hallways that led to the front door. For whatever reason (and I still can’t understand or explain this now), I was carrying my Roomba. Not food, not a dry sack of clothes or drinkable water or a medical kit, not even an inner tube. Just my Roomba.

Here was the weirdest thing (in a world recently full of impossibly weird things): the hallway was littered with other Roombas. Did they all go rogue and try to escape, until their batteries died? Did their owners, like me, start to bring them, before realizing that the water would destroy their electronics? I don’t know. But there they were, laid out in front of us: a graveyard of Roombas.

“It’s strange. I never had a Roomba and I still kind of want one,” said my roommate, who was dressed (painted) as Dr. Manhattan. (He was chosen to be Dr. Manhattan because he was the tallest. The costume was a tiny swimsuit brief and lots of blue body paint.)

“Take one”, I said. “There’re plenty just sitting there.”

“OK,” he said as he picked one up off the floor by its handle.

“Not that one. That’s an older one. It’s too heavy.” I explained, as if the weight somehow mattered.

“This one?”

“That’s pretty good, but a bit big. Oh! That other one there. It’s a newer one. It’s small and light,” I said, again as if the size or weight of a robotic vacuum cleaner mattered when the Earth was flooding. I still don’t know why he wanted one and why I cared which one he took. It’s a blur, like everything Pre-Flood.

So, there we were: two grown men dressed as Dr. Manhattan and Rorschach, carrying Roombas, walking to the end of the world.

By the time we made it to the front door and stepped outside, only the top step of the stoop was still visible. The water’s current was constant, but not frighteningly fast. No whitewater rapids whipping through the Grand Canyon on a family adventure, it was instead a summer river float, missing only the floating cooler of drinks. We stepped into the current and began the gentle but sure process of being swept away from our old lives.

The water was tepid and salty. There was no point in swimming, only floating. The current did all the work. I’m sure that someone got hurt from unseen underwater obstacles, like cars and fences and trees, but I never saw it happen. There was something different about this water: everyone floated. I had never gone to the Dead Sea (and now, I guess I never will), but I imagine it was like something like this. Maybe it was the salt density, maybe it was something else. There’s still so much that is unknown about what happened.

All I do know is that everyone floated. It wasn’t just humans floating away to the end of the world. There were the snakes that jumped from the tree, and there were monkeys in there too. Monkeys! I don’t even know why there were monkeys in the city. There were also, of course, cats and dogs. Other small animals: squirrels, mice, rats. Everyone.

Somehow, the strangest part wasn’t the menagerie of non-human animals in the water with us. It was everyone’s total calm. There was absolutely no fighting, either with each other or against the water. We all just floated together. I even bumped into a snake with my foot at one point and it simply slither-swam a bit farther away from me. We had all accepted that this was the fates at work.

And then, my memories fade away. Just black.

The Awakening

It’s frustrating; there’s so much I don’t recall: I don’t remember where we floated to or how we got there. I don’t remember when or how the water went away. I don’t remember waking up or if I was ever not awake in the first place. My first fuzzy memories Post-Flood were walking through some streets, somewhere in the city. We were still together as a group, still damp, and still dressed as The Watchmen. Dr. Manhattan’s body paint had mostly washed off. I don’t remember why or when I stopped carrying that Roomba around, but I don’t have it anymore.

The water was mostly gone. Minor puddles here and there were caught in bird baths, car roofs, potholes. The evidence of flooding was everywhere. Water lines visible several stories high on the sides of buildings. Overturned newspaper boxes. Cars swept away and collected around a street pole. Debris everywhere. Everything that you’d expect from a giant flood. Everything except the water.

We wandered. Everyone wandered. Completely dumbfounded. Eventually, we found a small crowd that seemed to have some purpose. (I’ve never understood why humans instinctually group to each in times of uncertainty or danger. There’s probably some evolutionary reason.) We gravitated to and then into this group.

Amazingly, there was still no hysteria, just an eerie calm of “we went through this thing and all survived somehow”. People shared what little they had: food, water, clothes. The one thing not in short supply, shared liberally from person to person, was information: rumors, facts, personal stories, theories. And the information spread fast.

We heard all the religious explanations of the flood and our survival. It was The Rapture, The Great Flood, Noah. Those were just the Christian stories. Eventually, we heard all of it. So when people spoke of Arks, we didn’t think much of it. When we heard stories of bubbles, orbital cities and space tunnels, we didn’t think much of it. There were a million pet theories flying about on what happened, why, how.

But this sci-fi story was the one that stuck around the most. It went something like this:

Somehow they (and who they are was never clear) knew for a long time that something like this was going to happen and had been planning an escape route. They built massive retractable spheres underneath a few dozen cities and “important areas.” The top half of the sphere remained retracted underground. They got ready after the ocean told us that the world would flood. But they wanted to be sure it was really real before revealing their giant secret operation.

Once the coastal cities started flooding, they initiated the sequence. It took a long time for each sphere to spin up and cover the whole city. In that time, massive flooding overtook the cities and those of us inside began to float. When the sphere had fully enclosed the city, it detached itself from the earth and launched out into lower orbit with its inhabitants floating inside.

After the city spheres reached their new homes in space, they tethered to one another, forming space tunnels, a kind of subway through the black. The flood waters from each city sphere were drained into smaller spheres that now comprise the only source of water for us, the living colony of orbital spheres in space.

It still sounds insane to say it out loud. But it was just one of the many crazy rumors about what had happened to our lives and our world. Regardless of how many times we heard it, we still didn’t really believe the story.

When the military and the politicians came around and confirmed this story, we didn’t believe it. When somehow the power came back on for a little while and the news people on TV told us this story, we didn’t believe it. It was too unbelievable of a story to possibly be true.

It wasn’t until we made it out to the edge of the city, a place we now call The Coast, that we started to truly believe. Even then, it took some time, time to re-wire our brains, brains that had only known of millions of years of human terrestrial evolution.

We stood there at the edge of our city that had become a world, and we stared back at Earth. Earth. It seems like such a lie to call it that anymore. The Blue Marble. It really was The Blue Marble now, with no land or cities or lights to taint its watery hue.

We stared at Earth, massive in front of us, and at the other city spheres, connected to us via massive tunnels through space. We stared and tried to believe in our brains what our eyes were showing us. That these city spheres were now our world. Somehow, “world” and “earth” were no longer the same.

The Epilogue

There’s still so much we don’t know. I mean, we normal people. We survivors. We don’t know what caused this, or who knew it was coming. We don’t know how long they knew or even who “they” are. We don’t know their long-term plan. We don’t know if anyone survived back on Earth, in submarines, on boats, in the mountains.

Are we ever going back to Earth? Will the water ever recede? Was there a coordinated global effort to plan and execute this escape plan? On a more practical note, once our food supplies run out, how will food production and resource consumption be handled? Will population control be necessary? How freely will be able to travel between city spheres? Will there be a “global” government now?

How did they do all of this undetected? How are they able manipulate gravity in our city spheres to emulate Earth’s gravity? What was the extent of the extinction of species planet-wide? How many billions of humans and non-humans died while a few million survived?

And underneath it all: what will our lives be like now? What will our world be like? Incredibly, improbably, we have somehow immigrated out into black space, avoiding annihilation. How much farther will we explore outward?

So much that we don’t know. So many questions. It’s all still too overwhelming. I think that for all of us that survived, it will always be too unreal to fathom clearly. It’ll take a generation or two born into this life to really accept it. That is, if we continue to live this life.


Based on a dream I woke up from on the morning of 2013-08-01.

(Edited by Abby Phoenix)


Originally published at: http://sbb.me/b4Rv1

JSON-LD is an Unneeded Spec

Today I learned about a proposed spec called JSON-LD.
The “LD” is for linked data
(Linked Data™ in the Uppercase “S” Semantic Web sense).1

From the JSON-LD site:

Data is messy and disconnected. JSON-LD organizes and connects it, creating a better Web.

Linked Data empowers people that publish and use information on the Web.
It is a way to create a network of standards-based, machine-readable data across Web sites.
It allows an application to start at one piece of Linked Data, and follow embedded links to other pieces of Linked Data that are hosted on different sites across the Web.

JSON-LD is a lightweight Linked Data format. It is easy for humans to read and write.
It is based on the already successful JSON format and provides a way to help JSON data interoperate at Web-scale.
JSON-LD is an ideal data format for programming environments, REST Web services, and unstructured databases such as CouchDB and MongoDB.

Linked data. Web sites. Standards. Machine readable.

Cool. All of those sound good to me.
But they all sound familiar, like we’ve already done this before.
In fact, we have.

Linked data
That’s just the web, right? I mean, we’ve had the <a href> tag since literally the beginning of HTML / The Web. It’s for linking documents. Documents are a representation of data.
Web sites
If it’s not wrapped in HTML and viewable in a browser it, is it really a website? JSON isn’t very useful in the browser by itself. It’s not style-able. It’s not very human-readable. And worst of all, it’s not clickable.2
Standards based
To their credit, JSON-LD did license their website content
Creative Commons CC0 Public Domain.
But, the spec itself isn’t.
It’s using (what seems to be) a W3C boilerplate copyright / license.
Copyright © 2010-2013 W3C® (MIT, ERCIM, Keio, Beihang), All Rights Reserved. W3C liability, trademark and document use rules apply.
Machine readable
Ah… “machine readable”. Every couple of years the current trend of what machine readable data should look like changes (XML/JSON, RSS/Atom, xml-rpc/SOAP, rest/WS-*).
Every time, there are the same promises. This will solve our problems. It won’t change. It’ll be supported forever. Interoperability.
And every time, they break their promises.
Today’s empires, tomorrow’s ashes.3.

Instead of reinventing the everything (over and over again), let’s use what’s already there and what already works.
In the case of linked data on the web, that’s html web pages with clickable links between them.
For open standards, open license are a deal breaker. No license is more open than
Creative Commons CC0 Public Domain
+
OWFa.
(See also the Mozilla wiki about standards/license, for more.)
There’s a growing list of standards that are already using CC0+OWFa.

No process is more open
than a publicly editable wiki. (Mailing lists are toxic.)

Finally, for machine readable data, nothing has been more widely adopted by publishers and consumers than microformats.
As of June 2012, microformats represents about 70% of all of the structured data on the web.
And of that ~70%, the vast majority was h-card and xfn.
(All RDFa is about 25% and microdata is a distant third.)

Maybe it’s because of the ease of publishing microformats.
Maybe it’s the open process for developing the standards.
Maybe it’s because microformats don’t require any additions to HTML.
(Both RDFa and microdata required the use of additional attributes or XML namespaces.)
Whatever the reason, microformats has the most uptake.
So, why do people keep trying to reinvent what microformats is already doing well?

Back to JSON-LD.
The “Simple Example” listed on the homepage is a person object representing John Lennon.
His birthday and wife are also listed on the object.

{
  "@context": "http://json-ld.org/contexts/person.jsonld",
  "@id": "http://dbpedia.org/resource/John_Lennon",
  "name": "John Lennon",
  "born": "1940-10-09",
  "spouse": "http://dbpedia.org/resource/Cynthia_Lennon"
}

I look at this and see what should have been HTML with microformats (h-card and xfn).
This is actually a perfect use case for h-card and xfn:
a person and their relationship to another person.
Here’s how it could’ve been marked up instead.

<div class="h-card">
  <a href="http://dbpedia.org/resource/John_Lennon" class="u-url u-uid p-name">John Lennon</a>
  <time class="dt-bday" datetime="1940-10-09">October 9<sup>th</sup>, 1940</time>
  <a rel="spouse" href="http://dbpedia.org/resource/Cynthia_Lennon">Cynthia Lennon</a>.
</div>

You can throw in a little bit of decoration for improved human readability without comprising machine readability.

<div class="h-card">
  <a href="http://dbpedia.org/resource/John_Lennon" class="u-url u-uid p-name">John Lennon</a>
  was born on
  <time class="dt-bday" datetime="1940-10-09">October 9<sup>th</sup>, 1940</time>
  and was married to
  <a rel="spouse" href="http://dbpedia.org/resource/Cynthia_Lennon">Cynthia Lennon</a>.
</div>

This HTML can be easily understood by machine parsers and humans parsers.
Microformats 2 parsers already exists for:
JavaScript (in the browser),
Node.js,
PHP and
Ruby.
HTML + microformats2 means that machines can read your linked data from your website and so can humans.
It means that you don’t need an “API” that is something other than your website.

Please don’t waste time and energy reinventing all of the wheels.
Instead, please use what already works and what works the webby way.


1:
In its footer, the JSON-LD site mentions that it’s a “Part of the PaySwarm standardization initiative“.
Which in turns claims to be “The Universal Payment Standard”. An awfully big claim.
But, that’s another post for another time.
^

2:
Hell! You can’t even put comments in your JSON.
^

3:

  1. 2005-2009(?): StructuredBlogging
  2. 2005-2011: Google Base schema
  3. 2007-2011(?): Google Data API/Elements
  4. 2009-2009(?): Yahoo et al CommonTag.org
  5. 2009-2011(?): Google rdf.data-vocabulary.org
  6. 2010-present Facebook OGP meta tags
  7. 2011-present Google+MS(Y!) Schema.org
  8. 2012-present Twitter Cards meta tags
  9. 2012-present OpenMetadata.org

(source: tantek.com)
^

Originally published at: http://sbb.me/b4RR1