<?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="community-hackathon">
  <config param="desc" value="The NetBSD Hackathon: Ready to Branch?"/>
  <config param="cvstag" 
    value="$NetBSD: hackathon.xml,v 1.11 2008/05/22 20:34:13 heinz Exp $"/>
  <config param="rcsdate" value="$Date: 2008/05/22 20:34:13 $"/>
  <head>
    <title>The NetBSD Hackathon</title>
  </head>

  <para>
	[<ulink url="../Gnats/">PR database</ulink>]
	[<ulink url="../support/query-pr.html">Search PR</ulink>]
	[<ulink url="http://cvsweb.NetBSD.org/">CVS online</ulink>]
	[<ulink url="http://rafb.net/paste/">Paste online</ulink>]
	[<ulink url="http://wiki.netbsd.se/index.php/Hackathon">Wiki</ulink>]
	[<ulink url="http://nxr.NetBSD.org/source/xref/">Nxr</ulink>]
  </para>

  <sect1 id="what">
    <title>The what?</title>

    <para>The NetBSD Hackathon is an open event held by NetBSD for users,
      developers, and the occasional bystanders to cooperate in improving
      NetBSD. The focus changes for each hackathon, ranging from
      bugfixing over release preparation to pkgsrc and documentation.
    </para>

    <para>
      The focus and exact details are part of the hackathon's announcement. 
    </para>

  </sect1>

  <sect1 id="where">
    <title>Where?</title>

    <para>Get on IRC, <emphasis role="bold">irc.freenode.net</emphasis>
      and join <emphasis role="bold">#NetBSD-code</emphasis>.</para>

    <para>Take a few moments to have a look around, plenty of people will
      be there to help you with any query you may have.</para>
  </sect1>

  <sect1 id="when">
    <title>When?</title>

   <para>
       The next hackathon will be held May 24th and 25th, 2008.  The
       focus will be on tackling critical and high priority bugs in
       preparation for the NetBSD 5.0 release. Participation
       is open to everyone.
   </para>
   <para>
       The wiki page for this hackathon is <ulink
       url="http://wiki.netbsd.se/Hackathon11" />.
   </para>

    <formalpara>
      <title>Past events:</title>
    <para>
    <itemizedlist>
      <listitem><emphasis role="strikethrough"><ulink url="http://wiki.netbsd.se/Hackathon9">Jan 19-20, 2008</ulink></emphasis>
      (closing PRs that are not relevant after NetBSD 4.0)</listitem>

      <listitem><emphasis role="strikethrough"><ulink url="http://wiki.netbsd.se/Hackathon8">Nov 3-4, 2007</ulink></emphasis>
      (pkgsrc and its options framework)</listitem>

      <listitem><emphasis role="strikethrough"><ulink url="http://wiki.netbsd.se/Hackathon7">May 21-23, 2007</ulink></emphasis>
  (preparing the upcoming NetBSD  4.0 release, sysinst and documentation improvements)</listitem>

      <listitem><emphasis role="strikethrough"><ulink url="http://wiki.netbsd.se/Hackathon6">May 2, 2007</ulink></emphasis>
	(OEA PowerPC cleanup)</listitem>

      <listitem><emphasis role="strikethrough"><ulink url="http://wiki.netbsd.se/Hackathon5">April 6-8, 2007</ulink></emphasis>
	(the documentation Hackathon: Docathon!)</listitem>

      <listitem><emphasis role="strikethrough"><ulink url="http://wiki.netbsd.se/Hackathon4">December 27-29, 2006</ulink></emphasis>
	(the first pkgsrc Hackathon!)</listitem>

      <listitem><emphasis role="strikethrough"><ulink url="http://wiki.netbsd.se/Hackathon3">November 25-26, 2006</ulink></emphasis>
	(around 200 PRs analyzed and/or closed; install documentation fixed)</listitem>

      <listitem><emphasis role="strikethrough">October 7-8, 2006</emphasis>
	(over 310 PRs closed)</listitem>

      <listitem><emphasis role="strikethrough">September 23-24, 2006</emphasis>
        (over 270 PRs closed)</listitem>

    </itemizedlist>
    </para>
  </formalpara>
  </sect1>

  <sect1 id="how">
    <title>How?</title>

<!--
    <para>You can find snapshots of -current on <ulink url="ftp://ftp.NetBSD.org/pub/NetBSD-daily/HEAD/">
    the NetBSD ftp server</ulink>. The install documentation is found straight under
    the arch subdirectory, in the INSTALL.html file.</para>
-->

    <para>You can <ulink url="../Gnats/">
      <emphasis role="bold">view the PR database summaries</emphasis></ulink>
      and look for PRs you can handle.</para>
    <para>There are many of them divided to many categories; most are
      <emphasis role="bold">bin</emphasis>,
      <emphasis role="bold">install</emphasis>,
      <emphasis role="bold">kern</emphasis>,
      <emphasis role="bold">lib</emphasis>, or
      <emphasis role="bold">misc</emphasis> bugs.</para>

    <para>Got your mind on a specific PR? know what you're looking for?
      try the <ulink url="../support/query-pr.html"><emphasis role="bold">PR 
      query form</emphasis></ulink> for some interesting search capabilities
      (hint: <ulink url="http://www.regular-expressions.info/reference.html">regex</ulink>! :).</para>

    <para>Here are some ideas on how to find PRs you can handle:</para>
    <itemizedlist>
      <listitem>PRs that have <emphasis role="bold">already been fixed but
	not closed</emphasis>, where you
	can see the CVS commit in the PR body.</listitem>
      <listitem>PRs that <emphasis role="bold">no longer apply</emphasis>: there's a
	good chance that many of
	the PRs filed against NetBSD 2 and lower no longer apply... but
	it's still worth checking. Ask!</listitem>
      <listitem>PRs <emphasis role="bold">with a fix in the report</emphasis>: these are easier to
	handle.</listitem>
      <listitem>PRs for which you can <emphasis role="bold">come up with a fix yourself!</emphasis></listitem>
    </itemizedlist>

    <para>Got a fix? want to close a PR? need some advice? or maybe just find
      out if anyone can test if it still applies? just ask in the channel
      and we'll close it for you or help in whatever way we can.</para>
  </sect1>

  <sect1 id="else">
    <title>What else?</title>

    <para>You may find use of an online
      <ulink url="http://rafb.net/paste/"><emphasis role="bold">paste-bin</emphasis></ulink> to share
      patches and such with other people.</para>

    <para>The online <ulink url="http://cvsweb.NetBSD.org/"><emphasis role="bold">NetBSD
	CVS repository</emphasis></ulink>
      can also be useful for quick code references.</para>

    <para>The <ulink
        url="http://wiki.netbsd.se/index.php/Hackathon"><emphasis role="bold">NetBSD
        Wiki</emphasis></ulink> can be used for maintaining lists of what needs
        doing and what is done.</para>

    <para>The <ulink url="http://nxr.NetBSD.org/source/xref/"><emphasis role="bold">
	NetBSD Cross Reference</emphasis></ulink>, Nxr, can be used to quickly browse
	the source code online.</para>
  </sect1>
</webpage>
