You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by ra...@apache.org on 2006/07/19 18:36:07 UTC

svn commit: r423519 - in /jakarta/commons/proper/scxml/trunk: RELEASE-NOTES.txt xdocs/index.xml

Author: rahul
Date: Wed Jul 19 09:36:07 2006
New Revision: 423519

URL: http://svn.apache.org/viewvc?rev=423519&view=rev
Log:
Based on suggestions by Niall Pemberton <niall DOT pemberton AT gmail DOT com>:
 * Home page had obsolete reference to Sep 05 WD
 * Add a "stability" blurb on the versioning scheme (why we've begun at 0.5) in the release notes as well as on the website

Modified:
    jakarta/commons/proper/scxml/trunk/RELEASE-NOTES.txt
    jakarta/commons/proper/scxml/trunk/xdocs/index.xml

Modified: jakarta/commons/proper/scxml/trunk/RELEASE-NOTES.txt
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/scxml/trunk/RELEASE-NOTES.txt?rev=423519&r1=423518&r2=423519&view=diff
==============================================================================
--- jakarta/commons/proper/scxml/trunk/RELEASE-NOTES.txt (original)
+++ jakarta/commons/proper/scxml/trunk/RELEASE-NOTES.txt Wed Jul 19 09:36:07 2006
@@ -36,6 +36,19 @@
 http://jakarta.apache.org/commons/scxml/
 
 
+API STABILITY:
+
+The initial release version number has been chosen to be 0.5 (rather
+than a 1.0). This is meant to better convey the fact that the underlying
+W3C specification is still a Working Draft, and subsequent changes to
+the Draft may warrant changes to portions of the library API. The core
+Commons SCXML APIs (SCXMLDigester, SCXMLExecutor etc.) are stable.
+Portions such as processing of <datamodel> and <invoke> SCXML elements,
+on the other hand, are subject to change as further changes are expected
+in these sections of the W3C Working Draft. See Working Draft for
+details.
+
+
 NEW FEATURES:
 
 This is the first release.

Modified: jakarta/commons/proper/scxml/trunk/xdocs/index.xml
URL: http://svn.apache.org/viewvc/jakarta/commons/proper/scxml/trunk/xdocs/index.xml?rev=423519&r1=423518&r2=423519&view=diff
==============================================================================
--- jakarta/commons/proper/scxml/trunk/xdocs/index.xml (original)
+++ jakarta/commons/proper/scxml/trunk/xdocs/index.xml Wed Jul 19 09:36:07 2006
@@ -27,9 +27,8 @@
  <section name="Commons SCXML">
 
   <p>
-  The first <a href="http://www.w3.org/TR/scxml/">Working Draft of State 
-  Chart XML (SCXML)</a> was published by the World Wide Web Consortium (W3C)
-  Voice Browser Working Group in July 2005.
+  <a href="http://www.w3.org/TR/scxml/">State Chart XML (SCXML)</a> is currently a
+  Working Draft published by the World Wide Web Consortium (W3C).
   SCXML provides a generic state-machine based execution environment based on Harel
   State Tables. SCXML is a candidate for the control language within 
   multiple markup languages coming out of the W3C (see Working Draft for details).
@@ -47,9 +46,8 @@
   <subsection name="Status">
    <p>
     <ul>
-     <li>The code is unreleased</li>
-     <li>Methods and classes can and will appear and disappear without warning</li>
-     <li>If you like the code and want to push it towards a release, join the mailing list!</li>
+     <li>The code is approaching its first (version 0.5) release</li>
+     <li>If you like the code and want to push it forward, join the mailing list!</li>
     </ul>   
    </p>
   </subsection>
@@ -73,7 +71,15 @@
 
  <section name="Releases">
   <p>
-  Commons SCXML is headed for a (first) 1.0 release soon. See wiki for release plans.
+  Commons SCXML is headed for a first release soon. See wiki for release plans.
+  The initial release version number has been chosen to be 0.5 (rather than a
+  1.0). This is meant to better convey the fact that the underlying W3C
+  specification is still a Working Draft, and subsequent changes to the Draft
+  may warrant changes to portions of the library API. The core Commons SCXML
+  APIs (SCXMLDigester, SCXMLExecutor etc.) are stable. Portions such as
+  processing of &lt;datamodel&gt; and &lt;invoke&gt; SCXML elements, on the
+  other hand, are subject to change as further changes are expected in these
+  sections of the W3C Working Draft. See Working Draft for details.
   </p>
  </section>
 



---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org