WITW Versioning and Extensibility

Volume 8, Issue 29; 21 Feb 2005; last modified 08 Oct 2010

Norm plays fast and loose with the experimental web service.

David will be appalled, but I've decided to play a bit fast and loose with the extensibility and versioning of WITW. What this means in practical terms is, I may change the APIs in backwards-incompatible ways as the service evolves.

When (if?) the system reaches a point of relative stability then I'll put a stake in the ground and try to move forward in a compatible way. In the meantime, I'm trying to balance my personal goal of learning more about web services with the apparent popularity of the service (at least among a small number of people). Managing the schemas in a rigorously backwards and forwards compatible way is just a little too distracting right now.

That said, I'll try to minimize the damage.

As of today, I've updated the following schemas: is-request.rnc, is-reply.rnc, and ami-reply.rnc. These are used by the RESTful services.


Hey, I'm appalled! Actually, I think that versioning "pre-release" stuff in incompatible ways - like changing ns names for W3C WDs - is a great thing. It's a feature that forces all others to upgrade.

Keep up the great work!

—Posted by Dave Orchard on 28 Feb 2005 @ 03:28 UTC #