I’ve been meaning to do this for years now, but after a recent
reminder
about how poorly understood state is, I decided to make some time.

It’s no where near complete, as you can tell, but I think there’s
enough there to be useful to a lot of people. So I present to you, the
State FAQ!

Of course, like any decent FAQ, it’s on a Wiki, so let’s work
together to make it better. Cheers!

I’ll be hanging out in Sunnyvale Jan 21-23, with the
morning of the Friday (21st), and the whole day Saturday, free.

Who wants to get together?

One thing’s for sure, I’ll be in the mood for a serious sushi outing.
Ottawa’s got to be the worst place on Planet Earth for it; no
sushi-only establishments, and of the
better
Japanese
restaurants,
they don’t do omakase, and the sushi’s only barely passable!

Update; I suppose I should update this to say that Totoya is the first decent Sushi place I’ve found in Ottawa. It’s a bit on the expensive side, but their fish is by far the best I’ve had in town, and rivals meals I’ve had in Tokyo and Vancouver. Sushi 88 is nice as well; good variety and quite affordable, but not quite as tasty as Totoya.

Another good
article
from
Joe.
I left a comment, but wanted to repost it here, since I think
this is the most succinct description I’ve offered for explaining
this critical point.

Nice job again Joe, but I think you’re a little (and I do mean *little* 8-) too rough on the existing service when you say “This is an RPC protocol trying to run over HTTP, and that misalignment is where the problems arise”. With the ListMyQueues and Read operations, putting them in a URI such that a GET returns the data *is* perfectly RESTful. This is because when in URI form, the effective operation – that which the client asks be done, and expects is done when receiving a successful response – is GET, not ListMyQueues.

It’s very(!) easy to
misunderstand
this point; the same point which is also, I believe, the principle impediment which
prevents proponents of document oriented Web services from realizing that REST and the
Web is what they’ve been trying to build.