Author: rdonkin
Date: Sat Feb 18 06:15:35 2006
New Revision: 378723
URL: http://svn.apache.org/viewcvs?rev=378723&view=rev
Log:
Added instructions about how to add new news (using the new process). The
content is based on the public instructions by Howard Lewis Ship to the general
list
http://mail-archives.apache.org/mod_mbox/jakarta-general/200510.mbox/[EMAIL
PROTECTED]
Added:
jakarta/site/xdocs/site/news/README.txt
Modified:
jakarta/site/docs/site/news/index.html
jakarta/site/xdocs/site/news/index.xml
Modified: jakarta/site/docs/site/news/index.html
URL:
http://svn.apache.org/viewcvs/jakarta/site/docs/site/news/index.html?rev=378723&r1=378722&r2=378723&view=diff
==============================================================================
--- jakarta/site/docs/site/news/index.html (original)
+++ jakarta/site/docs/site/news/index.html Sat Feb 18 06:15:35 2006
@@ -157,6 +157,64 @@
<td class="main-body" valign="top" align="left">
<div class="section">
<div class="section-header">
+<a name="Contents">
+<strong>Contents</strong>
+</a>
+</div>
+<p>
+<div class="section-body">
+ <ul>
+ <li>
+<a href="#News">News</a>
+ <ul>
+ <li>
+<a href="#Browse">Browse</a>
+</li>
+ <li>
+<a href="#How%20To%20Add%20News%20(Committers)">How To Add News
(Committers)</a>
+</li>
+ </ul>
+ </li>
+ <li>
+<a href="#Jakarta%20Newsletter">Jakarta Newsletter</a>
+ <ul>
+ <li>
+<a href="#Newsletter%20Archive">Newsletter Archive</a>
+</li>
+ </ul>
+ </li>
+ <li>
+<a href="#Headlines">Headlines</a>
+ <ul>
+ <li>
+<a href="#Use%20RSS%20For%20News">Use RSS For News</a>
+</li>
+ <li>
+<a href="#2005">2005</a>
+</li>
+ <li>
+<a href="#2004">2004</a>
+</li>
+ <li>
+<a href="#2003">2003</a>
+</li>
+ <li>
+<a href="#2002">2002</a>
+</li>
+ <li>
+<a href="#2001">2001</a>
+</li>
+ <li>
+<a href="#2000">2000</a>
+</li>
+ </ul>
+ </li>
+ </ul>
+ </div>
+</p>
+</div>
+<div class="section">
+<div class="section-header">
<a name="News">
<strong>News</strong>
</a>
@@ -172,8 +230,14 @@
<div class="subsection-body">
<ul>
<li>
+ 2006 news from Jakarta (<a
href="news-2006-q1.html">January - March</a>
+
+
+ )
+ </li>
+ <li>
2005 news from Jakarta (<a
href="news-2005-q1.html">January - March</a>,
- <a href="news-2005-q2.html">April - June</a>, <a
href="news-2005-q3.html">July - September</a>)
+ <a href="news-2005-q2.html">April - June</a>, <a
href="news-2005-q3.html">July - September</a>,<a
href="news-2005-q4.html">October - December</a>)
</li>
<li>
2004 news from Jakarta (
@@ -196,6 +260,50 @@
</ul>
</div>
</div>
+ <div class="subsection">
+<div class="subsection-header">
+<a name="How To Add News (Committers)">
+<strong>How To Add News (Committers)</strong>
+</a>
+</div>
+<div class="subsection-body">
+ <p>
+The various news documents are now generated from a single source:
<code>site/news.xml</code>.
+This file contains all new news.
+ </p>
+<p>
+The build process uses this file to generate an RSS feed, and to
+generate XML content files in the site/news folder (which are then
+converted to HTML). The <a href="http://jakarta.apache.org/index.html";>master
index</a>
+is generated from this file as well (it is limited to the most recent 20
entries).
+ </p>
+<p>
+The format should be easy to grasp. A root <news> element contains
+<group> elements. Each <group> has an @id and a @title and will be
+used to generate a single news file in the site/news folder.
+Currently, a "group" is a calendar quarter, but this can change in the
+future if things really heat up (i.e., monthly news pages rather than
+quarterly).
+ </p>
+<p>
+<group> contains <release> and <news>. Both of these
contain an @id
+attribute (consisting of "YYYYMMDD.x", i.e., a date stamp and index
+within a day), and a @date attribute (a formatted date, such as "17
+October 2005").
+ </p>
+<p>
+<release> contains @product which is the product that was released
+(i.e., "Tapestry 4.0-beta-11").
+<news> contains @title which is simply the title of the news entry
+(i.e., "Right Commons-Cli 1.0 Jar Now In Java Repository").
+<release> and <news> contains a body of markup, the details about
that
+product release or general news entry.
+ </p>
+<p>
+The site.xml navigation contains link to the RSS feed.
+ </p>
+ </div>
+</div>
</div>
</p>
</div>
@@ -268,6 +376,19 @@
</div>
<p>
<div class="section-body">
+ <div class="subsection">
+<div class="subsection-header">
+<a name="Use RSS For News">
+<strong>Use RSS For News</strong>
+</a>
+</div>
+<div class="subsection-body">
+ <p>
+Jakarta now has an <a href="http://jakarta.apache.org/site/rss.xml";>RSS
feed</a>.
+That is now the recommended way to track Jakarta news.
+ </p>
+ </div>
+</div>
<div class="subsection">
<div class="subsection-header">
<a name="2005">
Added: jakarta/site/xdocs/site/news/README.txt
URL:
http://svn.apache.org/viewcvs/jakarta/site/xdocs/site/news/README.txt?rev=378723&view=auto
==============================================================================
--- jakarta/site/xdocs/site/news/README.txt (added)
+++ jakarta/site/xdocs/site/news/README.txt Sat Feb 18 06:15:35 2006
@@ -0,0 +1,4 @@
+Do add news to these documents. New news content is now generated from a
central document.
+
+Please see
http://jakarta.apache.org/site/news/index.html#How%20To%20Add%20News%20(Committers)
+for more details.
Modified: jakarta/site/xdocs/site/news/index.xml
URL:
http://svn.apache.org/viewcvs/jakarta/site/xdocs/site/news/index.xml?rev=378723&r1=378722&r2=378723&view=diff
==============================================================================
--- jakarta/site/xdocs/site/news/index.xml (original)
+++ jakarta/site/xdocs/site/news/index.xml Sat Feb 18 06:15:35 2006
@@ -19,12 +19,44 @@
<title>News & Status</title>
</properties>
<body>
+ <section name="Contents">
+ <ul>
+ <li><a href='#News'>News</a>
+ <ul>
+ <li><a href='#Browse'>Browse</a></li>
+ <li><a href='#How%20To%20Add%20News%20(Committers)'>How To
Add News (Committers)</a></li>
+ </ul>
+ </li>
+ <li><a href='#Jakarta%20Newsletter'>Jakarta Newsletter</a>
+ <ul>
+ <li><a href='#Newsletter%20Archive'>Newsletter
Archive</a></li>
+ </ul>
+ </li>
+ <li><a href='#Headlines'>Headlines</a>
+ <ul>
+ <li><a href='#Use%20RSS%20For%20News'>Use RSS For
News</a></li>
+ <li><a href='#2005'>2005</a></li>
+ <li><a href='#2004'>2004</a></li>
+ <li><a href='#2003'>2003</a></li>
+ <li><a href='#2002'>2002</a></li>
+ <li><a href='#2001'>2001</a></li>
+ <li><a href='#2000'>2000</a></li>
+ </ul>
+ </li>
+ </ul>
+ </section>
<section name="News">
<subsection name='Browse'>
<ul>
<li>
+ 2006 news from Jakarta (<a
href="news-2006-q1.html">January - March</a>
+ <!--,<a href="news-2006-q2.html">April - June</a>-->
+ <!--,<a href="news-2006-q3.html">July -
September</a>-->
+ <!--,<a href="news-2006-q4.html">October -
December</a>-->)
+ </li>
+ <li>
2005 news from Jakarta (<a
href="news-2005-q1.html">January - March</a>,
- <a href="news-2005-q2.html">April - June</a>, <a
href="news-2005-q3.html">July - September</a>)
+ <a href="news-2005-q2.html">April - June</a>, <a
href="news-2005-q3.html">July - September</a>,<a
href="news-2005-q4.html">October - December</a>)
</li>
<li>
2004 news from Jakarta (
@@ -41,6 +73,38 @@
<li><a href="news-2000.html">News from 2000</a></li>
</ul>
</subsection>
+ <subsection name='How To Add News (Committers)'>
+ <p>
+The various news documents are now generated from a single source:
<code>site/news.xml</code>.
+This file contains all new news.
+ </p><p>
+The build process uses this file to generate an RSS feed, and to
+generate XML content files in the site/news folder (which are then
+converted to HTML). The <a href='http://jakarta.apache.org/index.html'>master
index</a>
+is generated from this file as well (it is limited to the most recent 20
entries).
+ </p><p>
+The format should be easy to grasp. A root <news> element contains
+<group> elements. Each <group> has an @id and a @title and will be
+used to generate a single news file in the site/news folder.
+Currently, a "group" is a calendar quarter, but this can change in the
+future if things really heat up (i.e., monthly news pages rather than
+quarterly).
+ </p><p>
+<group> contains <release> and <news>. Both of these
contain an @id
+attribute (consisting of "YYYYMMDD.x", i.e., a date stamp and index
+within a day), and a @date attribute (a formatted date, such as "17
+October 2005").
+ </p><p>
+<release> contains @product which is the product that was released
+(i.e., "Tapestry 4.0-beta-11").
+<news> contains @title which is simply the title of the news entry
+(i.e., "Right Commons-Cli 1.0 Jar Now In Java Repository").
+<release> and <news> contains a body of markup, the details about
that
+product release or general news entry.
+ </p><p>
+The site.xml navigation contains link to the RSS feed.
+ </p>
+ </subsection>
</section>
<section name="Jakarta Newsletter">
<p>
@@ -70,6 +134,12 @@
</subsection>
</section>
<section name='Headlines'>
+ <subsection name='Use RSS For News'>
+ <p>
+Jakarta now has an <a href='http://jakarta.apache.org/site/rss.xml'>RSS
feed</a>.
+That is now the recommended way to track Jakarta news.
+ </p>
+ </subsection>
<subsection name='2005'>
<p>For 2005 news please see <a href="news-2005-q1.html">January
- March 2005</a>,
<a href="news-2005-q2.html">April - June 2005</a>,
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
