blob: 7b088d0a387baf761e62e42148b5089263ac6d81 [file] [log] [blame]
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="../default_style.css" type="text/css">
<title>Contributing Eclipse Articles</title>
</head>
<body>
&nbsp;
<table BORDER=0 CELLSPACING=5 CELLPADDING=2 WIDTH="100%" >
<tr>
<td ALIGN=LEFT width="54%">
<p><font class=indextop> contributing articles<br>
</font></p>
</td>
<td width="46%"><img SRC="../images/howto_banner.jpg" height=111 width=272 align=CENTER></td>
</tr>
</table>
<table border=0 cellspacing=5 cellpadding=2 width="100%" >
<tr>
<td align=LEFT valign=TOP colspan="2" bgcolor="#0080C0"><b><font color="#FFFFFF" face="Arial,Helvetica">Eclipse
Corner Articles</font></b></td>
</tr>
<tr>
<td>
<p>Articles appearing on Eclipse Corner have been written by members of
the development team and other members of the eclipse community. You too
can contribute! Eclipse Corner depends on contributions from people like
you.
</p>
</td>
</tr>
</table>
<table BORDER=0 CELLSPACING=5 CELLPADDING=2 WIDTH="100%" >
<!-- Add the Articles -->
<!-- Add the Articles -->
<tr>
<td ALIGN=LEFT VALIGN=TOP COLSPAN="2" BGCOLOR="#0080C0"><b><font face="Arial,Helvetica" color="#FFFFFF">How
to write an article<a name="WritingArticle"></a></font></b></td>
</tr>
<!-- Add the Articles -->
<tr>
<td ALIGN=RIGHT VALIGN=TOP><img SRC="images/Adarrow.gif" BORDER=0 height=16 width=16></td>
<td align="left" valign="top">
<p>So you have an idea for an article. Excellent! To make your article writing
experience a smooth one here is a little advice:</p>
<p><b>Before writing the article</b> </p>
<ul>
<li>Before you start churning out the content, take a few minutes to
search Bugzilla to make sure the subject is not already being covered.
All requested, proposed, and in-progress articles are listed in the
Community project, Articles component.
This is also a good way to find out what articles people want if you're
trying to decide what to write.
If someone else is working on a similar article, consider joining them
as a co-author, or adjusting the focus of your article so they don't overlap.</li>
<li>Next, write down a short outline of your article and the main topics
you intend to cover.
Open a new bugzilla entry for the article if there's not one already and
put your outline in the comments there.
Indicate a rough idea of when you expect the article to be completed.</li>
<li>Once your outline is entered in the system, interested parties will
provide you with additional ideas and feedback.</li>
</ul>
<b>Writing the article</b>
<p>Assuming the feedback on your outline is positive, then it's time to write the
content.</p>
<ul>
<li>To get you started you can extract the following <a href="article-template.zip"><b>document
template</b></a> . Be sure to read the <b>readme.txt</b> in its root
directory.</li>
<li>Try and keep it fun and lively, after all, you probably wouldn't want
to read a boring article. </li>
<li>Keep your article practical and if you have code snippets <b>always</b>
have your article link to a zip file containing a plug-in with the code.</li>
<li>The last tip is to aim for maximal content with minimum words. Forty
page articles could better be published as paper back novels.</li>
</ul>
<p><b>After finishing the article</b></p>
<ul>
<li>When you have finished your draft article, zip it up and
attach the zip to the bugzilla entry.
</li>
<li>The Articles Editor and one or more reviewers
will work with you (via bugzilla comments and/or email) to finalize the article.
As you come up with new revisions, attach them to the bugzilla entry.</li>
<li>Don't be discouraged if you get lots of feedback.
Most articles require at least two drafts before they are finalized.
Remember, the reviewers are trying to help you make the article the best
thing since the invention of those tiny umbrellas they put in drinks.</li>
</ul>
<p><b>Posting the article</b></p>
<ul>
<li>After all the kinks are worked out and the final draft is in bugzilla,
the article will be posted on the site and the bugzilla entry marked as closed.
Stand back and watch as the masses come running to read it.<br>
</li>
</ul>
<p>Please direct any question on submitting an article to <a href="mailto:articles_editor@eclipse.org">(Editor)</a>.</p>
</td>
</tr>
<tr>
<td align=LEFT valign=TOP colspan="2" bgcolor="#0080C0"><b><font face="Arial,Helvetica" color="#FFFFFF">Legal</font></b></td>
</tr>
<tr>
<td align=RIGHT valign=TOP><img src="images/Adarrow.gif" border=0 height=16 width=16></td>
<td align="left" valign="top">
<p>Articles submitted to Eclipse Corner are accepted for posting under the
&quot;<a href="http://www.eclipse.org/legal/termsofuse.html">Terms of
Use</a>&quot; .</p>
</td>
</tr>
<!-- Add the Articles -->
<!-- Add the Articles -->
<!-- Add the Articles -->
<!-- Add the Articles -->
<!-- Add the Articles -->
<!-- Add the Articles -->
<!-- Add the Articles -->
<!-- Add the Articles -->
<!-- Add the Articles -->
</table>
</body>
</html>