link to Ask SIPB
[wiki.git] / documentation.mdwn
index 7334c0762259bdd0a0425247caca9650627e63ff..10b8a04c744619982b5b886169c2c739a71a603c 100644 (file)
@@ -1,4 +1,4 @@
-# SIPB Documentation
+[[!meta title="SIPB Documentation"]]
 
 The Student Information Processing Board is devoted to helping the MIT community utilize the Institute's computer facilities with ease and efficiency. Since we know how dry and badly written the average user's manual is, we write and maintain many documents on our own. This documentation is freely provided to users in the form of online and printed manuals, UNIX man pages, and emacs info files, in addition to the documentation available in our office. The source for almost all of this documentation is available online under the directory /afs/sipb.mit.edu/project/doc, and is redistributable under certain conditions; all these documents are copyright by the SIPB. Although the following guides are mainly of use to Athena users, SIPB documents are known to be used at universities other than MIT. Hardcopies of these documents are available for free in the SIPB Office, W20-557, and online versions are also available via Athena's online "help" facility, by selecting the main-menu item "Documentation Archives". 
 
@@ -12,7 +12,7 @@ A large guide on how to get the most out of your Athena account, from reading ma
 A one-page reference to the most basic information about Athena, including logging in, reading email, and getting help.
 
 * [Inessential AFS](http://stuff.mit.edu/afs/sipb.mit.edu/project/doc/afs/html/afs-new.html) ([DVI](http://stuff.mit.edu/afs/sipb/project/doc/current/iAFS.dvi))([PDF](http://stuff.mit.edu/afs/sipb/project/doc/current/iAFS.pdf))([PS](http://stuff.mit.edu/afs/sipb/project/doc/current/iAFS.ps))
-A guide to AFS (Andrew File System) - the system used to store your files on Athena.
+A guide to AFS (Andrew File System) - the system used to store your files on Athena. Note that a more updated version of this guide can be found [here](http://sipb.mit.edu/doc/wiki/AFSAndYou).
 
 * [Inessential LaTeX (PDF)](http://stuff.mit.edu/sipb/ilatex) ([DVI](http://stuff.mit.edu/afs/sipb/project/doc/current/iLaTeX.dvi)) ([HTML, but somewhat dated](http://stuff.mit.edu/afs/sipb.mit.edu/project/www/latex/guide/guide.html))  <br />
 A very helpful guide to LaTeX, a typesetting program commonly used for doing PSets, writing papers, theses, books, etc.
@@ -21,15 +21,21 @@ 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.
+A guide to using the Athena instant-messenging system, Zephyr. Less relevant now that most people use Barnowl, try [this](http://sipb/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.
 
-* Inessential Refrigerator Restocking (Internal DVI version - inqui9re at SIPB) <br />
+* Inessential Refrigerator Restocking (Internal DVI version - inquire at SIPB) <br />
 A guide on how to restock a soda fridge. It isn't as hard as you make it look.
 
-##  Other Useful Guides
+##  More Useful Guides
+
+* [Using Zephyr](http://sipb/doc/wiki/UsingZephyr) <br />
+A guide on using Zephyr today with BarnOwl (and GNU Screen). Aimed at newcomers to Zephyr, but also a pretty good reference, this is much more relevant to the average user than Inessential Zephyr above.
+
+* [AFS and You](http://sipb.mit.edu/doc/wiki/AFSAndYou) <br />
+A useful guide to AFS (originally the Andrew File System), the system that stores your Athena files. Targeted at mid-to-advanced users, this is a more up-to-date version than the Inessential Guide to AFS above.
 
 * [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.
@@ -40,8 +46,8 @@ A quick guide to filtering your e-mail on Athena's common email-clients.
 * [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.
 
-* [Getting Started with PHP on Athena](http://stuff.mit.edu/afs/sipb/project/doc/pgp/pgp.html) <br />
-A quick guide to using PHP security on Athena.
+* [Getting Started with PGP on Athena](http://stuff.mit.edu/afs/sipb/project/doc/pgp/pgp.html) <br />
+A quick guide to using PGP security on Athena.
 
 * [DVI files? What are those? What's XDVI?](http://stuff.mit.edu/afs/sipb/project/www/latex/xdvi/xdvi.html) ([DVI](http://stuff.mit.edu/afs/sipb/project/doc/current/xdvi.dvi)) <br />
 XDVI is a program to view DVI files, a common output format from LaTeX.