Convert most http: links to https:
[wiki.git] / doc / project.mdwn
index d2d57b2322f504fce6163f31f1f6589fb65847a8..5f09e5b35c4ee89f70969ba282485dd433279424 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.
 
 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](https://www.mit.edu/~asksipb/) column in The Tech, an array of [IAP classes](https://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
 
 
 ## 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`
 
  * "Printing at MIT"
    * `lpq`, `lprm`, `queues.mit.edu`
@@ -38,29 +22,12 @@ or another or that are good for explaining to prospectives.
 
  * "Using Debathena" -- You've installed Debathena -- now what?  Automounter, `blanche`, cups; using stuff in the GUI.
  * "Athena Dotfiles" -- These are weird and nonstandard compared to traditional UNIX and should be documented, including things like `.environment`
 
  * "Using Debathena" -- You've installed Debathena -- now what?  Automounter, `blanche`, cups; using stuff in the GUI.
  * "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:
+   * There's some documentation at [https://web.mit.edu/olh/Dotfiles/]
 
 
- * "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](https://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
 
 
  * 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