<?xml version="1.0"?>
<!DOCTYPE webpage
  PUBLIC "-//NetBSD//DTD Website-based NetBSD Extension//EN"
        "http://www.NetBSD.org/XML/htdocs/lang/share/xml/website-netbsd.dtd">

<webpage id="developers-announce">
  <config param="desc" value="News story guidelines"/>
  <config param="cvstag" 
  	value="$NetBSD: announce.xml,v 1.7 2008/03/20 19:14:30 weinem Exp $"/>
  <config param="rcsdate" value="$Date: 2008/03/20 19:14:30 $"/>
  <head>
    <!-- Copyright (c) 1994-2003
    The NetBSD Foundation, Inc.  ALL RIGHTS RESERVED. -->
    <title>NetBSD Developer Documentation: News story guidelines</title>
  </head>

  <sect1 role="toc">
    <sect2 id="prefered-procedure">
      <title>Preferred procedure for doing a news story</title>

      <sect3 id="steps">
	<title>Steps for announcing information</title>

	<para>
	  When you want to announce anything official for the project, do it in
	  the following order:
	</para>

	<orderedlist>
	  <listitem>Make sure what you want to announce is both worth
	    it (else put it e.g. into
	    <filename>doc/CHANGES</filename>), and wanted to be
	    announced. If you're not the one who did the work, ask the
	    person(s) who did.</listitem>
	  <listitem>Add information to the appropriate web page(s),
	    e.g. <filename>htdocs/ports/...</filename></listitem>
	  <listitem>Draft a message that you want to send out to
	    <email>netbsd-announce@NetBSD.org</email> and possibly
	    other news channels (see below). Include information on
	    what you announce, maybe describe any special hardware if
	    it can be assumed most people aren't familiar with it. Add
	    a pointer to our web pages (the one containing the actual
	    information, not <filename>htdocs/changes</filename> or
	    <filename>htdocs/index</filename>).
	    If there's something to download, add a URL (make sure
	    your upload to ftp.NetBSD.org is complete first). If
	    you're announcing a new port, include a dmesg output.</listitem>
	  <listitem>There's a list of people willing to proofread
	    propaganda material, see <ulink
	    url="#volunteer-proofreaders">below</ulink>.</listitem>
	  <listitem>Add info to
	    <filename>htdocs/changes/index.xml</filename> (Short blurb
	    with a pointer to the information from e.g. the Ports
	    section) and run &man.make.1;. This will automatically add
	    the necessary entries to
	    <filename>htdocs/index.html</filename> and at the same time
	    update all of the currently supported translation's index
	    pages. Alternatively, you can run <code>make index</code>
	    from the htdocs root directory.</listitem>
	  <listitem>Commit the above files, and wait until they're on
	    the web server</listitem>.
	  <listitem>Send out your announce mail to
	    <email>netbsd-announce@NetBSD.org</email></listitem>
	  <listitem>Announce things to the following web pages as well:
	<itemizedlist>
<!-- Dead or temporarily not available?
	      <listitem><ulink 
		  url="http://daily.daemonnews.org/add_story.php3">Daily Daemon News</ulink>
              </listitem> 
-->
	      <listitem><ulink 
		  url="http://www.slashdot.org/submit.pl">Slashdot</ulink>
	      </listitem>
	      <listitem><ulink 
		  url="http://www.newsforge.com/submit.pl">NewsForge</ulink>
	      </listitem>
	      <listitem><ulink
		url="http://rootprompt.org/submit.php3">RootPrompt.org</ulink>
	      </listitem>
	      <listitem><ulink
		  url="http://www.osnews.com/submit.php">OSNews</ulink>
	      </listitem>
	    </itemizedlist></listitem>
	</orderedlist>
      </sect3>

      <sect3 id="volunteer-proofreaders">
	<title>Listing of volunteer proofreaders</title>

	<para>The following people have graciously volunteered to
	  proofread submissions, for those wanting to get postings
	  cleaned up, to the
	  <email>netbsd-announce@NetBSD.org</email> mailing
	  list.</para>

	<itemizedlist>
	  <listitem>&a.jlam; <email>jlam@NetBSD.org</email></listitem>
	  <listitem>&a.mouse;
	    <email>mouse@Rodents.Montreal.QC.CA</email>
	  </listitem>
	  <listitem>Toru Nishimura
	    <email>nisimura@itc.aist-nara.ac.jp</email></listitem>
	  <listitem>&a.jtk; <email>jtk@NetBSD.org</email></listitem>
	  <listitem>&a.rpaulo; <email>rpaulo@NetBSD.org</email></listitem>
	  <listitem>&a.reed; <email>reed@NetBSD.org</email></listitem>
	</itemizedlist>
      </sect3>

      <sect3 id="new-developers-announcement">
	<title>Announcements of new developers</title>

	<para>News entries for new developers should be generated once
	  a month around the first for the month before (only if any
	  new developers joined, of course). For this, the script
	  <filename>htutils/scripts/announce-devs.pl</filename> may
	  be used as below:

	  <programlisting>perl htutils/scripts/announce-devs.pl .../localsrc/admin/new-developers/status</programlisting>

	  This script produces output suitable for inclusion in
	  <filename>htdocs/changes/index.xml</filename>.
	</para>
      </sect3>
    </sect2>
  </sect1>

  <parentsec url="./" text="NetBSD Developer Documentation"/>
</webpage>
