| <?xml version="1.0" encoding="iso-8859-1"?> |
| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" |
| "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> |
| <html xmlns="http://www.w3.org/1999/xhtml"> |
| <head> |
| <meta http-equiv="Content-Language" content="en-us" /> |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> |
| <title>Eclipse "New and Noteworthy" Template</title> |
| </head> |
| <body> |
| <h1>Eclipse "New and Noteworthy" Template</h1> |
| <p>Last revised August 9, 2006</p> |
| <p>This is the template for the "New and Noteworthy" document that accompanies |
| each Eclipse project milestone build.</p> |
| <table border="0" width="80%" cellpadding="10" cellspacing="0"> |
| <tr> |
| <td colspan="2"> <hr /> |
| <h2>Eclipse component</h2> |
| <hr /></td> |
| </tr> |
| <tr> |
| <td width="30%" valign="top" align="left"><b>Item title, in bold, with no trailing punctuation</b></td> |
| <td width="70%" valign="top">A blurb pitched to the Eclipse community (not |
| just to members of the Eclipse Platform development team). Tell end users |
| about changes they'll see at the UI. Tell component writers about changes |
| they'll see at the client- and server-side APIs. Try to generate some |
| excitement; save the boring details for the manual. The description should |
| be complete sentences, with trailing punctuation. Stick to the default |
| font and size. |
| <p>If a small image sheds light, place it below the description, in a separate |
| paragraph. Regular screen snapshots should be done on Windows XP. Crop |
| out any extraneous stuff to focus the reader's attention on your new feature. |
| <span style="background-color: #FFFF00">The image should be no more than |
| 466 pixels wide and in PNG-24 format</span> (as opposed to GIF, TIF, BMP, |
| or JPG).</p> |
| <p>Microsoft Paint actually saves to PNG on Windows XP and can easily be |
| used to crop and save screenshots:</p> |
| <ul> |
| <li>Arrange the windows for the shot</li> |
| <li>Use the Print Screen key (or Alt+Print Screen) to capture the screen</li> |
| <li>Open Paint (under All Programs > Accessories)</li> |
| <li>Ctrl+V to paste</li> |
| <li>Select the area you want to keep</li> |
| <li>Ctrl+C to copy it</li> |
| <li>Ctrl+N to create a new canvas (ok to discard old one)</li> |
| <li>Ctrl+V to paste selected portion</li> |
| <li>Save As PNG</li> |
| </ul> |
| <p>Name the file is a way that is appropriate and specific to the item (e.g., |
| key-bindings.png, rather than something generic like image.png). Use all |
| lowercase letters in the image file name, including the ".png" |
| file extension. As a separator, use hyphen "-" rather than underscore |
| "_". </p> |
| <p>Put all the images in a sibling directory named "images". This |
| gives HTML like <img src="images/foo.png" alt="The Foo |
| View" />. Include a suitable alt property (which is mandatory |
| in strict XHTML 1.0). Do not embed the width and height of the image.</p> |
| <p>The images should be left justified (as opposed to centered). </p></td> |
| </tr> |
| <tr> |
| <td colspan="2"> <hr /> </td> |
| </tr> |
| <tr> |
| <td width="30%" valign="top" align="left"><b>Another item</b></td> |
| <td width="70%" valign="top">Another blurb</td> |
| </tr> |
| <tr> |
| <td colspan="2"> <hr /> </td> |
| </tr> |
| <tr> |
| <td width="30%" valign="top" align="left"><b>Another item</b></td> |
| <td width="70%" valign="top">Another blurb</td> |
| </tr> |
| <tr> |
| <td colspan="2"> <hr /> </td> |
| </tr> |
| </table> |
| </body> |
| </html> |
