Separate ideas and existing topics.
[wiki.git] / doc / WikiStart
index d0d4ed2325b63fb99fbef93e04f6d8d33deb032f..b0d7629fe179e3dbb4520ff653c152c74fa9ef5b 100644 (file)
@@ -1,15 +1,29 @@
 = 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.
 
-== Documentation Ideas ==
+See '''LennyBugs''' for bugs to take on in the Lenny
+'''RC-bug-squashing hackathon''' of '''December 13, 2008'''.
+
+== Documentation Topics ==
 
-This is a list of topics that need documentation in one form or another or that are good for explaining to prospectives.
+ * 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.
 
- * UsingZephyr -- [http://barnowl.mit.edu/wiki/GettingStarted] is a good start, but could use text on screen and tickets, among other things
- * 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)
+== 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
@@ -17,10 +31,9 @@ This is a list of topics that need documentation in one form or another or that
    * printing from non-Athena: CupsOnMac
    * `-i printadm` (maybe)
 
- * [wiki:XVM] -- using `remctl`, getting the serial console (maybe should go on XVM wiki, but it's also trac so easy to move)
-
  * 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
 
@@ -32,6 +45,7 @@ This is a list of topics that need documentation in one form or another or that
 
  * WikiFormatting -- Documentation on trac's Wiki formatting language
  * 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 ===
 
@@ -41,4 +55,4 @@ Unless specified otherwise, all documentation on this wiki will be available und
  * 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]
\ No newline at end of file
+As recommended by the [http://stuff.mit.edu/afs/sipb/admin/text/policy/documentation_licensing.txt SIPB Documentation Licensing Recommendation]