doc/WikiStart

   1 = Welcome to the SIPB Documentation Project =
   2
   3 The SIPB Documentation Project is a project to document in written form the collective knowledge that SIPB members take for granted or use in maintaining services and projects that are not otherwise written down anywhere.
   4
   5 == Documentation Ideas ==
   6
   7 This is a list of topics that need documentation in one form or another or that are good for explaining to prospectives.
   8
   9  * UsingZephyr -- [http://barnowl.mit.edu/wiki/GettingStarted] is a good start, but could use text on screen and tickets, among other things
  10  * AdvancedBarnOwl -- There are a lot of cool things you can do with BarnOwl. Almost none of them are documented (this may belong on the barnowl wiki, but since they're both trac, it's easy to move)
  11
  12  * PrintingAtMit
  13    * QuickPrint
  14    * `lpq`, `lprm`, `queues.mit.edu`
  15    * printing from non-Athena: CupsOnMac
  16    * `-i printadm` (maybe)
  17
  18  * [wiki:XVM] -- using `remctl`, getting the serial console (maybe should go on XVM wiki, but it's also trac so easy to move)
  19
  20  * UsingDebathena -- You've installed Debathena -- now what?  Automounter, `blanche`, cups; using stuff in the GUI.
  21  * AthenaDotFiles -- These are weird and nonstandard compared to traditional UNIX and should be documented, including things like `.environment`
  22
  23  * ScriptsMitEdu -- lots of neat internals to explain
  24
  25  * [wiki:AFSAndYou] -- There should be a central documentation point to using your AFS space, granting access through AFS and through `web`, accessing files from various platforms, and so on.  Don't duplicate iAFS; perhaps latex2html and update it.
  26
  27  * Add your own here!
  28
  29 == Useful Links ==
  30
  31  * WikiFormatting -- Documentation on trac's Wiki formatting language
  32  * SIPB's [http://stuff.mit.edu/sipb/docs.html Inessential Guides]. A previous generation of SIPB documentation. Much of it is dated, but still contains useful knowledge that should be updated or moved here.
  33  * SIPB services and projects list: http://stuff.mit.edu/sipb/project-list.html
  34
  35 === License ===
  36
  37 Unless specified otherwise, all documentation on this wiki will be available under a dual license of
  38
  39  * the Creative Commons Attribution-Share Alike license, and
  40  * the GNU Free Documentation License, with no Invariant Sections, no
  41    Front-Cover Texts, and no Back-Cover-Texts.
  42
  43 As recommended by the [http://stuff.mit.edu/afs/sipb/admin/text/policy/documentation_licensing.txt SIPB Documentation Licensing Recommendation]