File:  [NetBSD Developer Wiki] / wikisrc / htdocs_migration.mdwn
Revision 1.1: download - view: text, annotated - select for diffs
Sun Dec 16 20:39:29 2012 UTC (6 years ago) by jdf
Branches: MAIN
CVS tags: HEAD
Added the template for the htdocs migation plan.

    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