[svn-commits] russell: branch russell/project_docs r161717 - /team/russell/project_docs/inc...

[SVN commits to the Digium repositories]

Author: russell
Date: Mon Dec  8 11:17:21 2008
New Revision: 161717

URL: http://svn.digium.com/view/asterisk?view=rev&rev=161717
Log:
start adding release and commit policy info

Modified:
    team/russell/project_docs/include/asterisk/doxyref.h

Modified: team/russell/project_docs/include/asterisk/doxyref.h
URL: http://svn.digium.com/view/asterisk/team/russell/project_docs/include/asterisk/doxyref.h?view=diff&rev=161717&r1=161716&r2=161717
==============================================================================
--- team/russell/project_docs/include/asterisk/doxyref.h (original)
+++ team/russell/project_docs/include/asterisk/doxyref.h Mon Dec  8 11:17:21 2008
@@ -32,6 +32,7 @@
  * \section devpolicy Development and Release Policies
  * \arg \ref CodeGuide : The must-read document for all developers
  * \arg \ref ReleaseStatus : The current support level for various Asterisk releases
+ * \arg \ref ReleasePolicies : Asterisk Release and Commit Policies
  * \arg \ref AstCREDITS : A Thank You to contributors (unfortunately out of date)
  *
  * \section apisandinterfaces Asterisk APIs and Interfaces
@@ -66,7 +67,7 @@
  */
 
 /*!
- * \page ReleaseStatus Asterisk Releases
+ * \page ReleaseStatus Asterisk Release Status
  *
  * @AsteriskTrunkWarning
  *
@@ -119,6 +120,10 @@
  *      fixes, as well as new features and architectural improvements.
  *
  * \section AsteriskReleases Asterisk Maintenance Levels
+ *
+ * For more information on how and when Asterisk releases are made, see the
+ * release policies page:
+ * \arg \ref ReleasePolicies
  *
  * \htmlonly
  * <table border="1">
@@ -162,6 +167,48 @@
  *  </tr>
  * </table>
  * \endhtmlonly
+ */
+
+/*!
+ * \page ReleasePolicies Asterisk Release and Commit Policies
+ *
+ * \section releasestatus Asterisk Release Status
+ *
+ * For more information on the current status of each Asterisk release series,
+ * please see the Asterisk Release Status page:
+ *
+ * \arg \ref ReleaseStatus
+ *
+ * <hr/>
+ *
+ * \section ast10policy Asterisk 1.0
+ *
+ * \subsection ast10releases Release Policy
+ * No more releases of Asterisk 1.0 will be made for any reason.
+ *
+ * \subsection ast10commits Commit Policy
+ * No commits should be made to the Asterisk 1.0 branch.
+ * 
+ * <hr/>
+ *
+ * \section ast12policy Asterisk 1.2
+ *
+ * \subsection ast12releases Release Policy
+ *
+ * There will be no more scheduled releases of Asterisk 1.2.  Releases will be
+ * made as needed to address security issues or regressions introduced by previous
+ * security fixes.
+ *
+ * \subsection ast12commits Commit Policy
+ *
+ * Commits to the Asterisk 1.2 branch should only address security issues or
+ * regressions introduced by previous security fixes.  For a security issue, the
+ * commit should be accompanied by an 
+ * <a href="http://downloads.digium.com/pub/security/">Asterisk Security Advisory</a>
+ * and an immediate release.  When a commit goes in to fix a regression, the previous
+ * security advisory that is related to the change that introduced the bug should get
+ * updated to indicate that there is an updated version of the fix.  A release should
+ * be made immediately for these regression fixes, as well.
  */
 
 /*!