rdonkin 2003/07/02 15:55:46 Added: docs/site/news editor.html Log: Added new how-to-be-newsletter-editor page Revision Changes Path 1.1 jakarta-site2/docs/site/news/editor.html Index: editor.html =================================================================== <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> <!-- Content Stylesheet for Site --> <!-- start the processing --> <!-- ====================================================================== --> <!-- GENERATED FILE, DO NOT EDIT, EDIT THE XML FILE IN xdocs INSTEAD! --> <!-- Main Page Section --> <!-- ====================================================================== --> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> <meta name="author" value="Jakarta Newsletter Team"> <meta name="email" value="[EMAIL PROTECTED]"> <title>The Jakarta Site - Editing The Newsletter</title> </head> <body bgcolor="#ffffff" text="#000000" link="#525D76"> <table border="0" width="100%" cellspacing="0"> <!-- TOP IMAGE --> <tr> <td colspan="2"> <a href="http://jakarta.apache.org";><img src="http://jakarta.apache.org/images/jakarta-logo.gif"; align="left" border="0"/></a> </td> </tr> </table> <table border="0" width="100%" cellspacing="4"> <tr><td colspan="2"> <hr noshade="" size="1"/> </td></tr> <tr> <!-- LEFT SIDE NAVIGATION --> <td width="20%" valign="top" nowrap="true"> <p><strong>About Jakarta</strong></p> <ul> <li> <a href="../../index.html">Welcome</a> </li> <li> <a href="http://www.apache.org/foundation/";>About The ASF</a> </li> <li> <a href="http://jakarta.apache.org/site/news/index.html";>News & Status</a> </li> <li> <a href="http://www.apache.org/";>Apache Website</a> </li> <li> <a href="http://www.google.com/advanced_search?q=+site:jakarta.apache.org&hl=en&as_qdr=all";>Search Jakarta</a> </li> <li> <a href="http://jakarta.apache.org/site/contact.html";>Contacting Us</a> </li> <li> <a href="http://jakarta.apache.org/site/mission.html";>Our Mission</a> </li> <li> <a href="http://jakarta.apache.org/site/whoweare.html";>Who We Are</a> </li> <li> <a href="http://jakarta.apache.org/site/acknowledgements.html";>Acknowledgements</a> </li> <li> <a href="http://jakarta.apache.org/site/legal.html";>Legal</a> </li> </ul> <p><strong>Reference</strong></p> <ul> <li> <a href="http://jakarta.apache.org/site/faqs.html";>Our FAQs</a> </li> <li> <a href="http://jakarta.apache.org/site/getinvolved.html";>Get Involved</a> </li> <li> <a href="http://jakarta.apache.org/site/vendors.html";>Vendor Support</a> </li> <li> <a href="http://jakarta.apache.org/site/guidelines.html";>Project Guidelines</a> </li> <li> <a href="http://jakarta.apache.org/site/library.html";>Reference Library</a> </li> <li> <a href="http://jakarta.apache.org/site/newproject.html";>New Subprojects</a> </li> <li> <a href="http://jakarta.apache.org/site/jakarta-site2.html";>Website Maintenance</a> </li> <li> <a href="http://incubator.apache.org/drafts/glossary.html";>ASF Glossary</a> </li> <li> <a href="http://www.apache.org/dev/";>Developer Resources</a> </li> <li> <a href="http://jakarta.apache.org/site/jspa-position.html";>Apache on the JSPA</a> </li> </ul> <p><strong>Support</strong></p> <ul> <li> <a href="http://jakarta.apache.org/site/mail.html";>Mailing Lists</a> </li> <li> <a href="http://jakarta.apache.org/site/bugs.html";>Bug Database</a> </li> <li> <a href="http://nagoya.apache.org/wiki";>Wiki</a> </li> </ul> <p><strong>Downloads</strong></p> <ul> <li> <a href="http://jakarta.apache.org/site/binindex.cgi";>Binaries</a> </li> <li> <a href="http://jakarta.apache.org/site/sourceindex.cgi";>Source Code</a> </li> <li> <a href="http://jakarta.apache.org/site/cvsindex.html";>CVS Repositories</a> </li> </ul> <p><strong>Products</strong></p> <ul> <li> <a href="../../alexandria/index.html">Alexandria</a> </li> <li> <a href="../../bcel/index.html">BCEL</a> </li> <li> <a href="../../bsf/index.html">BSF</a> </li> <li> <a href="../../cactus/index.html">Cactus</a> </li> <li> <a href="../../commons/index.html">Commons</a> </li> <li> <a href="../../ecs/index.html">ECS</a> </li> <li> <a href="../../gump/index.html">Gump</a> </li> <li> <a href="../../jetspeed/index.html">Jetspeed</a> </li> <li> <a href="../../jmeter/index.html">JMeter</a> </li> <li> <a href="../../log4j/index.html">Log4J</a> </li> <li> <a href="../../lucene/index.html">Lucene</a> </li> <li> <a href="../../oro/index.html">ORO</a> </li> <li> <a href="../../poi/index.html">POI</a> </li> <li> <a href="../../regexp/index.html">Regexp</a> </li> <li> <a href="../../slide/index.html">Slide</a> </li> <li> <a href="../../struts/index.html">Struts</a> </li> <li> <a href="../../taglibs/index.html">Taglibs</a> </li> <li> <a href="../../tapestry/index.html">Tapestry</a> </li> <li> <a href="../../tomcat/index.html">Tomcat</a> </li> <li> <a href="../../turbine/index.html">Turbine</a> </li> <li> <a href="../../velocity/index.html">Velocity</a> </li> <li> <a href="../../watchdog/index.html">Watchdog</a> </li> </ul> <p><strong>Related</strong></p> <ul> <li> <a href="http://ant.apache.org/";>Ant</a> </li> <li> <a href="http://avalon.apache.org/";>Avalon</a> </li> <li> <a href="http://db.apache.org";>DB</a> </li> <li> <a href="http://httpd.apache.org";>HTTPD</a> </li> <li> <a href="http://james.apache.org/";>James</a> </li> <li> <a href="http://maven.apache.org/";>Maven</a> </li> <li> <a href="http://xml.apache.org";>XML</a> </li> </ul> </td> <td width="80%" align="left" valign="top"> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#525D76"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="Introduction"><strong>Introduction</strong></a> </font> </td></tr> <tr><td> <blockquote> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#828DA6"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="About This Document"><strong>About This Document</strong></a> </font> </td></tr> <tr><td> <blockquote> <p> This document is intended to be(come) a self help manual for newsletter editors. Please feel free to add, ammend and update this document. Not only will it be easier for you next time if you keep this updated but also you'll be doing a huge favour to <em>Those Who Will Come After</em>. </p> </blockquote> </td></tr> <tr><td><br/></td></tr> </table> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#828DA6"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="How The Newsletter Is Created"><strong>How The Newsletter Is Created</strong></a> </font> </td></tr> <tr><td> <blockquote> <p> The newsletter is created on the <a href="http://nagoya.apache.org/wiki/apachewiki.cgi?JakartaNewsletterDrafts";>Apache Wiki</a>. This should lower the barrier to enter and allow more people to participate. The next issue of the newsletter is open for business from the time that the last one is closed. The proposed scope of the next newsletter is set when the last newsletter is cut. Traditionally, the last editor will either continue in office or request a new volunteer editor in good time before the deadline for the next issue approaches. </p> </blockquote> </td></tr> <tr><td><br/></td></tr> </table> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#828DA6"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="Preparations"><strong>Preparations</strong></a> </font> </td></tr> <tr><td> <blockquote> <p> Review the older newsletter. Familiarize yourself with their contents and seek inspiration from their ideas. </p> <p> To edit the newsletter you'll need free time around the time that the newsletter is published. You'll also need karma for the jakarta-site2 CVS module. Committers can obtain karma from the Jakarta pmc on request. </p> <p> Make sure you know how to create the xml that the Jakarta site is written in and how to generate the site. Instructions can be found <a href="http://jakarta.apache.org/site/jakarta-site2";>here</a> and <a href="http://jakarta.apache.org/site/jakarta-site2b";>here</a>. </p> </blockquote> </td></tr> <tr><td><br/></td></tr> </table> </blockquote> </p> </td></tr> <tr><td><br/></td></tr> </table> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#525D76"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="Step By Step Guide"><strong>Step By Step Guide</strong></a> </font> </td></tr> <tr><td> <blockquote> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#828DA6"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="Start The Countdown"><strong>Start The Countdown</strong></a> </font> </td></tr> <tr><td> <blockquote> <p> There is nothing to stop entries being added at any time after the last issue has been created. But nothing concentrates the mind like an approaching deadline. So, in order to fill the newsletter, it's necessary to fix a deadline for contributions, annouce the fact (to the various development lists) and then remind people as the deadline approaches. </p> <p>Here's an example of a (good) annoucement: <code><pre> Dear Jakarta BCEL Development Team, (http://jakarta.apache.org/bcel/) We are now preparing the 'Jakarta Newsletter Issue 9', news from May to June 2003, which would be published in the middle of July 2003. The 'Jakarta Newsletter Issue 9' will be appeared at http://jakarta.apache.org/site/news/200305.html and the editorial deadline would be 00:00 GMT, 6th July. We lowered the barrier to entry - users and developers will be able to easily contribute, as prepared the ApacheWiki(http://nagoya.apache.org/wiki/apachewiki.cgi). If you have anything to be added to the ApacheWiki, please go to http://nagoya.apache.org/wiki/apachewiki.cgi?JakartaNewsletterDrafts/Issue9 and fill up what you want to append. If there's nothing news-worthy on 'Jakarta BCEL', then please just write *N/A*. If you have been voted in as a new committer in 'Jakarta BCEL' project within these 2 months, please add your name to the list on ApacheWiki. Probably, the former newsletter draft (Jakarta Newsletter Issue8) would give you some hints in writing the articles. cf. http://nagoya.apache.org/wiki/apachewiki.cgi?JakartaNewsletterDrafts/Issue8March2003 If you have time enough to contribute to http://nagoya.apache.org/wiki/apachewiki.cgi?BCELProjectPages please modify, fill in the ApacheWiki to create more precise and useful pages. We really appreciate your contribution. If you have any questions about this, please subscribe to mailto:[EMAIL PROTECTED] and send your messages to mailto:[EMAIL PROTECTED] Sincerely, -- Tetsuya ([EMAIL PROTECTED]) </pre></code> </p> </blockquote> </td></tr> <tr><td><br/></td></tr> </table> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#828DA6"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="Closing The Last And Opening The New"><strong>Closing The Last And Opening The New</strong></a> </font> </td></tr> <tr><td> <blockquote> <p> The first step in preparing the material is to post an announcement to <code>[EMAIL PROTECTED]</code> telling people that the newsletter is now closed. Edit the wiki so that the status <a href="http://nagoya.apache.org/wiki/apachewiki.cgi?JakartaNewsletterDrafts";>here</a> is <code>CLOSED</code>. It's a good idea to save the source of the draft issue at this stage as well. </p> <p> Next create a new page in the wiki for the next issue named in the usual fashion. Link it from the <a href="http://nagoya.apache.org/wiki/apachewiki.cgi?JakartaNewsletterDrafts";>main drafts page</a> and mark it as <code>OPEN</code>. Fill the new page with the skeleton for the next newsletter. </p> </blockquote> </td></tr> <tr><td><br/></td></tr> </table> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#828DA6"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="Creating An XML Version"><strong>Creating An XML Version</strong></a> </font> </td></tr> <tr><td> <blockquote> <p> This is the time consuming bit. It would be nice to have a script that would convert the wiki output into an Anakia-compatible xml document. Maybe it would be possible to use the <a href="http://www.apache.org/~andyc/neko/doc/index.html";>Neko parser</a>... </p> <p> One way to do this is to manually change all the formatting. Could editors who find better ways to do this plese update this document! </p> </blockquote> </td></tr> <tr><td><br/></td></tr> </table> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#828DA6"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="Editing And The Editorial"><strong>Editing And The Editorial</strong></a> </font> </td></tr> <tr><td> <blockquote> <p> The editorial is the perogative of you, the Editor. The wiki may contain items proposed but distcretion lies entirely with the Editor. Take a look at the past Newsletters and then develop your own style. </p> <p> Please go through everything entered on the wiki. Check for <joke>speiling</joke> mistakes, check links and make sure that everthing makes sense. Edit anything that would benefit from being edited. </p> </blockquote> </td></tr> <tr><td><br/></td></tr> </table> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#828DA6"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="Uploading The Newsletter"><strong>Uploading The Newsletter</strong></a> </font> </td></tr> <tr><td> <blockquote> <p> Newsletters are stored in the CVS in <code>jakarta-site2/site/news</code>. The convention has been to store newsletter by published date. Once the newsletter is ready and the generated html has been proof read, commit it. Also, add the newsletter to the news sections of the site. </p> <p> If you have Daedelus karma then update the website otherwise post a request to <code>[EMAIL PROTECTED]</code>. </p> </blockquote> </td></tr> <tr><td><br/></td></tr> </table> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#828DA6"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="Announcing The Newsletter"><strong>Announcing The Newsletter</strong></a> </font> </td></tr> <tr><td> <blockquote> <p> The newsletter should be announced on the web lists (at least announcements and general at jakarta). A text version of the newsletter should be created and posted to the list. This allows people who do not have access to web to read it straight away. </p> <p>Here is a sample of the format used for newsletter 8: <code><pre> Jakarta Newsletter Issue 8 ========================== Issue: 8 Date: March-April 2003 Url: http://jakarta.apache.org/site/news/200303.html I'm sad to say Rob Oxspring hasn't been able to edit this newsletter so you'll have to make do with me instead. We'll all miss his observations of life here in Jakartaland. Hopefully, Rob will be again back soon. This is the first wiki-built newsletter. See here <http://nagoya.apache.org/wiki/apachewiki.cgi?JakartaNewsletterDrafts> for more details. The next few issues will probably be bi-monthly. I'd like to extend the now-traditional thank-you to those who contributed and hope that you enjoy the read. If you would like to comment further on any of the highlighted discussions then please do so on the appropriate list <http://jakarta.apache.org/site/mail.html>, if you want to comment on the newsletter itself then please point your comments to [EMAIL PROTECTED] <mailto:[EMAIL PROTECTED]>. Robert Burrell Donkin Contents -------- * Alexandria * Cactus * Commons o Commons CLI o Commons Codec o Commons File Upload o Commons Betwixt o Commons Digester o Commons BeanUtils o Commons Math * Log4j * Lucene * POI * Struts * Tapestry * Turbine Alexandria ========== Editor: Nicola Ken Barozzi Donated code has been integrated in CVS, and now Alexandria generates: * javasrc - fully linked and highlighted java source source * javadoc - java docs with standard doclet or in XML * jsdoc - initial implementation of javascript docs * uml - graph of relationship of all classes in png and svg * ant - graphs and docs about the Ant buildfile </pre></code> </p> </blockquote> </td></tr> <tr><td><br/></td></tr> </table> <table border="0" cellspacing="0" cellpadding="2" width="100%"> <tr><td bgcolor="#828DA6"> <font color="#ffffff" face="arial,helvetica,sanserif"> <a name="That's It"><strong>That's It</strong></a> </font> </td></tr> <tr><td> <blockquote> <p> That's all there is to editing the newsletter. Good Luck! </p> </blockquote> </td></tr> <tr><td><br/></td></tr> </table> </blockquote> </p> </td></tr> <tr><td><br/></td></tr> </table> </td> </tr> <!-- FOOTER --> <tr><td colspan="2"> <hr noshade="" size="1"/> </td></tr> <tr><td colspan="2"> <div align="center"><font color="#525D76" size="-1"><em> Copyright © 1999-2003, Apache Software Foundation </em></font></div> </td></tr> </table> </body> </html> <!-- end the processing -->
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
![http://jakarta.apache.org/images/jakarta-logo.gif"](http://jakarta.apache.org/images/jakarta-logo.gif"){kind=link}