wikisrc/htdocs_migration.mdwn - view

File: [NetBSD Developer Wiki] / wikisrc / htdocs_migration.mdwn
Revision 1.5: download - view: text, annotated - select for diffs
Fri Mar 15 00:56:01 2013 UTC (7 years, 10 months ago) by jdf
Branches: MAIN
CVS tags: HEAD

Update to reflect reality (esp. concerning ports sites migration)

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