Now you go to the SIPB door's website when you click on the door. [jogama@]
[wiki.git] / doc.mdwn
index 1b8cf165b1721e7b629cd49cf6947ced3205ea1c..ad40d4dc33327d620e1b232148b5dc677e214b8a 100644 (file)
--- a/doc.mdwn
+++ b/doc.mdwn
@@ -4,7 +4,6 @@ SIPB offers documentation for users at MIT and elsewhere.
 
 Writing and editing this documentation is an [[ongoing project|doc/project]].  Edits and other contributions welcome.
 
-
 ## Recent Documentation
 
 ### SIPB
@@ -18,10 +17,16 @@ Modeled on the [6.033 hands-on assignments], these guides will walk you through
 * [[Summer Reading|doc/summer-reading]] <br />
 Documents and books that various SIPB members recommend reading.
 
+* [[Moira|doc/moira]] <br />
+Some tips for using Moira
+
 ### Zephyr
 
 * [[Using Zephyr|doc/zephyr]] <br />
-A guide on using Zephyr today with BarnOwl (and GNU Screen). Aimed at newcomers to Zephyr, and a pretty good reference.  See also [the Barnowl wiki](http://barnowl.mit.edu/).
+A guide on using Zephyr today with BarnOwl (and GNU Screen). Aimed at newcomers to Zephyr, and a pretty good reference.  See also [the BarnOwl wiki](http://barnowl.mit.edu/).
+
+* [[Using `zcrypt`|doc/zcrypt]] <br />
+A guide to using `zcrypt`ed (encrypted) zephyr classes. Zephyr at MIT (mostly) doesn't support limiting who can sub to a zephyr class, so if you want to have reasonably private conversations, encrypting them is a good idea.
 
 * [[Using SZS (the SMS to Zephyr Relay)|doc/szs]] <br />
 Send and receive text messages through Zephyr.
@@ -47,10 +52,12 @@ A useful guide to AFS (originally the Andrew File System), the system that store
 Recent versions of Google Chrome and Chromium should mostly work without surprises. This documentation is primarily for Linux users.
 
 * [[Configuring Client-Side Certificate Authentication on Apache|doc/apache-client-certs]] <br />
-How to configure your own server to accept client-side certificates just like [scripts.mit.edu](http://scripts.mit.edu)
+How to configure your own server to accept client-side certificates just like [scripts.mit.edu](https://scripts.mit.edu/)
 
 ### Miscellaneous
 
+* [scripts.mit.edu](https://scripts.mit.edu/): [user documentation](https://scripts.mit.edu/faq), [internals wiki](https://scripts.mit.edu/wiki/)
+
 * XVM: [Using `remctl`](https://xvm.mit.edu/trac/wiki/Remctl), and
  [Getting the serial console](https://xvm.mit.edu/trac/wiki/SerialConsole)
 
@@ -62,26 +69,17 @@ How to set up printing on a Mac.
 * [[Using CPAN|doc/cpan]] <br />
 CPAN is a source of many useful Perl libraries, but the tools often seem determined not to let you have them. Here's how to beat them into submission.
 
+* [[Writing safe(r) shell scripts|doc/safe-shell]]
+
 ## IAP Classes and Cluedumps
 
 SIPB teaches [an array of classes](http://sipb.mit.edu/iap) each IAP and shorter [cluedumps](http://cluedumps.mit.edu/) in the fall.
 Some of them leave notes useful as documentation.
 
-* [Java Class Notes](http://stuff.mit.edu/afs/sipb/project/iap/Archive/1999/java/outline.html) <br />
-These are the electronic slides that were used in SIPB's popular Java class.
-
 * [Understanding Git](http://web.mit.edu/cluedumps/slides/understanding-git-2008.pdf) <br />
 These slides were developed for a SIPB cluedump on the Git version control system.
 
 
-## Documentation in progress
-
-See the [[SIPB Documentation Project|doc/project]] page for more documentation ideas.
-
-* [[doc/Debianization]] <br />
-How to package software for Debian and Ubuntu.  Popular topic in SIPB projects thanks to [Debathena](http://debathena.mit.edu/) and [XVM](http://xvm.mit.edu).
-
-
 ## The Inessential Guide Series
 The SIPB Inessential Guide series contain useful information about a variety of computing topics. Explore!
 
@@ -101,7 +99,7 @@ A very helpful guide to LaTeX, a typesetting program commonly used for doing PSe
 A guide to using MATLAB on Athena.
 
 * [Inessential Zephyr](http://stuff.mit.edu/afs/sipb/project/doc/izephyr/html/izephyr.html) ([DVI](http://stuff.mit.edu/afs/sipb/project/doc/izephyr/izephyr.dvi))([PDF](http://stuff.mit.edu/afs/sipb/project/doc/izephyr/izephyr.pdf)) <br />
-A guide to using the Athena instant-messenging system, Zephyr. Less relevant now that most people use Barnowl, try [this](http://sipb-www.scripts.mit.edu/doc/wiki/UsingZephyr) instead
+A guide to using the Athena instant-messenging system, Zephyr. Less relevant now that most people use BarnOwl, try [this](http://sipb-www.scripts.mit.edu/doc/wiki/UsingZephyr) instead
 
 * [Inessential Bitmaps](http://stuff.mit.edu/afs/sipb.mit.edu/project/doc/ibitmap/ibitmap.html) ([DVI](http://stuff.mit.edu/afs/sipb/project/doc/current/ibitmap.dvi)) <br />
 A guide to drawing and displaying XBM bitmaps and other graphics.
@@ -115,7 +113,7 @@ A guide on how to restock a soda fridge. It isn't as hard as you make it look.
 * [How to Choose a Good Password](http://stuff.mit.edu/afs/sipb/project/doc/passwords/passwords.html) ([DVI](http://stuff.mit.edu/afs/sipb/project/doc/current/passwords.dvi)) <br />
 A one-page list of guidelines on how to choose secure passwords, and why this is important.
 
-* [[Who Fixes What at MIT|doc/who-fixes-what]] <br />
+* [Who Fixes What at MIT](http://stuff.mit.edu/afs/athena.mit.edu/system/info/who_fixes_what) <br />
 How and to whom to report all kinds of problems with computing infrastructure at MIT.
 
 * [Filtering Your E-Mail on Athena](http://www.mit.edu/afs/sipb/project/doc/imailfilters/imailfilters.html) <br />
@@ -139,7 +137,7 @@ Pointers to resources from which Git, the Version Control System many of us use.
 
 ## Licensing
 
-While we love free and open source software, there are [http://www.opensource.org/proliferation](too many licenses) and the options can get a bit confusing. SIPB has some official recommendations for what to use and how to effect these licenses.
+While we love free and open source software, there are [too many licenses](http://www.opensource.org/proliferation) and the options can get a bit confusing. SIPB has some official recommendations for what to use and how to effect these licenses.
 
 * [[Code Licensing Recommendation|doc/code-licensing]]