Annotation of wikisrc/htdocs_migration.mdwn, revision 1.2

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:
1.2     ! jdf        41: 
1.1       jdf        42:     ./index.html
                     43:     ./about/index.html
                     44:     ./changes/index.html
                     45:     ./community/index.html
                     46:     ./contrib/org/index.html
                     47:     ./contrib/index.html
                     48:     ./developers/index.html
                     49:     ./developers/cvs-repos/index.html
                     50:     ./developers/features/index.html
                     51:     ./developers/pkgsrc/index.html
                     52:     ./developers/releng/index.html
                     53:     ./docs/Hardware/Busses/ADB/index.html
                     54:     ./docs/Hardware/Busses/ATA/index.html
                     55:     ./docs/Hardware/Busses/index.html
                     56:     ./docs/Hardware/Busses/I2C/index.html
                     57:     ./docs/Hardware/Busses/IEEE1394/index.html
                     58:     ./docs/Hardware/Busses/MCA/index.html
                     59:     ./docs/Hardware/Busses/Q-bus/index.html
                     60:     ./docs/Hardware/Busses/SCSI/index.html
                     61:     ./docs/Hardware/Busses/USB/index.html
                     62:     ./docs/Hardware/Busses/VME/index.html
                     63:     ./docs/Hardware/Busses/Zorro/index.html
                     64:     ./docs/Hardware/index.html
                     65:     ./docs/Hardware/Chips/DEC/index.html
                     66:     ./docs/Hardware/Chips/index.html
                     67:     ./docs/Hardware/Chips/HP/index.html
                     68:     ./docs/Hardware/Chips/Intel/index.html
                     69:     ./docs/Hardware/Chips/MIPS/index.html
                     70:     ./docs/Hardware/Chips/Microchip/index.html
                     71:     ./docs/Hardware/Chips/Motorola/index.html
                     72:     ./docs/Hardware/Chips/NatSemi/index.html
                     73:     ./docs/Hardware/Chips/TI/index.html
                     74:     ./docs/Hardware/Machines/ARC/index.html
                     75:     ./docs/Hardware/Machines/DEC/vax/index.html
                     76:     ./docs/Hardware/Machines/DEC/index.html
                     77:     ./docs/Hardware/Machines/index.html
                     78:     ./docs/Hardware/Machines/Apollo/index.html
                     79:     ./docs/Hardware/Machines/Apple/index.html
                     80:     ./docs/Hardware/Machines/Commodore/index.html
                     81:     ./docs/Hardware/Machines/HP/index.html
                     82:     ./docs/Hardware/Machines/IBM/index.html
                     83:     ./docs/Hardware/Machines/MacroSystem/index.html
                     84:     ./docs/Hardware/Machines/Motorola/index.html
                     85:     ./docs/Hardware/Machines/NeXT/index.html
                     86:     ./docs/Hardware/Machines/PC532/index.html
                     87:     ./docs/Hardware/Machines/Sun/index.html
                     88:     ./docs/Hardware/Misc/index.html
                     89:     ./docs/index.html
                     90:     ./docs/bsd/lite2/index.html
                     91:     ./docs/bsd/index.html
                     92:     ./docs/bsd/net2/index.html
                     93:     ./docs/cross/index.html
                     94:     ./docs/kernel/profiling/index.html
                     95:     ./docs/kernel/index.html
                     96:     ./docs/kernel/pseudo/index.html
                     97:     ./docs/misc/smbprint/index.html
                     98:     ./docs/network/ipsec/index.html
                     99:     ./docs/network/ipv6/index.html
                    100:     ./docs/network/isdn/index.html
                    101:     ./docs/network/netboot/rbootd/index.html
                    102:     ./docs/network/netboot/index.html
                    103:     ./docs/network/pppoe/index.html
                    104:     ./docs/pkgsrc/index.html
                    105:     ./docs/power-mgmt/index.html
                    106:     ./docs/research/index.html
                    107:     ./docs/rump/index.html
                    108:     ./docs/software/index.html
                    109:     ./donations/index.html
                    110:     ./errors/index.html
                    111:     ./foundation/index.html
                    112:     ./foundation/press/index.html
                    113:     ./gallery/advocacy/index.html
                    114:     ./gallery/index.html
                    115:     ./gallery/events/usenix2001/index.html
                    116:     ./gallery/events/index.html
                    117:     ./gallery/events/usenix2002/index.html
                    118:     ./gallery/events/usenix2003/index.html
                    119:     ./gallery/events/usenix2004/index.html
                    120:     ./gallery/in-Action/index.html
                    121:     ./gallery/presentations/index.html
                    122:     ./gallery/xplanet/index.html
                    123:     ./mailinglists/index.html
                    124:     ./mirrors/torrents/index.html
                    125:     ./mirrors/index.html
                    126:     ./people/index.html
                    127:     ./people/groups/index.html
                    128:     ./ports/acorn26/index.html
                    129:     ./ports/index.html
                    130:     ./ports/acorn32/index.html
                    131:     ./ports/algor/index.html
                    132:     ./ports/alpha/index.html
                    133:     ./ports/amiga/index.html
                    134:     ./ports/amigappc/index.html
                    135:     ./ports/arc/index.html
                    136:     ./ports/arm/index.html
                    137:     ./ports/arm26/index.html
                    138:     ./ports/arm32/index.html
                    139:     ./ports/atari/index.html
                    140:     ./ports/bebox/index.html
                    141:     ./ports/cats/index.html
                    142:     ./ports/cesfic/index.html
                    143:     ./ports/cobalt/index.html
                    144:     ./ports/dreamcast/index.html
                    145:     ./ports/emips/index.html
                    146:     ./ports/evbsh3/index.html
                    147:     ./ports/ews4800mips/index.html
                    148:     ./ports/hp300/index.html
                    149:     ./ports/hp700/index.html
                    150:     ./ports/hpcmips/index.html
                    151:     ./ports/hpcsh/index.html
                    152:     ./ports/ia64/index.html
                    153:     ./ports/ibmnws/index.html
                    154:     ./ports/iyonix/index.html
                    155:     ./ports/landisk/index.html
                    156:     ./ports/luna68k/index.html
                    157:     ./ports/mac68k/booter-manual/index.html
                    158:     ./ports/mac68k/index.html
                    159:     ./ports/mac68k/faq/index.html
                    160:     ./ports/mac68k/info/index.html
                    161:     ./ports/mac68k/theobald/index.html
                    162:     ./ports/macppc/index.html
                    163:     ./ports/macppc/SystemDisk-tutorial/index.html
                    164:     ./ports/mipsco/index.html
                    165:     ./ports/mmeye/index.html
                    166:     ./ports/mvme68k/index.html
                    167:     ./ports/mvmeppc/index.html
                    168:     ./ports/netwinder/index.html
                    169:     ./ports/news68k/index.html
                    170:     ./ports/newsmips/index.html
                    171:     ./ports/next68k/index.html
                    172:     ./ports/ofppc/index.html
                    173:     ./ports/pc532/index.html
                    174:     ./ports/pdp10/index.html
                    175:     ./ports/playstation2/index.html
                    176:     ./ports/pmax/index.html
                    177:     ./ports/pmppc/index.html
                    178:     ./ports/prep/index.html
                    179:     ./ports/rs6000/index.html
                    180:     ./ports/s390/index.html
                    181:     ./ports/sandpoint/index.html
                    182:     ./ports/sbmips/index.html
                    183:     ./ports/sgimips/index.html
                    184:     ./ports/sh3/index.html
                    185:     ./ports/shark/index.html
                    186:     ./ports/sun2/index.html
                    187:     ./ports/sun3/index.html
                    188:     ./ports/vax/index.html
                    189:     ./ports/x68k/index.html
                    190:     ./ports/zaurus/index.html
                    191:     ./releases/formal-0.8/index.html
                    192:     ./releases/index.html
                    193:     ./releases/formal-0.9/index.html
                    194:     ./releases/formal-1.0/index.html
                    195:     ./releases/formal-1.1/index.html
                    196:     ./releases/formal-1.2/index.html
                    197:     ./releases/formal-1.3/sun3x/index.html
                    198:     ./releases/formal-1.3/index.html
                    199:     ./releases/formal-1.4/index.html
                    200:     ./releases/formal-1.5/index.html
                    201:     ./releases/formal-1.6/index.html
                    202:     ./releases/formal-2.0/index.html
                    203:     ./releases/formal-3/index.html
                    204:     ./releases/formal-4/index.html
                    205:     ./releases/formal-5/index.html
                    206:     ./releases/formal-6/index.html
                    207:     ./releng/index.html
                    208:     ./sites/index.html
                    209:     ./support/hardware/index.html
                    210:     ./support/index.html
                    211:     ./support/security/index.html
                    212: 
                    213: # Already done
                    214: Those are the index files already transformed by GCi students and not yet in the 
                    215: wiki:
1.2     ! jdf       216: 
1.1       jdf       217:     ./docs/current/index.html
                    218:     ./docs/network/nsps/index.html
                    219:     ./docs/internals/en/index.html
                    220:     ./ports/xen/index.html
                    221:     ./docs/x/index.html
                    222:     ./docs/misc/index.html
                    223:     ./docs/puffs/index.html
                    224:     ./docs/network/index.html
                    225:     ./docs/guide/en/index.html
                    226: 
                    227: Those are single files which were also done by GCi students:
1.2     ! jdf       228: 
1.1       jdf       229:     ./docs/bootcd.html
                    230:     http://ftp.netbsd.org/pub/NetBSD/NetBSD-5.1.2/i386/INSTALL.html
                    231:     ./docs/encrypted-iscsi.html
                    232: 
                    233: Those are the ones already in the wiki:
1.2     ! jdf       234: 
1.1       jdf       235:     ./ports/amd64/index.html
                    236:     ./ports/evbarm/index.html
                    237:     ./ports/evbmips/index.html
                    238:     ./ports/evbppc/index.html
                    239:     ./ports/hpcarm/index.html
                    240:     ./ports/i386/index.html
                    241:     ./ports/sparc/index.html
                    242:     ./ports/sparc64/index.html
                    243:     ./ports/xen

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