File:  [NetBSD Developer Wiki] / wikisrc / htdocs_migration.mdwn
Revision 1.6: download - view: text, annotated - select for diffs
Fri Mar 15 01:05:44 2013 UTC (13 months ago) by jdf
Branches: MAIN
CVS tags: HEAD
Mark docs/cross as superseded.

# 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.

If you want to participate, just have a look at the not-yet transformed articles
and transfer them. If you need access to a working wiki, write a mail to jdf@ 
with your mail-address and username and you will be granted access to the GCi 
wiki.

## 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/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
    ./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

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