]> sipb.mit.edu Git - wiki.git/blobdiff - doc/project.mdwn
Fix some broken links
[wiki.git] / doc / project.mdwn
index d2d57b2322f504fce6163f31f1f6589fb65847a8..914c0449f2a6d2fa9da39700c783947e0e4eb3c7 100644 (file)
@@ -5,32 +5,16 @@ form the collective knowledge that SIPB members take for granted or
 use in maintaining services and projects that are not otherwise
 written down anywhere.
 
-See [doc/project-ideas] for stuff to try doing to further the goals of
-the SIPB.
+See [[SIPB Documentation|/doc]] for documentation produced so far.
+Existing documentation can always be improved.
 
-<!-- See LennyBugs and LennyBugsAll for the bugs we took on in the Lenny
-RC-bug-squashing hackathon of December 13, 2008. -->
+Other SIPB educational activites include the [AskSIPB](http://www.mit.edu/~asksipb/) column in The Tech, an array of [IAP classes](http://sipb.mit.edu/iap/), and the weekly [Cluedumps](http://cluedumps.mit.edu/) series each fall.
 
-## Documentation Topics
-
- * [doc/Zephyr] -- An attempt at a complete beginner's guide to getting
-   on Zephyr with BarnOwl and [doc/screen].
-  * BarnOwl has some more documentation on [its wiki](http://barnowl.mit.edu/).
- * [doc/AFS-and-you] -- an attempt at a beginner's guide to working with AFS for Athena and Web 
- * [doc/screen] -- Handy for [doc/Zephyr] and anything else you do in an ssh session.
- * XVM:
-  * [using `remctl`](https://xvm.mit.edu/trac/wiki/Remctl)
-  * [getting the serial console](https://xvm.mit.edu/trac/wiki/SerialConsole)
- * printing: [doc/quickprint], [doc/cups-on-mac]
- * [doc/kerberized-server] explains keytabs and how to get one and how that lets you SSH somewhere with Kerberos.
- * [doc/root-instance] explains root and extra instances in Kerberos.
- * [doc/summer-reading] -- Documents or books that various SIPB members recommend reading.
- * [doc/Debianization] -- packaging software for Debian and Ubuntu
 
 ## Documentation Ideas
 
-This is a list of further topics that need documentation in one form
-or another or that are good for explaining to prospectives.
+This is a partial list of further topics that need documentation.
+Additions welcome.
 
  * "Printing at MIT"
    * `lpq`, `lprm`, `queues.mit.edu`
@@ -40,27 +24,10 @@ or another or that are good for explaining to prospectives.
  * "Athena Dotfiles" -- 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/]
 
- * scripts.mit.edu -- lots of neat internals to explain
-
- * AFS: 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.
-
- Setting up servers:
-
- * "Client Certs" should explain, if for some perverse reason you don't
-   want to use scripts.mit.edu :-), how to set up client cert
-   authentication on your own machine (grab the CA out of the
-   apache-ssl locker, submit a CSR to mitcert@, set up scripts' magic
-   Apache modules to make your life easier)
+ * scripts.mit.edu -- lots of neat internals to explain; the scripts.mit.edu bugtracker also includes some identified [documentation tasks](http://scripts.mit.edu/trac/query?status=assigned&status=new&status=reopened&keywords=~docs&group=component&col=id&col=summary&col=status&col=owner&col=type&col=priority&col=milestone&col=keywords&order=priority)
 
  * Add your own here!
 
 ## Useful Links
 
- * [ikiwiki/Formatting] -- Documentation on this wiki's formatting language
- * SIPB's [Inessential Guides](http://stuff.mit.edu/sipb/docs.html). A
-   previous generation of SIPB documentation. Much of it is dated, but some
-   still contains useful knowledge that should be updated or moved here.
- * [SIPB services and projects list](http://stuff.mit.edu/sipb/project-list.html)
+ * [[ikiwiki/Formatting]] -- Documentation on this wiki's formatting language