Annotation of wikisrc/htdocs_migration.mdwn, revision 1.1

1.1     ! jdf         1: # Migraton from htdocs to the wiki
        !             2: There are several reasons people want away from the current htdocs system. 
        !             3: The main part is that its structure made in docbook is difficult to maintain, 
        !             4: and user contributions are nearly impossible.
        !             5: Thus, the plan is to migrate the website to the wiki, from docbook to markdown.
        !             6: This cannot be done automatically, the sites have to be reviewed before entering
        !             7: them in markdown, and the links have to be corrected.
        !             8: 
        !             9: If you want to participate, just have a look at the not-yet transformed articles
        !            10: and transfer them. If you need access to a working wiki, write a mail to jdf@ 
        !            11: with your mail-address and username and you will be granted access to the GCi 
        !            12: wiki.
        !            13: 
        !            14: ## How htdocs is organized
        !            15: You can check out the current htdocs tree with CVS from any NetBSD CVS server 
        !            16: just by checking out `htdocs`.
        !            17: 
        !            18: There are 187 `index.html` in the current htdocs, which means there are 187 
        !            19: primary topics with subpages.
        !            20: 
        !            21: ## Migration plan
        !            22: The current plan is just to move the files to markdown and the wiki, and then 
        !            23: link on the website via .htaccess to the new wiki articles.
        !            24: The old website should then be statically available at some location.
        !            25: 
        !            26: It's still questionable whether the whole website has to be transferred 
        !            27: one-to-one, or whether we should take the chance to review all the content, 
        !            28: which might take up very long and is not possible without further coordination 
        !            29: of all developers, esp. for the port maintainers.
        !            30: 
        !            31: The articles which clearly have to be transferred are the ones in the `/docs` 
        !            32: and the `/ports` hierarchy. For the other ones, as well as the dynamically 
        !            33: generated content like the `/changes`, special care has to be taken whether they 
        !            34: should be migrated and if so, the generating scripts have to be modified.
        !            35: 
        !            36: The files in the `/images` subdirectory should be uploaded again, but their 
        !            37: usage has to be looked up.
        !            38: 
        !            39: ## To be done
        !            40: Those which are not yet transformed are these:
        !            41:     ./index.html
        !            42:     ./about/index.html
        !            43:     ./changes/index.html
        !            44:     ./community/index.html
        !            45:     ./contrib/org/index.html
        !            46:     ./contrib/index.html
        !            47:     ./developers/index.html
        !            48:     ./developers/cvs-repos/index.html
        !            49:     ./developers/features/index.html
        !            50:     ./developers/pkgsrc/index.html
        !            51:     ./developers/releng/index.html
        !            52:     ./docs/Hardware/Busses/ADB/index.html
        !            53:     ./docs/Hardware/Busses/ATA/index.html
        !            54:     ./docs/Hardware/Busses/index.html
        !            55:     ./docs/Hardware/Busses/I2C/index.html
        !            56:     ./docs/Hardware/Busses/IEEE1394/index.html
        !            57:     ./docs/Hardware/Busses/MCA/index.html
        !            58:     ./docs/Hardware/Busses/Q-bus/index.html
        !            59:     ./docs/Hardware/Busses/SCSI/index.html
        !            60:     ./docs/Hardware/Busses/USB/index.html
        !            61:     ./docs/Hardware/Busses/VME/index.html
        !            62:     ./docs/Hardware/Busses/Zorro/index.html
        !            63:     ./docs/Hardware/index.html
        !            64:     ./docs/Hardware/Chips/DEC/index.html
        !            65:     ./docs/Hardware/Chips/index.html
        !            66:     ./docs/Hardware/Chips/HP/index.html
        !            67:     ./docs/Hardware/Chips/Intel/index.html
        !            68:     ./docs/Hardware/Chips/MIPS/index.html
        !            69:     ./docs/Hardware/Chips/Microchip/index.html
        !            70:     ./docs/Hardware/Chips/Motorola/index.html
        !            71:     ./docs/Hardware/Chips/NatSemi/index.html
        !            72:     ./docs/Hardware/Chips/TI/index.html
        !            73:     ./docs/Hardware/Machines/ARC/index.html
        !            74:     ./docs/Hardware/Machines/DEC/vax/index.html
        !            75:     ./docs/Hardware/Machines/DEC/index.html
        !            76:     ./docs/Hardware/Machines/index.html
        !            77:     ./docs/Hardware/Machines/Apollo/index.html
        !            78:     ./docs/Hardware/Machines/Apple/index.html
        !            79:     ./docs/Hardware/Machines/Commodore/index.html
        !            80:     ./docs/Hardware/Machines/HP/index.html
        !            81:     ./docs/Hardware/Machines/IBM/index.html
        !            82:     ./docs/Hardware/Machines/MacroSystem/index.html
        !            83:     ./docs/Hardware/Machines/Motorola/index.html
        !            84:     ./docs/Hardware/Machines/NeXT/index.html
        !            85:     ./docs/Hardware/Machines/PC532/index.html
        !            86:     ./docs/Hardware/Machines/Sun/index.html
        !            87:     ./docs/Hardware/Misc/index.html
        !            88:     ./docs/index.html
        !            89:     ./docs/bsd/lite2/index.html
        !            90:     ./docs/bsd/index.html
        !            91:     ./docs/bsd/net2/index.html
        !            92:     ./docs/cross/index.html
        !            93:     ./docs/kernel/profiling/index.html
        !            94:     ./docs/kernel/index.html
        !            95:     ./docs/kernel/pseudo/index.html
        !            96:     ./docs/misc/smbprint/index.html
        !            97:     ./docs/network/ipsec/index.html
        !            98:     ./docs/network/ipv6/index.html
        !            99:     ./docs/network/isdn/index.html
        !           100:     ./docs/network/netboot/rbootd/index.html
        !           101:     ./docs/network/netboot/index.html
        !           102:     ./docs/network/pppoe/index.html
        !           103:     ./docs/pkgsrc/index.html
        !           104:     ./docs/power-mgmt/index.html
        !           105:     ./docs/research/index.html
        !           106:     ./docs/rump/index.html
        !           107:     ./docs/software/index.html
        !           108:     ./donations/index.html
        !           109:     ./errors/index.html
        !           110:     ./foundation/index.html
        !           111:     ./foundation/press/index.html
        !           112:     ./gallery/advocacy/index.html
        !           113:     ./gallery/index.html
        !           114:     ./gallery/events/usenix2001/index.html
        !           115:     ./gallery/events/index.html
        !           116:     ./gallery/events/usenix2002/index.html
        !           117:     ./gallery/events/usenix2003/index.html
        !           118:     ./gallery/events/usenix2004/index.html
        !           119:     ./gallery/in-Action/index.html
        !           120:     ./gallery/presentations/index.html
        !           121:     ./gallery/xplanet/index.html
        !           122:     ./mailinglists/index.html
        !           123:     ./mirrors/torrents/index.html
        !           124:     ./mirrors/index.html
        !           125:     ./people/index.html
        !           126:     ./people/groups/index.html
        !           127:     ./ports/acorn26/index.html
        !           128:     ./ports/index.html
        !           129:     ./ports/acorn32/index.html
        !           130:     ./ports/algor/index.html
        !           131:     ./ports/alpha/index.html
        !           132:     ./ports/amiga/index.html
        !           133:     ./ports/amigappc/index.html
        !           134:     ./ports/arc/index.html
        !           135:     ./ports/arm/index.html
        !           136:     ./ports/arm26/index.html
        !           137:     ./ports/arm32/index.html
        !           138:     ./ports/atari/index.html
        !           139:     ./ports/bebox/index.html
        !           140:     ./ports/cats/index.html
        !           141:     ./ports/cesfic/index.html
        !           142:     ./ports/cobalt/index.html
        !           143:     ./ports/dreamcast/index.html
        !           144:     ./ports/emips/index.html
        !           145:     ./ports/evbsh3/index.html
        !           146:     ./ports/ews4800mips/index.html
        !           147:     ./ports/hp300/index.html
        !           148:     ./ports/hp700/index.html
        !           149:     ./ports/hpcmips/index.html
        !           150:     ./ports/hpcsh/index.html
        !           151:     ./ports/ia64/index.html
        !           152:     ./ports/ibmnws/index.html
        !           153:     ./ports/iyonix/index.html
        !           154:     ./ports/landisk/index.html
        !           155:     ./ports/luna68k/index.html
        !           156:     ./ports/mac68k/booter-manual/index.html
        !           157:     ./ports/mac68k/index.html
        !           158:     ./ports/mac68k/faq/index.html
        !           159:     ./ports/mac68k/info/index.html
        !           160:     ./ports/mac68k/theobald/index.html
        !           161:     ./ports/macppc/index.html
        !           162:     ./ports/macppc/SystemDisk-tutorial/index.html
        !           163:     ./ports/mipsco/index.html
        !           164:     ./ports/mmeye/index.html
        !           165:     ./ports/mvme68k/index.html
        !           166:     ./ports/mvmeppc/index.html
        !           167:     ./ports/netwinder/index.html
        !           168:     ./ports/news68k/index.html
        !           169:     ./ports/newsmips/index.html
        !           170:     ./ports/next68k/index.html
        !           171:     ./ports/ofppc/index.html
        !           172:     ./ports/pc532/index.html
        !           173:     ./ports/pdp10/index.html
        !           174:     ./ports/playstation2/index.html
        !           175:     ./ports/pmax/index.html
        !           176:     ./ports/pmppc/index.html
        !           177:     ./ports/prep/index.html
        !           178:     ./ports/rs6000/index.html
        !           179:     ./ports/s390/index.html
        !           180:     ./ports/sandpoint/index.html
        !           181:     ./ports/sbmips/index.html
        !           182:     ./ports/sgimips/index.html
        !           183:     ./ports/sh3/index.html
        !           184:     ./ports/shark/index.html
        !           185:     ./ports/sun2/index.html
        !           186:     ./ports/sun3/index.html
        !           187:     ./ports/vax/index.html
        !           188:     ./ports/x68k/index.html
        !           189:     ./ports/zaurus/index.html
        !           190:     ./releases/formal-0.8/index.html
        !           191:     ./releases/index.html
        !           192:     ./releases/formal-0.9/index.html
        !           193:     ./releases/formal-1.0/index.html
        !           194:     ./releases/formal-1.1/index.html
        !           195:     ./releases/formal-1.2/index.html
        !           196:     ./releases/formal-1.3/sun3x/index.html
        !           197:     ./releases/formal-1.3/index.html
        !           198:     ./releases/formal-1.4/index.html
        !           199:     ./releases/formal-1.5/index.html
        !           200:     ./releases/formal-1.6/index.html
        !           201:     ./releases/formal-2.0/index.html
        !           202:     ./releases/formal-3/index.html
        !           203:     ./releases/formal-4/index.html
        !           204:     ./releases/formal-5/index.html
        !           205:     ./releases/formal-6/index.html
        !           206:     ./releng/index.html
        !           207:     ./sites/index.html
        !           208:     ./support/hardware/index.html
        !           209:     ./support/index.html
        !           210:     ./support/security/index.html
        !           211: 
        !           212: # Already done
        !           213: Those are the index files already transformed by GCi students and not yet in the 
        !           214: wiki:
        !           215:     ./docs/current/index.html
        !           216:     ./docs/network/nsps/index.html
        !           217:     ./docs/internals/en/index.html
        !           218:     ./ports/xen/index.html
        !           219:     ./docs/x/index.html
        !           220:     ./docs/misc/index.html
        !           221:     ./docs/puffs/index.html
        !           222:     ./docs/network/index.html
        !           223:     ./docs/guide/en/index.html
        !           224: 
        !           225: Those are single files which were also done by GCi students:
        !           226:     ./docs/bootcd.html
        !           227:     http://ftp.netbsd.org/pub/NetBSD/NetBSD-5.1.2/i386/INSTALL.html
        !           228:     ./docs/encrypted-iscsi.html
        !           229: 
        !           230: Those are the ones already in the wiki:
        !           231:     ./ports/amd64/index.html
        !           232:     ./ports/evbarm/index.html
        !           233:     ./ports/evbmips/index.html
        !           234:     ./ports/evbppc/index.html
        !           235:     ./ports/hpcarm/index.html
        !           236:     ./ports/i386/index.html
        !           237:     ./ports/sparc/index.html
        !           238:     ./ports/sparc64/index.html
        !           239:     ./ports/xen

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