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