<?xml version="1.0" encoding="UTF-8"?>
<essay xml:lang="en" version="pto" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:dcterms="http://purl.org/dc/terms/" xmlns:gal="http://norman.walsh.name/rdf/gallery#">
<info>
    
    
    
    
    
    
    
<title>WITW Versioning and Extensibility</title><biblioid class="uri">http://norman.walsh.name/2005/02/21/witw-versioning</biblioid>
<volumenum>8</volumenum>
<issuenum>29</issuenum>
<pubdate>2005-02-21T15:33:31-05:00</pubdate>
<date>$Date: 2005-09-11 10:27:02 -0400 (Sun, 11 Sep 2005) $</date>
<author>
      <personname>
<firstname>Norman</firstname>
	<surname>Walsh</surname>
</personname>
    </author>
<copyright>
      <year>2005</year>
      <holder>Norman Walsh</holder>
    </copyright>
<abstract>
<para>Norm plays fast and loose with the experimental web service.</para>
</abstract>
<dc:subject rdf:resource="http://norman.walsh.name/knows/taxonomy#WebServices"/>
</info>

<para xml:id="p1"><personname>
      <firstname>David</firstname>
<surname role="suppress">Orchard</surname>
    </personname> 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.</para>

<para xml:id="p2">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.</para>

<para xml:id="p3">That said, I'll try to minimize the damage.</para>

<para xml:id="p4">As of today, I've updated the following schemas:
<link xlink:href="examples/is-request.rnc">is-request.rnc</link>,
<link xlink:href="examples/is-reply.rnc">is-reply.rnc</link>, and
<link xlink:href="examples/ami-reply.rnc">ami-reply.rnc</link>.
These are used by the
<link xlink:href="../16/witw-part-1">RESTful services</link>.</para>

</essay>

