--- wikisrc/hackathon.mdwn 2011/07/26 21:12:36 1.1 +++ wikisrc/hackathon.mdwn 2011/08/09 08:35:39 1.8 @@ -1,6 +1,6 @@ -= Hackathon 15 = +# Hackathon 15 -The 15th NetBSD hackathon will be run from August 10th to August 15th. +The 15th NetBSD hackathon will be run from August 10th through August 14th. This time, it's a documentation hackathon ('docathon'), our main focus is improving the NetBSD documentation and advertising. @@ -15,7 +15,7 @@ Mail to the list if you're interested in via Jabber (prng@jabber.in-berlin.de) or in IRCNet/Freenode (nick: gnrp). -== Primary goals == +## Primary goals We see four main goals one could achieve within five days with enough manpower: @@ -37,12 +37,12 @@ nice, too. documentation, address some topics that was not written about before. -== Possible topics == +## Possible topics There were several suggestions on what could be done, so here are topics somebody wanted to be addressed: -=== Working on guides === +### Working on guides * Create a list of notebooks and netbooks running NetBSd, what is missing with them and what is running. This page could suit well into the wiki where it is editable by more people. @@ -55,6 +55,8 @@ somebody wanted to be addressed: people new to developing with NetBSD. * The Xen-howto could be updated (http://www.lumbercartel.ca/library/xen/ might be a good source). + LumberCartel has permitted the use of his document, + don't forget to give credit and backlink to his pages. * Write an introduction for people coming from Linux and migrating to NetBSD, the main differences to consider, etc. * Create an npf guide (similarly to the PF user's guide @@ -74,10 +76,9 @@ somebody wanted to be addressed: is made (it took me weeks to figure out where the website lies), etc. would be good. -=== wiki === - * Migrate articles from the old user wiki (http://wiki-static.aydogan.net/) - to the new one. Some progress was documented in - http://wiki.netbsd.org/users/asau/. +### wiki + * [[Migrate articles from the old user wiki to the new one.|wiki/todo/migrate_content_from_wiki.netbsd.se]] + * [[Describe your laptop.|laptops]] * Design a new wiki frontpage and think about how to order the wiki. The old user wiki had a pretty nice one. * Create a site for 'general tips' related to NetBSD that don't really fit @@ -89,7 +90,7 @@ somebody wanted to be addressed: is quite nice for that) and a registration form so that you don't have to dig through OpenID first to get an account. -=== advertising material === +### advertising material * Work out posters (potentially A0) for exhibitions. Anybody fond with inkscape, scribus and design could do great work on that! * Work over the advertising materials, the exiting can be seen here: @@ -97,8 +98,11 @@ somebody wanted to be addressed: They have nice designs, but are fairly outdated and don't really outline what NetBSDs benefits are. * Design new wallpapers. NetBSD needs nice wallpapers for your desktop. ;) + * Write convincing arguments to counter this: http://slonik-v-domene.livejournal.com/98273.html (in Russian, + ask some Russian to translate it or do it yourself). + Check criticism, identify drawbacks, suggest improvements. -=== miscellanous documentation === +### miscellanous documentation * pcap(3) could need cross-links (e.g. pcap_next and pcap_next_ex). * Work over vfs(9) and vnode(9) (some functions missing), and insert them into the internals guide. @@ -108,7 +112,7 @@ somebody wanted to be addressed: * Update the pages for possible projects and bounties, and think of some infrastructure on how to make it easily appendable. Currently, there are three pages for that issue: http://wiki.netbsd.org/projects/, - http://wiki-static.aydogan.net/Bounties and + http://wiki-static.aydogan.net/Bounties ([[check this|wiki/todo/migrate_content_from_wiki.netbsd.se]]) and http://www.netbsd.org/contrib/projects.html. I think, merging them all into one with a good table for all would be possible, also coming up with new and gathering existing ideas and