Diff for /wikisrc/hackathon.mdwn between versions 1.3 and 1.12

version 1.3, 2011/08/01 10:55:27 version 1.12, 2012/02/02 21:29:36
Line 1 Line 1
 # Hackathon 15  # Hackathon 16
 The 15th NetBSD hackathon will be run from August 10th to August 15th.  The 16th NetBSD hackathon will be run from February 10th to February 12th.
 This time, it's a documentation hackathon ('docathon'), our main  Our goal is fixing all the bugs that needs fixing to get
 focus is improving the NetBSD documentation and advertising.  [[NetBSD-current|http://www.NetBSD.org/docs/current/]] ready for the
   creation of the NetBSD 6.0 release branch.
 Join us on the IRC channel #netbsd-code on freenode (irc.freenode.net).  Join us on the IRC channel #netbsd-code on freenode (irc.freenode.net).
 Just join, have a look around and ask your questions or what work needs to be done.  Just join, have a look around and ask your questions or what work needs to
   be done.
 There's also a thread on netbsd-users, just drop a mail if you're interested.  
 Additionally, this hackathon will be held parallel to the CCC camp (http://camp.ccc.de).  
 Some NetBSD people will be there and expressed interest in a meeting.  
 Mail to the list if you're interested in the meeting, or contact  
 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:  We want NetBSD 6.0 to be the best NetBSD release ever. There are already
   a lot of great features in it:
 1. Update and complete the several guides we have.  * Improved kernel performance and scalibity
 The NetBSD guide could have some updates (e.g. one could write about npf,  * New kernel module framework with automatic module loading
 or write one guide for it on its own).  * Logic Volume Manager
 The internals guide has many XXXs in it, too, and the part about regression  * NetBSD Packet Filter
 testing is factually empty, and perhaps could need one guide on its own.  * Xen SMP support
   * Flash file-system CHFS
 2. The wiki needs some work on it.  * Automated Regression Testing
 The old wiki needs to be migrated completely into the new one.  * Improved FUSE support
   * Updated Linux emulation
 3. NetBSD could need some new advertising material. Anyone good in writing  * GCC 4.5.3
 texts can make new texts for the current flyers, and if you're good with  * Updated X.org X11 distribution
 inkscape and scribus, creating one or two posters for exhibitions would be  * SMTP authentication client built into Postfix (now version 2.8.7)
 nice, too.  * New and enhanced drivers
   * ... and many other features
 4. Minor improvements (working on manpages), thinking about versioning the  
 documentation, address some topics that was not written about before.  To make sure that NetBSD users get the best possible experience of
   the new release we would like to fix as many as possible of the
   following bugs:
 ## Possible topics  
   Critical bugs:
 There were several suggestions on what could be done, so here are topics  
 somebody wanted to be addressed:  * [[PR 45677|http://gnats.NetBSD.org/45677]]: The stress_killer test sometimes does
   * [[PR 45708|http://gnats.NetBSD.org/45708]]: Unable to read big files from large FFSv2 (12TB), ls out of swap
 ### Working on guides  * [[PR 44788|http://gnats.NetBSD.org/44788]]: mlock(2) panic
  * Create a list of notebooks and netbooks running NetBSd, what is missing  * [[PR 45187|http://gnats.NetBSD.org/45187]]: select(2) sometimes doesn't wakeup
    with them and what is running. This page could suit well into the wiki  * [[PR 45833|http://gnats.NetBSD.org/45833]]: occasional crash of 5.99.59: SPL NOT LOWERED ON TRAP EXIT
    where it is editable by more people.  
  * genfs, fifofs, layerfs and specfs actually have no manpages and nearly no  Important bugs:
    documentation. Documenting them would be good for writing new FSs.  
  * Look into internals guide. Every chapter (except for five) has XXXs in it  * [[PR 38670|http://gnats.NetBSD.org/38670]]: ^Z does not seems to suspend programs that vfork'ed and wait.
    or misses fundamental information.  * [[PR 38965|http://gnats.NetBSD.org/38965]]: ktrace locking issue
  * Regression testing needs to be documented. It has a chapter in the  * [[PR 39420|http://gnats.NetBSD.org/39420]]: stopped processes can hold locks
    internals guide, but I want to stress this topic, as it is important for  * [[PR 42663|http://gnats.NetBSD.org/42663]]: lwp_exit() might race with lwp_free()
    people new to developing with NetBSD.  * [[PR 44658|http://gnats.NetBSD.org/44658]]: spurious chroot escape warning
  * The Xen-howto could be updated (http://www.lumbercartel.ca/library/xen/  * [[PR 34735|http://gnats.NetBSD.org/34735]]: diagnostic assertion failed genfs_vnops.c 1123
    might be a good source).  * [[PR 38760|http://gnats.NetBSD.org/38760]]: umount -f /usr panics the system
  * Write an introduction for people coming from Linux and migrating to  * [[PR 39548|http://gnats.NetBSD.org/39548]]: kernel debugging assertion "(vp->v_flag & VONWORKLST)" failed
    NetBSD, the main differences to consider, etc.  * [[PR 30525|http://gnats.NetBSD.org/30525]]: remounting ffs read-only (mount -ur) does not sync metadata
  * Create an npf guide (similarly to the PF user's guide  * [[PR 39264|http://gnats.NetBSD.org/39264]]: newfs can create a filesystem with > 2^31 inodes, which doesn't work (?)
    http://openbsd.org/faq/pf/index.html). This doesn't need to be as lengthy  * [[PR 40562|http://gnats.NetBSD.org/40562]]: busy loop in ffs_sync when unmounting a file system
    as the OpenBSD one, but having one would be nice.  * [[PR 41013|http://gnats.NetBSD.org/41013]]: netbsd5-rc2 crash (kernel diagnostic assertion "vp->v_usecount == 1" failed)
    This can also be addressed in the guide's chapter concerning firewalls.  * [[PR 39371|http://gnats.NetBSD.org/39371]]: wapbl should allow mounting "/" even if journal is hosed
  * The pkgsrc guide could also need updates. Additionally, it would be good  * [[PR 39609|http://gnats.NetBSD.org/39609]]: wapbl "replaying log to disk" message is potentially misleading
    for people new to pkgsrc if the way make works and how dependencies are  * [[PR 32318|http://gnats.NetBSD.org/32318]]: NFS client or server hang
    automatically resolved would be documented in the guide.  * [[PR 39385|http://gnats.NetBSD.org/39385]]: unmounting ptyfs with busy ptys causes deadlock in vrele
    That would make it much easier for people who want to contribute.  * [[PR 40388|http://gnats.NetBSD.org/40388]]: IPv6 incompatibility with pre-5.99.6 binary
  * Write an example on how to migrate NetBSD to a new platform.  * [[PR 38078|http://gnats.NetBSD.org/38078]]: IPFilter lacks documentation almost completely
  * Gather and actualize bluetooth information. The chapter in the guide could  * [[PR 38457|http://gnats.NetBSD.org/38457]]: ipf doesn't handle IPv6 fragments
    be updated.  * [[PR 39066|http://gnats.NetBSD.org/39066]]: Tty settings mangled.
  * Write an article on how to contribute. At the moment, there is  * [[PR 4029|http://gnats.NetBSD.org/4029]]: Register usage doesn't comply with SPARC ABI
    http://www.netbsd.org/contrib/, but having a guide on how NetBSD  * [[PR 44705|http://gnats.NetBSD.org/44705]]: libc violates sparc ABI by using %g7
    development really works, where the code lies and how e.g. the website  * [[PR 38540|http://gnats.NetBSD.org/38540]]: recent i386 GENERIC kernel cannot boot with VIA chipset
    is made (it took me weeks to figure out where the website lies), etc. would  * [[PR 38643|http://gnats.NetBSD.org/38643]]: (dM) st tape drive loses data
    be good.  * [[PR 39305|http://gnats.NetBSD.org/39305]]: loops through gre(4) cause a hang or crash
   * [[PR 42420|http://gnats.NetBSD.org/42420]]: $ORIGIN undefined on NetBSD
 ### wiki  * [[PR 40066|http://gnats.NetBSD.org/40066]]: gcc -O1 generates wrong code in loop optimize
  * [[Migrate articles from the old user wiki to the new one.|wiki/todo/migrate_content_from_wiki.netbsd.se]]  * [[PR 40468|http://gnats.NetBSD.org/40468]]: Optimizer bug suspected -- porting devel/libffi to NetBSD/powerpc
  * Design a new wiki frontpage and think about how to order the wiki. The old  * [[PR 30756|http://gnats.NetBSD.org/30756]]: gdb not usable for live debugging of threaded programs
    user wiki had a pretty nice one.  * [[PR 41936|http://gnats.NetBSD.org/41936]]: gdb does not work for threaded programs on sparc64
  * Create a site for 'general tips' related to NetBSD that don't really fit  * [[PR 41208|http://gnats.NetBSD.org/41208]]: objcopy -S -O binary aborts w/ BFD internal error
    into any other category.  * [[PR 41127|http://gnats.NetBSD.org/41127]]: Update/improve newfs docs regarding raw devices
  * Think of an easier way for new users (non-developers) to contribute to the  * [[PR 45762|http://gnats.NetBSD.org/45762]]: ntpd default config violates pool.ntp.org policy
    wiki. At the moment, the way with getting an OpenID, writing a mail,  * [[PR 40346|http://gnats.NetBSD.org/40346]]: libexpat should be in base.tgz
    waiting for creation and activation is long and difficult.  * [[PR 9582|http://gnats.NetBSD.org/9582]]: sysinst doesn't allow source or pkgsrc installation
    One could e.g. think about having a simple NetBSD OpenID-server (SimpleID  * [[PR 38571|http://gnats.NetBSD.org/38571]]: sysinst runs "postinstall fix"
    is quite nice for that) and a registration form so that you don't have to  * [[PR 12769|http://gnats.NetBSD.org/12769]]: clarify the upgrade notes for when the sets are on /usr
    dig through OpenID first to get an account.  * [[PR 43314|http://gnats.NetBSD.org/43314]]: pc relative relocations are "off by 1*size" on vax
   * [[PR 44159|http://gnats.NetBSD.org/44159]]: startx (xinit) fails
 ### advertising material  * [[PR 45153|http://gnats.NetBSD.org/45153]]: there should be a build.sh target for building live images
  * Work out posters (potentially A0) for exhibitions. Anybody fond with  * [[PR 45155|http://gnats.NetBSD.org/45155]]: there are no usb-stick installer images
    inkscape, scribus and design could do great work on that!  * [[PR 45439|http://gnats.NetBSD.org/45439]]: gcc generates out-of-range branch insn for m68k
  * Work over the advertising materials, the exiting can be seen here:  * [[PR 45573|http://gnats.NetBSD.org/45573]]: internal compiler error when building f2c on sparc64
    http://www.netbsd.org/gallery/advocacy/.  * [[PR 45620|http://gnats.NetBSD.org/45620]]: MAKEDEV failures remains unoticed in miniroot build
    They have nice designs, but are fairly outdated and don't really outline  * [[PR 45628|http://gnats.NetBSD.org/45628]]: acpicpu(4) changes between 5.99.55 and 5.99.56 break amd64
    what NetBSDs benefits are.  * [[PR 45816|http://gnats.NetBSD.org/45816]]: Screen corruption in German sysinst install
  * Design new wallpapers. NetBSD needs nice wallpapers for your desktop. ;)  * [[PR 45854|http://gnats.NetBSD.org/45854]]: vnode clean list corruption?
 ### 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.  
  * Work through the packages in pkgsrc/x11 and xsrc and document  
    correspondences and version numbers there. This is important for working  
    on pkgsrc's Xorg.  
  * 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  
    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  
    contributing them.  

Removed from v.1.3  
changed lines
  Added in v.1.12

CVSweb for NetBSD wikisrc <wikimaster@NetBSD.org> software: FreeBSD-CVSweb