It feels weird to say this, since I only started writing 7 days ago, but I only have to write two more chapters, wrap it all up with a conclusion, and then focus on formatting and making it pretty for a night or two. That's right: I'm almost done! It also means we're nearing the release date, and that's when the price is going to go up. If you want the discount, you should pre-order now.
Pre-Order Now for only $12!
Last night, after two evenings spent on it, I finished the Best Practices chapter. It turned out to be about 3,500 words spanning nearly 15 pages... and that's not including HATEOAS, which will have its own dedicated chapter. And still, this is the most concise and pragmatic book on REST that I think has ever existed.
I don't expect to convince everyone that my way is the right way, but all of my advice is based on heaps of research and informed by years and years of personal experience with every aspect of APIs: design, development, framework development, clients, client-wrappers, and 3rd party consumption. If I can help a few people learn what they need to learn to get their jobs done, then I've done my job.
Published 2014-12-12 @ 09:15 in
This is another update in my ongoing saga:
Adam is writing a book, and you should buy it! And you totally should. Buy it, that is. Especially if you think you will need it sooner or later: The price is only $12 if you pre-order now, and will be increased to $19 once it has been released.
As you can see in the below Trello screen shot, the first completed chapter is called "Webster's Dictionary defines REST as..." (a cheeky title for the REST 101 crash-course chapter), in which I will take you from knowing absolutely nothing about REST to being able to at least hold a conversation about it. You'll get all of the necessary vocabulary and have a loose grasp of what is included in RESTful requests and responses; and why REST is popular.
The two chapters I finished tonight are: "Some History, If You Want It" and "Close to the Metal." The first is a summary of the history of REST and AJAX (because why not?), and I also start to dive into what makes REST confusing at times: Controversy!
It sounds good on paper when you’re only writing about the concept, but when you start to implement it you find yourself asking questions to which Fielding has conveniently failed to provide an answer.
"Close to the Metal" is a look at some raw HTTP requests and responses. First, a regular web page, then a REST request.
Both of these chapters ended up being on the brief side — A good thing, I think. I'm not aiming to fill your day with reading, I want a streamlined and pragmatic explanation of everything you need to know, and nothing you don't. If you've been meaning to learn what all the REST hype is about, now is your chance:
Pre-Order Now for only $12!
I'm up to 3,800 words and 17 pages, with 3 chapters complete and 5 left to go, plus an introduction and conclusion. One of those chapters in particular — the one on Best Practices — has a monster of an outline, and that's after I split HATEOAS into its own chapter. I might have to split something else out, too. I can't have one chapter take up fully one third of my book. Or maybe I can... Would anyone notice?
When I laid out the schedule, my plan was to write one chapter per night (two nights for the Best Practices chapter). This had me finishing writing on Sunday the 14th, with the remaining days set aside for editing copy and polishing the final product... plus room for slippage. I'm thrilled to be ahead of schedule, but as a programmer I know that it won't last.
Published 2014-12-08 @ 09:00 in
"Wait, you haven't written anything yet?" I hear you asking. Well... no. I haven't. We'll come back to that in a second.
What has happened so far is that I've almost completed outlining the book, gathering links to information I'll draw on, and links for further-reading should you want it. As they say in the cooking industry: My Mise en Place. And I would be further —maybe a chapter or so done— but the wife and I were still an episode behind on Sons of Anarchy last night (the penultimate episode of the final season!) and this is all I have to say about that: OMG.
Anyway, back on topic: Yes, I haven't actually written anything yet... in book form. You see, I've been writing about REST and presenting on it for years now. I have half a dozen or so slide decks, dozens of blog posts, and a whole mailing list full of advice I've been giving out. The book is kind of a way to take all of that content, gather it up in one place, strip it down to just the bits that matter, and present it in a well organized fashion.
The writing should start tonight, after I finish outlining the last chapter: Concrete Examples using Taffy. I'm so excited to finally get to work on the finished product. I'm not usually one to be super-organized going into things. In high school I often wrote and turned in the outline after having already completed the paper that was to be the end result. This time 'round I've worked hard to be diligent about being organized and methodical.
Don't forget: Pre-ordering REST Web APIs: The Book gets you a significant discount. Buy it now for $12 before the price goes up to $19 at release!
Published 2014-12-05 @ 11:32 in
Well I'm just starting my lunch break now, so I thought I would take a moment to say THANK YOU to everyone that has pre-ordered my book, and share some interesting stats on the sales so far. I'm a just a little bit excited.
Pre-Order for $12
I posted the extra-discount link to the Taffy mailing list late last night (early this morning, really), and within 7 minutes the first copy sold. The blog post went up at 8:45am local time and my last extra-discount sale was snatched just a couple of minutes later. I'm up to 15 pre-orders now, including the one that sold after I started writing this update. I'll save you the math: That's $170 before fees. That's amazing to me, for what amounts to 10 hours of availability and almost no advance marketing.
I am floored by all of your support. It's wonderful to know that so many of you believe I can put out a worthwhile product. I won't let you down!
I'll be continuing to post updates, snippets, and other fun stats while I continue to write and sell the book. You should subscribe to my blog to get all of that goodness pushed directly to your inbox! There's a subscribe form right over there in the sidebar. Use it!
REST Web APIs: The Book
Published 2014-12-04 @ 12:15 in