Hackathon5
From NetBSD Wiki
This article is about the fifth NetBSD Hackathon, taking place from Friday, 6th of April, until Sunday, 8th of April 2007. The main focus will be on bringing the NetBSD WWW pages and documentation into a consistent and more up-to-date state.
Contents |
Goals
- Primary: Conversion of old .list (and, where appropriate, pure .html) files to DocBook/XML.
- Secondary: Updates and additions of content.
Please note: We're fully aware that a lot can be said about NetBSD's documentation and documentation systems like Docbook, XML, Wikis and whatnot. This discussion is left for some other time and place. The point of this hackathon is to get the existing documentation into a state that can be converted with one converter (Docbook/XML), not three (Docbook/XML, .list, HTML).
Getting Started
Join #netbsd-code on irc.freenode.org. Pick a file from the list below and start converting.
If you're new to htdocs see Hackathon5_-_Howto for instructions how to get started.
Important: be sure to have a look at "Editing htdocs" before starting to work, especially the section dealing with conversion to XML.
The TODO list
If you want to convert one of the files listed below, put your name after the entry. When you're done, add a pointer to an URI referecing where the new file/patch can be found. Also add a note wether the new file is already committed or not.
States:
- "in progress"
- "done" + URL(s) of where to find the new files+patches for Makefile and htdocs/layout.xml (write in square brackets to create links)
- "committed"
The following list is roughly sorted by priority.
List of .list files
The following list is roughly sorted by priority:
- htdocs/developers/PR.list (dsieger: committed)
- htdocs/developers/notes.list (hubertf: committed)
- htdocs/developers/cvs-repos/branch.list (hubertf: committed)
- htdocs/Ports/acorn32/faq.list (dsieger: commited)
- htdocs/Ports/alpha/faq.list (dsieger: committed)
- htdocs/Ports/atari/faq.list (haad_: committed)
- htdocs/Ports/hp300/faq.list (mawei/hubertf: committed)
- htdocs/Ports/hp700/faq.list(haad_: committed)
- htdocs/Ports/hpcmips/faq.list (hubertf: committed)
- htdocs/Ports/alpha/multiafaq.list (haad: committed)
- htdocs/Ports/macppc/x11.list (dsieger: committed)
- htdocs/Ports/macppc/oldfaq.list (dsieger: committed)
- htdocs/Ports/mipsco/faq.list (dsieger: committed)
- htdocs/Ports/mvme68k/faq.list (dsieger:committed)
- htdocs/Ports/mvmeppc/faq.list (dsieger: committed)
- htdocs/Ports/news68k/faq.list (dsieger: committed)
- htdocs/Ports/pc532/faq.list (dsieger: committed)
- htdocs/Ports/pmax/faq.list (hubertf: committed)
- htdocs/Ports/pmppc/faq.list (dsieger: committed)
- htdocs/Ports/sh3/faq.list (dsieger: committed)
- htdocs/Ports/sh5/faq.list (dsieger: committed)
- htdocs/Ports/shark/faq.list (hubertf: committed)
- htdocs/Ports/sun2/faq.list (dsieger: committed)
- htdocs/Ports/sun3/faq.list (haad: committed)
- htdocs/Ports/hpcmips/compat-pmax.list (hubertf: committed)
- htdocs/Ports/acorn26/todo.list (daniel: committed)
- htdocs/Ports/acorn26/unsupported.list (daniel: committed)
- htdocs/Ports/alpha/models.list (haad: committed)
- htdocs/Ports/hpcmips/howto-develop.list (hubertf: committed)
- htdocs/Ports/hpcmips/howto-use.list (hubertf: committed)
- htdocs/Ports/hpcmips/mgl2.list (hubertf: committed)
- htdocs/Ports/hpcmips/pocketv6.list (hubertf: committed)
- htdocs/Ports/mac68k/info/index.html (dsieger: committed)
- htdocs/Ports/mac68k/info/info-3.list (dsieger: committed)
- htdocs/Ports/mac68k/info/info-4.list (dsieger: committed)
- htdocs/Ports/mac68k/info/info-5.list (dsieger: committed)
- htdocs/Ports/mac68k/info/info-6.list (dsieger: committed)
- htdocs/Ports/mac68k/info/info-7.list (dsieger: committed)
- htdocs/Ports/mac68k/info/info-8.list (dsieger: committed)
- htdocs/Ports/mac68k/info/info-9.list (dsieger: committed)
- htdocs/Ports/mac68k/info/info-10.list (dsieger: committed)
- htdocs/Ports/mac68k/info/info-11.list (dsieger: committed)
- htdocs/Ports/mac68k/meta-faq/meta-faq-1.list (sjamaan: committed)
- htdocs/Ports/mac68k/meta-faq/meta-faq-2.list (sjamaan: committed)
- htdocs/Ports/mac68k/meta-faq/meta-faq-3.list (sjamaan: committed)
- htdocs/Ports/mac68k/meta-faq/meta-faq-4.list (sjamaan: committed)
- htdocs/Ports/mac68k/meta-faq/meta-faq-5.list (sjamaan: committed)
- htdocs/Ports/mac68k/meta-faq/meta-faq-6.list (sjamaan: committed)
- htdocs/Ports/mac68k/meta-faq/meta-faq-7.list (sjamaan: committed)
- htdocs/Ports/mac68k/meta-faq/meta-faq-8.list (sjamaan: committed)
- htdocs/Ports/mipsco/models.list (hubertf: committed)
- htdocs/Documentation/power-mgmt/index.list (dsieger: committed)
- htdocs/Documentation/network/nsps/additional.list (dsieger: committed)
- htdocs/Documentation/network/nsps/config_ipf.list (dsieger: committed)
- htdocs/Documentation/network/nsps/config_ipnat.list (dsieger: committed)
- htdocs/Documentation/network/nsps/config_ssh.list (dsieger: committed)
- htdocs/Documentation/network/nsps/examples.list (dsieger: committed)
- htdocs/Documentation/network/nsps/index.list (dsieger: committed)
- htdocs/Documentation/network/nsps/links.list (dsieger: committed)
- htdocs/Documentation/network/nsps/overview.list (dsieger: committed)
- htdocs/Documentation/network/nsps/services.list (dsieger: committed)
- htdocs/Documentation/network/pppoe/index.list (hubertf: committed)
- htdocs/Documentation/software/pkg-growth-jpg.list (wiz: committed)
- htdocs/Documentation/software/pkg-growth.list (wiz: committed)
- htdocs/Documentation/Hardware/Machines/DEC/vax/bootrom.list (dsieger: committed)
- htdocs/Documentation/Hardware/Machines/DEC/vax/tk50.list (dsieger: committed)
- htdocs/Documentation/Hardware/Misc/serial.list (dsieger: committed)
List of ports pages
The following ports pages are only available in HTML, converting to XML with the <portspage> framework is desirable. Templates for ports index and FAQ pages are available[1]:
- htdocs/Ports/hp700/index.html (hubertf: committed)
- htdocs/Ports/hpcmips/index.html (hubertf: committed)
- htdocs/Ports/mipsco/index.html (haad: committed)
- htdocs/Ports/mvmeppc/index.html (haad: committed)
- htdocs/Ports/netwinder/index.html (haad: committed)
- htdocs/Ports/ofppc/index.html (haad: committed)
- htdocs/Ports/openblocks/index.html (hubertf: committed/removed, the port is part of evbppc now)
- htdocs/Ports/pc532/index.html (hubertf: stalled - how to set &release.latest;?[2])
- htdocs/Ports/pmax/index.html (hubertf: committed)
- htdocs/Ports/sandpoint/index.html (hubertf: committed)
- htdocs/Ports/sbmips/index.html (hubertf: committed)
- htdocs/Ports/sh5/index.html (scw: committed/removed)
- htdocs/Ports/sun2/index.html (hubertf: committed)
- htdocs/Ports/pmppc/index.html (hubertf: committed)
- htdocs/Ports/evbsh5/index.html (scw: committed/removed)
- htdocs/Ports/playstation2/index.html (hubertf: committed)
- htdocs/Ports/pdp10/index.html (dsieger: committed)
- htdocs/Ports/mipsco (hubertf: committed)
- htdocs/Ports/mvmeppc (hubertf: committed)
- htdocs/Ports/netwinder (hubertf: committed)
- htdocs/Ports/ofppc (hubertf: committed)
List of .html files
Plain HTML files that should eventually go into one of the guides (NetBSD, pkgsrc, internals) in some form. As such, converting to XML would be good.
- htdocs/Documentation/kernel/converting-ethernet-drivers.html '(hubertf: committed)
- htdocs/Documentation/kernel/elf-notes.html (sjamaan: committed)
- htdocs/Documentation/kernel/porting-freebsd-net.html (hubertf: committed)
- htdocs/Documentation/kernel/vfork.html (dsieger: committed)
- htdocs/developers/cvs-repos/cvs_intro.html (sjamaan: commited)
- htdocs/developers/cvs-repos/modules.html (sjamaan: committed)
- htdocs/Documentation/bsd/index.html (hubertf: committed)
- The full netboot enchilada: (dsieger: in progress)
- htdocs/Documentation/network/netboot/bootpd.html (dsieger: done)
- htdocs/Documentation/network/netboot/dhcpd.html (dsieger: done)
- htdocs/Documentation/network/netboot/files.html (dsieger: done)
- htdocs/Documentation/network/netboot/files.nocons.html (dsieger: done)
- htdocs/Documentation/network/netboot/finish.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.alpha.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.hp300.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.hp700.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.i386.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.macppc.html (dsieger: done)
- htdocs/Documentation/network/netboot/local.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.pmax.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.next68k.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.sun.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.sun2.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.template.html (dsieger: done)
- htdocs/Documentation/network/netboot/intro.vax.html (dsieger: done)
- htdocs/Documentation/network/netboot/local.install.html (dsieger: done)
- htdocs/Documentation/network/netboot/mop.html (dsieger: done)
- htdocs/Documentation/network/netboot/nd.html (dsieger: done)
- htdocs/Documentation/network/netboot/nfs.html (dsieger: done)
- htdocs/Documentation/network/netboot/rarp.html (dsieger: done)
- htdocs/Documentation/network/netboot/tftpd.html (dsieger: done)
- htdocs/Documentation/network/netboot/rbootd/index.html (dsieger: in progress)
- htdocs/Documentation/network/netboot/intro.sun.ofw.html (dsieger: done)
- htdocs/developers/releng/build-release.html (mawei: committed)
- htdocs/developers/releng/howto-pullup.html (mawei: committed)
Updating contents
A lot of updating is needed. Here are a few places:
- Shuffle the index page around a bit (dh_: committed)
- The NetBSD Guide needs to be updated for NetBSD 4.0
- If you prefer *roff work over XML: Check the NetBSD release documentation for NetBSD 4.0 at src/distrib/notes/common and src/distrib/notes/
- All the FAQs in htdocs/Ports/*/faq.xml need a major whack
- The pkgsrc guide
- Our wireless documentation sucks: add ath[3] and other cards that need "special" handling (firmware), wpa_supplicant, etc.
- Steps to connect via GPRS / CDPD should be extended to mention UMTS (/msg lordnikon @ IRCnet)
- NetBSD Documentation: Power Managment: add ACPI, powerd, ...
- Tracking NetBSD-current: see how much is already in the NetBSD guide, and merge it completely (mawei: XMLification done, working on updating and integrating into guide)
- NetBSD wscons FAQ: Merge this into the NetBSD Guide's "Console Drivers" chapter (sjamaan: committed)
- Move old news items on the ports page to a separate "news" page, keep 5 items. May need work to reuse <portnewsitem>s on the news page.
Translations
Note: Translations are considered low priority and local/regional groups are encouraged to maintain them:
- htdocs/developers/translate-french.list
- htdocs/developers/translate-german.list
- htdocs/developers/translate-spanish.list
- htdocs/cs/Releases/formal-1.5/NetBSD-1.5.3.list
- htdocs/cs/Releases/formal-1.6/NetBSD-1.6.1.list
- htdocs/cs/Releases/formal-1.6/NetBSD-1.6.list
- htdocs/cs/Releases/formal-1.6/index.list
- htdocs/de/Documentation/cross/index.list
- htdocs/de/Documentation/books.list
- htdocs/de/Documentation/bootcd.list
- htdocs/de/Documentation/compat.list
- htdocs/de/Documentation/elf.list
- htdocs/de/Documentation/mirror.list
- htdocs/de/Documentation/kernel/uvm.list
- htdocs/de/Documentation/network/ipv6/index.list
- htdocs/de/Documentation/network/dhcp.list
- htdocs/de/Documentation/network/gprs.list
- htdocs/de/Documentation/network/isdn/index.list
- htdocs/de/Documentation/network/nsps/additional.list
- htdocs/de/Documentation/network/nsps/config_ipf.list
- htdocs/de/Documentation/network/nsps/config_ipnat.list
- htdocs/de/Documentation/network/nsps/config_ssh.list
- htdocs/de/Documentation/network/nsps/examples.list
- htdocs/de/Documentation/network/nsps/index.list
- htdocs/de/Documentation/network/nsps/links.list
- htdocs/de/Documentation/network/nsps/overview.list
- htdocs/de/Documentation/network/nsps/services.list
- htdocs/de/Documentation/rc/index.list
- htdocs/de/Documentation/software/compiling.list
- htdocs/de/Documentation/software/packages.list
- htdocs/de/Misc/embed.list
- htdocs/de/Misc/features.list
- htdocs/de/People/groups/index.list
- htdocs/de/Ports/alpha/faq.list
- htdocs/de/Ports/alpha/models.list
- htdocs/de/Releases/formal-1.5/NetBSD-1.5.3.list
- htdocs/de/Releases/formal-1.5/index.list
- htdocs/de/Releases/formal-1.6/NetBSD-1.6.1.list
- htdocs/de/Releases/formal-1.6/NetBSD-1.6.list
- htdocs/de/Releases/formal-1.6/index.list
- htdocs/de/contrib/donations.list
- htdocs/de/contrib/hardware.list
- htdocs/de/contrib/howto.list
- htdocs/de/developers/cvs-repos/branch.list
- htdocs/de/developers/cvs-repos/notes.list
- htdocs/de/developers/gnats-admin.list
- htdocs/de/developers/mirrors.list
- htdocs/de/developers/security.list
- htdocs/de/developers/style.list
- htdocs/de/gallery/xearth/index.list
- htdocs/de/gallery/devotionalia.list
- htdocs/de/gallery/hardware.list
- htdocs/de/gallery/logos.list
- htdocs/de/gallery/preinstalled.list
- htdocs/de/gallery/products.list
- htdocs/de/gallery/research.list
- htdocs/de/gallery/resources.list
- htdocs/de/gallery/software.list
- htdocs/es/Changes/index.list
- htdocs/es/Releases/formal-1.5/NetBSD-1.5.3.list
- htdocs/es/Releases/formal-1.5/index.list
- htdocs/es/Releases/formal-1.6/NetBSD-1.6.1.list
- htdocs/es/Releases/formal-1.6/NetBSD-1.6.list
- htdocs/es/Releases/formal-1.6/index.list
- htdocs/et/Documentation/software/compiling.list
- htdocs/et/Documentation/software/pkg-growth-jpg.list
- htdocs/et/Documentation/software/pkg-growth.list
- htdocs/et/Misc/embed.list
- htdocs/et/Misc/features.list
- htdocs/et/Releases/formal-1.6/NetBSD-1.6.1.list
- htdocs/et/Releases/formal-1.6/NetBSD-1.6.2.list
- htdocs/et/Releases/formal-1.6/index.list
- htdocs/et/gallery/events.list
- htdocs/fr/Documentation/kernel/index.list
- htdocs/fr/Documentation/kernel/programming.list
- htdocs/fr/Documentation/kernel/uvm.list
- htdocs/fr/Documentation/bootcd.list
- htdocs/fr/Documentation/compat.list
- htdocs/fr/Documentation/elf.list
- htdocs/fr/Documentation/mirror.list
- htdocs/fr/Documentation/misc/smbprint/index.list
- htdocs/fr/Documentation/misc/index.list
- htdocs/fr/Documentation/network/ipsec/index.list
- htdocs/fr/Documentation/network/ipsec/oldtree.list
- htdocs/fr/Documentation/network/dhcp.list
- htdocs/fr/Documentation/network/index.list
- htdocs/fr/Documentation/network/wavelan.list
- htdocs/fr/Documentation/network/ipv6/index.list
- htdocs/fr/Documentation/software/compiling.list
- htdocs/fr/Documentation/software/packages.list
- htdocs/fr/Documentation/software/pkg-growth-jpg.list
- htdocs/fr/Documentation/software/pkg-growth.list
- htdocs/fr/Documentation/x/index.list
- htdocs/fr/Misc/features.list
- htdocs/fr/Ports/mac68k/meta-faq/meta-faq-1.list
- htdocs/fr/Ports/mac68k/meta-faq/meta-faq-2.list
- htdocs/fr/Ports/mac68k/meta-faq/meta-faq-3.list
- htdocs/fr/Ports/mac68k/meta-faq/meta-faq-4.list
- htdocs/fr/Ports/mac68k/meta-faq/meta-faq-5.list
- htdocs/fr/Ports/mac68k/meta-faq/meta-faq-6.list
- htdocs/fr/Ports/mac68k/meta-faq/meta-faq-7.list
- htdocs/fr/Ports/mac68k/meta-faq/meta-faq-8.list
- htdocs/fr/Ports/macppc/faq.list
- htdocs/fr/Releases/formal-1.5/NetBSD-1.5.1.list
- htdocs/fr/Releases/formal-1.5/NetBSD-1.5.2.list
- htdocs/fr/Releases/formal-1.5/NetBSD-1.5.3.list
- htdocs/fr/Releases/formal-1.5/index.list
- htdocs/fr/Releases/formal-1.6/NetBSD-1.6.1.list
- htdocs/fr/Releases/formal-1.6/NetBSD-1.6.list
- htdocs/fr/Releases/formal-1.6/index.list
- htdocs/fr/Sites/cdroms.list
- htdocs/fr/gallery/articles.list
- htdocs/ja/Documentation/Hardware/Misc/serial.list
- htdocs/ja/Documentation/kernel/pseudo/index.list
- htdocs/ja/Documentation/kernel/kgdb.list
- htdocs/ja/Documentation/network/pppoe/index.list
- htdocs/ja/Documentation/power-mgmt/index.list
- htdocs/ja/Documentation/software/pkg-growth-jpg.list
- htdocs/ja/Documentation/software/pkg-growth.list
- htdocs/ja/Ports/hp700/faq.list
- htdocs/ja/Ports/hpcmips/compat-pmax.list
- htdocs/ja/Ports/hpcmips/faq.list
- htdocs/ja/Ports/hpcmips/howto-develop.list
- htdocs/ja/Ports/hpcmips/howto-use.list
- htdocs/ja/Ports/hpcmips/pocketv6.list
- htdocs/ja/Ports/mac68k/info/info-3.list
- htdocs/ja/Ports/mac68k/info/info-4.list
- htdocs/ja/Ports/mac68k/info/info-5.list
- htdocs/ja/Ports/mac68k/info/info-6.list
- htdocs/ja/Ports/mac68k/info/info-7.list
- htdocs/ja/Ports/mac68k/info/info-8.list
- htdocs/ja/Ports/mac68k/info/info-9.list
- htdocs/ja/Ports/mac68k/meta-faq/meta-faq-1.list
- htdocs/ja/Ports/mac68k/meta-faq/meta-faq-2.list
- htdocs/ja/Ports/mac68k/meta-faq/meta-faq-3.list
- htdocs/ja/Ports/mac68k/meta-faq/meta-faq-4.list
- htdocs/ja/Ports/mac68k/meta-faq/meta-faq-5.list
- htdocs/ja/Ports/mac68k/meta-faq/meta-faq-6.list
- htdocs/ja/Ports/mac68k/meta-faq/meta-faq-7.list
- htdocs/ja/Ports/mac68k/meta-faq/meta-faq-8.list
- htdocs/ja/Ports/macppc/oldfaq.list
- htdocs/ja/Ports/macppc/x11.list
- htdocs/ja/Ports/mipsco/faq.list
- htdocs/ja/Ports/mipsco/models.list
- htdocs/ja/Ports/news68k/faq.list
- htdocs/ja/Ports/pmppc/faq.list
- htdocs/ja/Ports/sh3/faq.list
- htdocs/ja/Ports/sh5/faq.list
- htdocs/ja/Ports/sun2/faq.list
- htdocs/ja/Ports/sun3/faq.list
- htdocs/ja/Releases/formal-1.4/index.list
- htdocs/ja/Releases/formal-1.5/NetBSD-1.5.1.list
- htdocs/ja/Releases/formal-1.5/NetBSD-1.5.2.list
- htdocs/ja/Releases/formal-1.5/NetBSD-1.5.3.list
- htdocs/ja/Releases/formal-1.5/index.list
- htdocs/ja/Releases/formal-1.6/NetBSD-1.6.1.list
- htdocs/ja/Releases/formal-1.6/NetBSD-1.6.list
- htdocs/ja/Releases/formal-1.6/index.list
- htdocs/ja/developers/cvs-repos/branch.list
- htdocs/ja/developers/PR.list
- htdocs/ko/Documentation/updating.list
- htdocs/ko/Documentation/current/index.list
- htdocs/ko/Documentation/kernel/pseudo/index.list
- htdocs/ko/Documentation/kernel/index.list
- htdocs/ko/Documentation/kernel/kgdb.list
- htdocs/ko/Documentation/kernel/programming.list
- htdocs/ko/Documentation/misc/index.list
- htdocs/ko/Documentation/network/nsps/config_ssh.list
- htdocs/ko/Documentation/network/nsps/index.list
- htdocs/ko/Documentation/network/nsps/overview.list
- htdocs/ko/Documentation/network/index.list
- htdocs/ko/Misc/features.list
- htdocs/ko/People/groups/index.list
- htdocs/ko/Releases/formal-1.5/NetBSD-1.5.3.list
- htdocs/ko/Releases/formal-1.6/index.list
- htdocs/ko/gallery/groups.list
- htdocs/lt/Documentation/software/compiling.list
- htdocs/lt/Documentation/mirror.list
- htdocs/lt/Documentation/updating.list
- htdocs/lt/Misc/features.list
- htdocs/lt/Releases/formal-1.6/NetBSD-1.6.1.list
- htdocs/lt/Releases/formal-1.6/NetBSD-1.6.list
- htdocs/lt/Releases/formal-1.6/index.list
- htdocs/lt/gallery/xearth/index.list
- htdocs/lt/gallery/resources.list
- htdocs/nl/Releases/formal-1.6/NetBSD-1.6.1.list
- htdocs/nl/Releases/formal-1.6/index.list
- htdocs/pl/Documentation/current/index.list
- htdocs/pl/Documentation/software/compiling.list
- htdocs/pl/Documentation/software/packages.list
- htdocs/pl/Misc/embed.list
- htdocs/pl/Misc/features.list
- htdocs/pl/Releases/formal-1.5/NetBSD-1.5.2.list
- htdocs/pl/Releases/formal-1.5/NetBSD-1.5.3.list
- htdocs/pl/Releases/formal-1.5/index.list
- htdocs/pt_BR/Misc/embed.list
- htdocs/pt_BR/Misc/features.list
- htdocs/pt_BR/Releases/formal-1.5/NetBSD-1.5.3.list
- htdocs/pt_BR/Releases/formal-1.6/NetBSD-1.6.1.list
- htdocs/pt_BR/Releases/formal-1.6/NetBSD-1.6.list
- htdocs/pt_BR/Releases/formal-1.6/index.list
- htdocs/ru/Releases/formal-1.5/NetBSD-1.5.3.list
- htdocs/ru/Releases/formal-1.5/index.list
- htdocs/ru/Releases/formal-1.6/NetBSD-1.6.1.list
- htdocs/ru/Releases/formal-1.6/NetBSD-1.6.list
- htdocs/ru/Releases/formal-1.6/index.list
- htdocs/sv/People/groups/index.list
- htdocs/sv/Releases/formal-1.5/NetBSD-1.5.3.list
- htdocs/sv/Releases/formal-1.5/index.list
- htdocs/sv/Releases/formal-1.6/NetBSD-1.6.list
- htdocs/sv/Releases/formal-1.6/index.list
Statistics
- Thu Apr 5 13:12:53 MEST 2007: 283 .list files left in htdocs.
- Fri Apr 6 02:29:51 MEST 2007: 274 .list files left
- Sat Apr 7 02:41:11 MEST 2007: 246 .list files left
- Sun Apr 8 03:10:40 MEST 2007: 226 .list files left, 20 non-translations
- Mon Apr 9 12:37:33 MEST 2007: 216 .list files left - 205 translations, 3 translation-related, 8 old release announcements -> 216-205-3-8 = 0 left to do :)
Results
The fifth NetBSD Hackathon took place from Friday, 6th of April, until Sunday, 8th of April 2007. Titled "docathon", the main focus was on bringing the NetBSD WWW pages and documentation into a consistent and more up-to-date state. Here are the results:
- All .list files that are not related to translations have been converted
- Many of the ports pages were previously either available in XML or HTML. To unify them, all the HTML-pages have been converted to XML (or are under conversion).
- The wscons FAQ has been converted and merged into the NetBSD Guide's "console drivers" section.
- Other parts of the documentation previously only available in plain HTML have been converted to XML.
- Obsolete ports pages have been removed in the process of the sh5 and evhsh5 port removal which happended during this weekend, new ports paves have been properly linked.
- Various minor updates and fixes have been applied
Unfortunately, the translations are generally in a state without much hope. In order not to confuse users with highly outdated docs, it is recommended that the translations shall be dropped sooner or later. Of course, regional groups are highly encouraged to maintain their own translations in order to further promote NetBSD for their native users.
Overall, the event was a great success, and given esp. the short notice still a number of people have helped to make it so - thank you very much to all of them!
If you want to learn more about the 5th NetBSD Hackathon, you can find information at the NetBSD.se Wiki at http://wiki.netbsd.se/index.php?title=Hackathon5. People interested in working on any of the open issues feel free to communicate via the netbsd-docs@NetBSD.org mailing list.
