Documented expected compatibility between releases for the SOAP API

rombert · rombert · commit f58911eb7564 · 2011-12-06T12:19:39.000+02:00
diff --git a/docbook/developers/en/integrators.sgml b/docbook/developers/en/integrators.sgml
@@ -41,6 +41,18 @@
 			Eclipse Orbit</ulink>
 		</sect2>
 	</sect1>
+ 
+        <sect1 id="integrators.compatibility">
+                <title>Compatibility between releases</title>
+ 
+                <para>The SOAP API signature will change between minor releases, typically to add new functionality or to extend existing features.
+                </para>
+                <para>Some of these changes might require a refresh of the client libraries generated, for instance Apache Axis 1 SOAP stubs must be
+                regenerated if a complex type receives a new property. Such changes will be announced before the release of the new MantisBT version
+                on the <ulink url="http://lists.sourceforge.net/mailman/listinfo/mantisbt-soap-dev"> mantisbt-soap-dev mailing list</ulink> . 
+                Typically there will be two weeks time to integrate the new SOAP stubs.</para>
+
+        </sect1>
 
 	<sect1 id="integrators.support">
 		<title>Support</title>
