# Migration from htdocs to the wiki There are several reasons people want away from the current htdocs system. The main part is that its structure made in docbook is difficult to maintain, and user contributions are nearly impossible. Thus, the plan is to migrate the website to the wiki, from docbook to markdown. This cannot be done automatically, the sites have to be reviewed before entering them in markdown, and the links have to be corrected. ## How htdocs is organized You can check out the current htdocs tree with CVS from any NetBSD CVS server just by checking out `htdocs`. There are 187 `index.html` in the current htdocs, which means there are 187 primary topics with subpages. ## Migration plan The current plan is just to move the files to markdown and the wiki, and then link on the website via .htaccess to the new wiki articles. The old website should then be statically available at some location. It's still questionable whether the whole website has to be transferred one-to-one, or whether we should take the chance to review all the content, which might take up very long and is not possible without further coordination of all developers, esp. for the port maintainers. The articles which clearly have to be transferred are the ones in the `/docs` and the `/ports` hierarchy. For the other ones, as well as the dynamically generated content like the `/changes`, special care has to be taken whether they should be migrated and if so, the generating scripts have to be modified. The files in the `/images` subdirectory should be uploaded again, but their usage has to be looked up. ## Semantical structure of the website As a wiki is potentially unordered while the website had a semantical structure, we need a structure also on the wiki. When migrating anyway, this would have to be reviewed. Current website structure: * about * changes (automatically generated) * community (only external links) * contrib * Organizations that contributed to NetBSD * developers * cvs-repos * features * pkgsrc * releng * docs * Hardware * Busses * Chips * Machines * Misc * psd, smm, usd * Guide * Installation guide * Diverse information * Internals guide * Kernel * misc * smbprint * network * ipsec * ipv6 * isdn * netboot * nsps * pppoe * pkgsrc Guide * puffs * rump * research * power-mgmt * software * foundation * press * reports * financial * resolutions * gallery * advocacy * flyer * sschumacher flyer * events * in-Action * presentations * press * xplanet * mirrors * mailinglists * people * groups * ports * diverse ports * releases * diverse releases * releng * support * hardware * security ## To be done Those which are not yet transformed are these: ./index.html ./about/index.html ./changes/index.html ./community/index.html ./contrib/org/index.html ./contrib/index.html ./developers/index.html ./developers/cvs-repos/index.html ./developers/features/index.html ./developers/pkgsrc/index.html ./developers/releng/index.html ./docs/index.html ./docs/bsd/lite2/index.html ./docs/bsd/index.html ./docs/bsd/net2/index.html ./docs/kernel/profiling/index.html ./docs/kernel/index.html ./docs/kernel/pseudo/index.html ./docs/misc/smbprint/index.html ./docs/network/ipsec/index.html ./docs/network/ipv6/index.html ./docs/network/isdn/index.html ./docs/network/netboot/rbootd/index.html ./docs/network/netboot/index.html ./docs/network/pppoe/index.html ./docs/pkgsrc/index.html ./docs/power-mgmt/index.html ./docs/research/index.html ./docs/rump/index.html ./docs/software/index.html ./donations/index.html ./errors/index.html ./foundation/index.html ./foundation/press/index.html ./gallery/advocacy/index.html ./gallery/index.html ./gallery/events/usenix2001/index.html ./gallery/events/index.html ./gallery/events/usenix2002/index.html ./gallery/events/usenix2003/index.html ./gallery/events/usenix2004/index.html ./gallery/in-Action/index.html ./gallery/presentations/index.html ./gallery/xplanet/index.html ./mailinglists/index.html ./mirrors/torrents/index.html ./mirrors/index.html ./people/index.html ./people/groups/index.html ./ports/arm/index.html ./ports/arm26/index.html ./ports/arm32/index.html ./ports/hpcmips/index.html ./ports/ibmnws/index.html ./ports/mac68k/booter-manual/index.html ./ports/mac68k/index.html ./ports/mac68k/faq/index.html ./ports/mac68k/info/index.html ./ports/mac68k/theobald/index.html ./ports/macppc/index.html ./ports/macppc/SystemDisk-tutorial/index.html ./ports/newsmips/index.html ./ports/pc532/index.html ./ports/pdp10/index.html ./ports/playstation2/index.html ./ports/pmppc/index.html ./ports/s390/index.html ./ports/sh3/index.html ./releases/formal-0.8/index.html ./releases/index.html ./releases/formal-0.9/index.html ./releases/formal-1.0/index.html ./releases/formal-1.1/index.html ./releases/formal-1.2/index.html ./releases/formal-1.3/sun3x/index.html ./releases/formal-1.3/index.html ./releases/formal-1.4/index.html ./releases/formal-1.5/index.html ./releases/formal-1.6/index.html ./releases/formal-2.0/index.html ./releases/formal-3/index.html ./releases/formal-4/index.html ./releases/formal-5/index.html ./releases/formal-6/index.html ./releng/index.html ./sites/index.html ./support/hardware/index.html ./support/index.html ./support/security/index.html # Already done Those are the index files already transformed by GCi students and not yet in the wiki: ./docs/current/index.html ./docs/network/nsps/index.html ./docs/internals/en/index.html ./ports/xen/index.html ./docs/x/index.html ./docs/puffs/index.html ./docs/network/index.html Those are single files which were also done by GCi students: ./docs/bootcd.html http://ftp.netbsd.org/pub/NetBSD/NetBSD-5.1.2/i386/INSTALL.html ./docs/encrypted-iscsi.html Those are the ones already in the wiki: ./ports/amd64/index.html ./ports/evbarm/index.html ./ports/evbmips/index.html ./ports/evbppc/index.html ./ports/hpcarm/index.html ./ports/i386/index.html ./ports/sparc/index.html ./ports/sparc64/index.html ./ports/acorn26/index.html ./ports/acorn32/index.html ./ports/algor/index.html ./ports/alpha/index.html ./ports/amiga/index.html ./ports/amigappc/index.html ./ports/arc/index.html ./ports/atari/index.html ./ports/bebox/index.html ./ports/cats/index.html ./ports/cesfic/index.html ./ports/cobalt/index.html ./ports/dreamcast/index.html ./ports/emips/index.html ./ports/evbsh3/index.html ./ports/ews4800mips/index.html ./ports/hp300/index.html ./ports/hp700/index.html ./ports/hpcsh/index.html ./ports/ia64/index.html ./ports/iyonix/index.html ./ports/landisk/index.html ./ports/luna68k/index.html ./ports/mipsco/index.html ./ports/mmeye/index.html ./ports/mvme68k/index.html ./ports/mvmeppc/index.html ./ports/netwinder/index.html ./ports/news68k/index.html ./ports/sun2/index.html ./ports/next68k/index.html ./ports/ofppc/index.html ./ports/pmax/index.html ./ports/prep/index.html ./ports/rs6000/index.html ./ports/sandpoint/index.html ./ports/sbmips/index.html ./ports/sgimips/index.html ./ports/shark/index.html ./ports/sun3/index.html ./ports/vax/index.html ./ports/x68k/index.html ./ports/zaurus/index.html ./ports/xen ./ports/index.html ./docs/guide/en/index.html Superseded anyway: ./docs/cross/index.html Not to be ported (because of being hopelessly outdated): ./docs/misc/index.html ./docs/Hardware/Busses/ADB/index.html ./docs/Hardware/Busses/ATA/index.html ./docs/Hardware/Busses/index.html ./docs/Hardware/Busses/I2C/index.html ./docs/Hardware/Busses/IEEE1394/index.html ./docs/Hardware/Busses/MCA/index.html ./docs/Hardware/Busses/Q-bus/index.html ./docs/Hardware/Busses/SCSI/index.html ./docs/Hardware/Busses/USB/index.html ./docs/Hardware/Busses/VME/index.html ./docs/Hardware/Busses/Zorro/index.html ./docs/Hardware/index.html ./docs/Hardware/Chips/DEC/index.html ./docs/Hardware/Chips/index.html ./docs/Hardware/Chips/HP/index.html ./docs/Hardware/Chips/Intel/index.html ./docs/Hardware/Chips/MIPS/index.html ./docs/Hardware/Chips/Microchip/index.html ./docs/Hardware/Chips/Motorola/index.html ./docs/Hardware/Chips/NatSemi/index.html ./docs/Hardware/Chips/TI/index.html ./docs/Hardware/Machines/ARC/index.html ./docs/Hardware/Machines/DEC/vax/index.html ./docs/Hardware/Machines/DEC/index.html ./docs/Hardware/Machines/index.html ./docs/Hardware/Machines/Apollo/index.html ./docs/Hardware/Machines/Apple/index.html ./docs/Hardware/Machines/Commodore/index.html ./docs/Hardware/Machines/HP/index.html ./docs/Hardware/Machines/IBM/index.html ./docs/Hardware/Machines/MacroSystem/index.html ./docs/Hardware/Machines/Motorola/index.html ./docs/Hardware/Machines/NeXT/index.html ./docs/Hardware/Machines/PC532/index.html ./docs/Hardware/Machines/Sun/index.html ./docs/Hardware/Misc/index.html