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