Separate ideas and existing topics.
[wiki.git] / doc / WikiStart
index f9073f8379add0ee5eaccd9979936de41e4852bc..b0d7629fe179e3dbb4520ff653c152c74fa9ef5b 100644 (file)
@@ -1,10 +1,58 @@
 = Welcome to the SIPB Documentation Project =
 
 = Welcome to the SIPB Documentation Project =
 
-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 previously written down anywhere. 
+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.
 
 
-To kick off the project, we will be holding a SIPB Documentathon in the SIPB office on Sunday, September 14, starting at 1pm. Anyone who either has or wants knowledge about computing at MIT or SIPB is welcome!
+See ProjectIdeas for stuff to try doing to further the goals of the SIPB.
+
+See '''LennyBugs''' for bugs to take on in the Lenny
+'''RC-bug-squashing hackathon''' of '''December 13, 2008'''.
+
+== Documentation Topics ==
+
+ * UsingZephyr -- An attempt at a complete beginner's guide to getting
+   on Zephyr with BarnOwl and screen.
+  * BarnOwl has some more documentation on [http://barnowl.mit.edu/ its wiki]
+ * [wiki:XVM] (On XVM's trac)
+  * [https://xvm.mit.edu/trac/wiki/Remctl using `remctl`]
+  * [https://xvm.mit.edu/trac/wiki/SerialConsole getting the serial console]
+ * SummerReading -- Documents or books that various SIPB members recommend reading.
+
+== Documentation Ideas ==
+
+This is a list of topics that need documentation in one form or
+another or that are good for explaining to prospectives.
+
+ * PrintingAtMit
+   * QuickPrint
+   * `lpq`, `lprm`, `queues.mit.edu`
+   * printing from non-Athena: CupsOnMac
+   * `-i printadm` (maybe)
+
+ * UsingDebathena -- You've installed Debathena -- now what?  Automounter, `blanche`, cups; using stuff in the GUI.
+ * AthenaDotFiles -- These are weird and nonstandard compared to traditional UNIX and should be documented, including things like `.environment`
+   * There's some documentation at [http://web.mit.edu/olh/Dotfiles/]
+
+ * ScriptsMitEdu -- lots of neat internals to explain
+
+ * [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.
+
+ * Add your own here!
 
 == Useful Links ==
 
  * WikiFormatting -- Documentation on trac's Wiki formatting language
 
 == Useful Links ==
 
  * WikiFormatting -- Documentation on trac's Wiki formatting language
- * DocumentationIdeas -- Projects or services in need of documentation by someone
+ * 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.
+ * SIPB services and projects list: http://stuff.mit.edu/sipb/project-list.html
+
+=== License ===
+
+Unless specified otherwise, all documentation on this wiki will be available under a dual license of
+
+ * the Creative Commons Attribution-Share Alike license, and
+ * the GNU Free Documentation License, with no Invariant Sections, no
+   Front-Cover Texts, and no Back-Cover-Texts.
+
+As recommended by the [http://stuff.mit.edu/afs/sipb/admin/text/policy/documentation_licensing.txt SIPB Documentation Licensing Recommendation]