File:  [NetBSD Developer Wiki] / wikisrc / htdocs_migration.mdwn
Revision 1.7: download - view: text, annotated - select for diffs
Fri Mar 15 20:09:05 2013 UTC (7 years ago) by jdf
Branches: MAIN
CVS tags: HEAD
Mark the whole hardware section as not-to-be-ported.

    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/index.html
  125:     ./docs/bsd/lite2/index.html
  126:     ./docs/bsd/index.html
  127:     ./docs/bsd/net2/index.html
  128:     ./docs/kernel/profiling/index.html
  129:     ./docs/kernel/index.html
  130:     ./docs/kernel/pseudo/index.html
  131:     ./docs/misc/smbprint/index.html
  132:     ./docs/network/ipsec/index.html
  133:     ./docs/network/ipv6/index.html
  134:     ./docs/network/isdn/index.html
  135:     ./docs/network/netboot/rbootd/index.html
  136:     ./docs/network/netboot/index.html
  137:     ./docs/network/pppoe/index.html
  138:     ./docs/pkgsrc/index.html
  139:     ./docs/power-mgmt/index.html
  140:     ./docs/research/index.html
  141:     ./docs/rump/index.html
  142:     ./docs/software/index.html
  143:     ./donations/index.html
  144:     ./errors/index.html
  145:     ./foundation/index.html
  146:     ./foundation/press/index.html
  147:     ./gallery/advocacy/index.html
  148:     ./gallery/index.html
  149:     ./gallery/events/usenix2001/index.html
  150:     ./gallery/events/index.html
  151:     ./gallery/events/usenix2002/index.html
  152:     ./gallery/events/usenix2003/index.html
  153:     ./gallery/events/usenix2004/index.html
  154:     ./gallery/in-Action/index.html
  155:     ./gallery/presentations/index.html
  156:     ./gallery/xplanet/index.html
  157:     ./mailinglists/index.html
  158:     ./mirrors/torrents/index.html
  159:     ./mirrors/index.html
  160:     ./people/index.html
  161:     ./people/groups/index.html
  162:     ./ports/arm/index.html
  163:     ./ports/arm26/index.html
  164:     ./ports/arm32/index.html
  165:     ./ports/hpcmips/index.html
  166:     ./ports/ibmnws/index.html
  167:     ./ports/mac68k/booter-manual/index.html
  168:     ./ports/mac68k/index.html
  169:     ./ports/mac68k/faq/index.html
  170:     ./ports/mac68k/info/index.html
  171:     ./ports/mac68k/theobald/index.html
  172:     ./ports/macppc/index.html
  173:     ./ports/macppc/SystemDisk-tutorial/index.html
  174:     ./ports/newsmips/index.html
  175:     ./ports/pc532/index.html
  176:     ./ports/pdp10/index.html
  177:     ./ports/playstation2/index.html
  178:     ./ports/pmppc/index.html
  179:     ./ports/s390/index.html
  180:     ./ports/sh3/index.html
  181:     ./releases/formal-0.8/index.html
  182:     ./releases/index.html
  183:     ./releases/formal-0.9/index.html
  184:     ./releases/formal-1.0/index.html
  185:     ./releases/formal-1.1/index.html
  186:     ./releases/formal-1.2/index.html
  187:     ./releases/formal-1.3/sun3x/index.html
  188:     ./releases/formal-1.3/index.html
  189:     ./releases/formal-1.4/index.html
  190:     ./releases/formal-1.5/index.html
  191:     ./releases/formal-1.6/index.html
  192:     ./releases/formal-2.0/index.html
  193:     ./releases/formal-3/index.html
  194:     ./releases/formal-4/index.html
  195:     ./releases/formal-5/index.html
  196:     ./releases/formal-6/index.html
  197:     ./releng/index.html
  198:     ./sites/index.html
  199:     ./support/hardware/index.html
  200:     ./support/index.html
  201:     ./support/security/index.html
  202: 
  203: # Already done
  204: Those are the index files already transformed by GCi students and not yet in the 
  205: wiki:
  206: 
  207:     ./docs/current/index.html
  208:     ./docs/network/nsps/index.html
  209:     ./docs/internals/en/index.html
  210:     ./ports/xen/index.html
  211:     ./docs/x/index.html
  212:     ./docs/puffs/index.html
  213:     ./docs/network/index.html
  214: 
  215: Those are single files which were also done by GCi students:
  216: 
  217:     ./docs/bootcd.html
  218:     http://ftp.netbsd.org/pub/NetBSD/NetBSD-5.1.2/i386/INSTALL.html
  219:     ./docs/encrypted-iscsi.html
  220: 
  221: Those are the ones already in the wiki:
  222: 
  223:     ./ports/amd64/index.html
  224:     ./ports/evbarm/index.html
  225:     ./ports/evbmips/index.html
  226:     ./ports/evbppc/index.html
  227:     ./ports/hpcarm/index.html
  228:     ./ports/i386/index.html
  229:     ./ports/sparc/index.html
  230:     ./ports/sparc64/index.html
  231:     ./ports/acorn26/index.html
  232:     ./ports/acorn32/index.html
  233:     ./ports/algor/index.html
  234:     ./ports/alpha/index.html
  235:     ./ports/amiga/index.html
  236:     ./ports/amigappc/index.html
  237:     ./ports/arc/index.html
  238:     ./ports/atari/index.html
  239:     ./ports/bebox/index.html
  240:     ./ports/cats/index.html
  241:     ./ports/cesfic/index.html
  242:     ./ports/cobalt/index.html
  243:     ./ports/dreamcast/index.html
  244:     ./ports/emips/index.html
  245:     ./ports/evbsh3/index.html
  246:     ./ports/ews4800mips/index.html
  247:     ./ports/hp300/index.html
  248:     ./ports/hp700/index.html
  249:     ./ports/hpcsh/index.html
  250:     ./ports/ia64/index.html
  251:     ./ports/iyonix/index.html
  252:     ./ports/landisk/index.html
  253:     ./ports/luna68k/index.html
  254:     ./ports/mipsco/index.html
  255:     ./ports/mmeye/index.html
  256:     ./ports/mvme68k/index.html
  257:     ./ports/mvmeppc/index.html
  258:     ./ports/netwinder/index.html
  259:     ./ports/news68k/index.html
  260:     ./ports/sun2/index.html
  261:     ./ports/next68k/index.html
  262:     ./ports/ofppc/index.html
  263:     ./ports/pmax/index.html
  264:     ./ports/prep/index.html
  265:     ./ports/rs6000/index.html
  266:     ./ports/sandpoint/index.html
  267:     ./ports/sbmips/index.html
  268:     ./ports/sgimips/index.html
  269:     ./ports/shark/index.html
  270:     ./ports/sun3/index.html
  271:     ./ports/vax/index.html
  272:     ./ports/x68k/index.html
  273:     ./ports/zaurus/index.html
  274:     ./ports/xen
  275:     ./ports/index.html
  276:     ./docs/guide/en/index.html
  277: 
  278: Superseded anyway:
  279: 
  280:     ./docs/cross/index.html
  281: 
  282: Not to be ported (because of being hopelessly outdated):
  283: 
  284:     ./docs/misc/index.html
  285:     ./docs/Hardware/Busses/ADB/index.html
  286:     ./docs/Hardware/Busses/ATA/index.html
  287:     ./docs/Hardware/Busses/index.html
  288:     ./docs/Hardware/Busses/I2C/index.html
  289:     ./docs/Hardware/Busses/IEEE1394/index.html
  290:     ./docs/Hardware/Busses/MCA/index.html
  291:     ./docs/Hardware/Busses/Q-bus/index.html
  292:     ./docs/Hardware/Busses/SCSI/index.html
  293:     ./docs/Hardware/Busses/USB/index.html
  294:     ./docs/Hardware/Busses/VME/index.html
  295:     ./docs/Hardware/Busses/Zorro/index.html
  296:     ./docs/Hardware/index.html
  297:     ./docs/Hardware/Chips/DEC/index.html
  298:     ./docs/Hardware/Chips/index.html
  299:     ./docs/Hardware/Chips/HP/index.html
  300:     ./docs/Hardware/Chips/Intel/index.html
  301:     ./docs/Hardware/Chips/MIPS/index.html
  302:     ./docs/Hardware/Chips/Microchip/index.html
  303:     ./docs/Hardware/Chips/Motorola/index.html
  304:     ./docs/Hardware/Chips/NatSemi/index.html
  305:     ./docs/Hardware/Chips/TI/index.html
  306:     ./docs/Hardware/Machines/ARC/index.html
  307:     ./docs/Hardware/Machines/DEC/vax/index.html
  308:     ./docs/Hardware/Machines/DEC/index.html
  309:     ./docs/Hardware/Machines/index.html
  310:     ./docs/Hardware/Machines/Apollo/index.html
  311:     ./docs/Hardware/Machines/Apple/index.html
  312:     ./docs/Hardware/Machines/Commodore/index.html
  313:     ./docs/Hardware/Machines/HP/index.html
  314:     ./docs/Hardware/Machines/IBM/index.html
  315:     ./docs/Hardware/Machines/MacroSystem/index.html
  316:     ./docs/Hardware/Machines/Motorola/index.html
  317:     ./docs/Hardware/Machines/NeXT/index.html
  318:     ./docs/Hardware/Machines/PC532/index.html
  319:     ./docs/Hardware/Machines/Sun/index.html
  320:     ./docs/Hardware/Misc/index.html

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