Author: veithen
Date: Mon Jul 12 19:43:32 2010
New Revision: 963449
URL: http://svn.apache.org/viewvc?rev=963449&view=rev
Log:
Further document the release process.
Modified:
webservices/commons/trunk/modules/axiom/src/docbkx/devguide.xml
Modified: webservices/commons/trunk/modules/axiom/src/docbkx/devguide.xml
URL:
http://svn.apache.org/viewvc/webservices/commons/trunk/modules/axiom/src/docbkx/devguide.xml?rev=963449&r1=963448&r2=963449&view=diff
==============================================================================
--- webservices/commons/trunk/modules/axiom/src/docbkx/devguide.xml (original)
+++ webservices/commons/trunk/modules/axiom/src/docbkx/devguide.xml Mon Jul 12
19:43:32 2010
@@ -465,6 +465,65 @@ svn update</screen>
and <literal>[email protected]</literal>. Since the two
lists have different conventions, audiences
and moderation policies, to send the announcement separately
to the two lists.
</para>
+ <para>
+ Sample announcement:
+ </para>
+ <blockquote>
+ <para>
+ Apache Axiom Team is pleased to announce the release of
Axiom x.y.z. The release is available
+ for download at:
+ </para>
+ <para>
+ http://ws.apache.org/commons/axiom/download.cgi
+ </para>
+ <para>
+ Apache Axiom is a StAX-based, XML Infoset compliant object
model which supports on-demand building
+ of the object tree. It supports a novel "pull-through"
model which allows one to turn off the tree
+ building and directly access the underlying pull event
stream. It also has built in support for
+ XML Optimized Packaging (XOP) and MTOM, the combination of
which allows XML to carry binary
+ data efficiently and in a transparent manner. The
combination of these is an easy to use API
+ with a very high performant architecture!
+ </para>
+ <para>
+ Developed as part of Apache Axis2, Apache Axiom is the
core of Apache Axis2. However, it is a
+ pure standalone XML Infoset model with novel features and
can be used independently of Apache Axis2.
+ </para>
+ <para>
+ Highlights in this release:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ ...
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ ...
+ </para>
+ </listitem>
+ </itemizedlist>
+ <para>
+ Resolved JIRA issues:
+ </para>
+ <itemizedlist>
+ <listitem>
+ <para>
+ [WSCOMMONS-513] Behavior of insertSiblingAfter and
insertSiblingBefore is not well defined for orphan nodes
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ [WSCOMMONS-488] The sequence of events produced by
OMStAXWrapper with inlineMTOM=false is inconsistent
+ </para>
+ </listitem>
+ </itemizedlist>
+ </blockquote>
+ <para>
+ For <literal>[email protected]</literal>, the subject
(<quote>Axiom x.y.z released</quote>) should be
+ prefixed with <quote>[ANN][Axiom]</quote>, while for
<literal>[email protected]</literal>
+ <quote>[ANN]</quote> is enough.
+ </para>
</section>
<section>
<title>Post-release actions</title>