All posts by Lorinda Brandon

Good News and Bad News

I’ve always been a big believer in the gray areas – nothing is ever just black and white in life. So, I’m not totally surprised to find myself solidly situated in a gray area right now. Let me explain.

Good News

Here’s the good news – the API “economy/revolution/whatever-you-were-calling it” is no longer a secret conversation between a few hundred people and on a couple of websites. We’re proudly out in the open, with governments around the world declaring policies that require APIs for certain industries.

With that kind of support comes a proliferation of conferences and meetups. People are meeting to talk about APIs around the globe on a regular basis. So regular, in fact, that it’s getting harder to schedule events that don’t overlap with each other, leaving many of us with hard choices about which API gathering to attend.

Bad News

And that leads us to the bad news…

We’ve had only a handful of registrations for API Craft this year and lack-luster interest from sponsors (not surprising since there is little visibility for them, being that this is an unconference and all). One of the reasons is that this event overlaps another larger event that many people are going to instead.

So, we’ve come to the hard decision that this year’s API Craft is not to be. For me, personally, that’s a very hard truth because I find this conference to be different from the others… this is more of a working session, where we work together to ask and answer questions that may not come up in the more proscribed setting of a regular conference. It’s also on a par with RESTFest from an egalitarian standpoint – with no speakers on the stage, declaring their truths, everybody attends as an equal in the industry.

For those of you who signed up, we’ll be issuing refunds over the coming week. Thank you for your support.

Never Fear

We’ll try again next year and will hopefully find a space in the calendar where API lovers everywhere don’t have to choose between us and another event.



A name to walk with a swagger‏

Author:  Guillaume Laforge | Product Ninja & Advocate

My company, Restlet, joined the Open API Initiative at the Linux Foundation as a founding member, and one of the first few items discussed among all the members was… the name.

For various reasons related to trademarks and such, it’s actually important to find a name that anybody can use freely. There’s already a short list of names circling around, and I liked the idea of finding a name that somehow recalled the Swagger name, in particular a name starting with “sw” sounded like a good idea.

So I went on a hunt for some cool or fun names!

I fired up my terminal, on my Mac, and typed the following command, to find words starting with “sw”:

cat /usr/share/dict/words | grep ^sw

444 possibilities to go through… let’s see if some of them sound fun or cool!

To find a good name, of course, you should certainly avoid any offensive word, or words which are too long, too complex to spell or pronounce. Then, go through the list, and find good sounding words, which should relate somehow to the topic. Make a sublist with those, and check if they are already taken or not — for instance, one of the short-listed names I mentioned earlier is actually a trademarked product from Microsoft, so let’s avoid trademark infringement problems!

Without much more ado…

let’s see the cool sounding names that I liked or those that made me smile!

  • Swaddle: to wrap APIs in a nice definition cloth
  • Swallow: to swallow the pill of contract-first development?
  • Swank: you certainly need a good deal of swank to walk with a Swagger!
  • Swarf: a “curl” of metal swarf
  • Swear: because you swear when you don’t remember the exact syntax of Swagger API definitions
  • Sweat: as you sweat getting your API out the door in time to please your boss
  • Sweet: because who wouldn’t want a sweet API to use?
  • Swedge: for forging your API
  • Swine: because of the cute pig logos you could create!
  • Swab: to clean the wounds of choosing the right Hypermedia format to use
  • Sword: your weapon of choice for the duel of contract-first vs code-first API development

I must confess I didn’t do the last step of checking my list against already used names.

Out of that list, I’d remove the most “common” words which would drown your keyword in Google searches.

That makes me remove “swallow” (I could see people making bad jokes about that one too), “swear” and “sweat” (same reasons), “sweet” (too generic), or “sword”.

The sole reason I had for “swine” was for the cool possible logos, but otherwise, I’m not really finding any way to relate it to the topic of API development.

A “swab” is certainly not very poetic, and doesn’t relate to the field either.

My own sub-list would thus be: “swaddle”, “swank”, “swarf”, “swedge”

Swaddle starts with the same first three letters of Swagger, and has a doubled letter like Swagger too. The shape of d’s and g’s with their round body is similar, and only the direction of their tails differ. It’s perhaps more because of the resemblance of the spelling that I like it, than for the meaning of the word itself. Thinking about it, it might be harder to find a good logo for that one.

Swank is a word in the same vein as Swagger. To keep the same spirit of showing off how cool your API definition is, I think it could make sense. And I would very well see a logo of a dandy silhouette swinging in style, perhaps with a swirling stick in his hand.

I also like both “Swarf” and “Swedge“, because they are somehow related to (API) crafting. And it wouldn’t be hard to find interesting logos as well.

Drilling in a metal piece gives you curls of swarf, and curl is one of our favorite command-line tools to invoke and test our APIs!

Swedge, is perhaps also about living on the… “edge” of API development? And googling swedge for images shows me some nice knives to craft anything, McGyver style!

So what would you think of those names? Anyone you’d favor over the others? Some other cool meanings or parallels you could make with API development?

Welcome to the API-Craft Blog

Author: Lorinda Brandon (@lindybrandon)

If you’ve been in the middle of, or on the edges of, the booming API industry, you know that there are a million conversations out there. From how to design an API, what kind of business model to put around it, to protocols and formats… there are lots of things to figure out in this space.

My hope is that you will find this to be a safe place to explore, question and hypothesize with the rest of the API community. This blog is intended to be a communal area for all of our thoughts and opinions, and hopefully lessons learned, as we forge our paths in the API economy.

If you have something to say (and you know you do), please send me your ideas and posts so we can keep this conversation a lively one with many voices.