# Overview of All CCRMA Documentation

In CCRMA's decades of history there have been many efforts towards
documenting our facilities on the [Internet][www] (and almost none to
decommission out-of-date information).

[www]: https://en.wikipedia.org/wiki/World_Wide_Web

Here are some of these layers of documentation, roughly in order from
newest to oldest (though in fact their histories overlap, especially
the wiki).


September 2019: A **new documentation** system by Matt Wright based on
[Markdown][markdown]. You might enter this via the [top level
index](https://ccrma.stanford.edu/docs), the [global table of
contents][toc], the [list of rooms at CCRMA][rooms], or perhaps the
page about [CCRMA user accounts][user accounts].  This overview page
is part of the 2019 system; you can look at the
[overview.md](overview.md) file if you like (and in general replace
`html` with `md` to see any page's source).  The [README](README.html)
explains the (quite simple) implementation.

[markdown]:https://en.wikipedia.org/wiki/Markdown
[toc]:https://ccrma.stanford.edu/docs/toc.html
[rooms]:https://ccrma.stanford.edu/docs/rooms.html
[user accounts]: https://ccrma.stanford.edu/docs/system/CCRMA-user-account.html

    
**CCRMA Wiki**: Community-contributed info on a wide variety of topics
including the [Colloquium
Series](https://ccrma.stanford.edu/wiki/Colloquium), Studios, 220a and
220b, SLOrk, 250a and many MaxLab-related topics, specific
compositions and performances, programming language and related
technologies, the [snd](https://ccrma.stanford.edu/wiki/Snd) sound
editor, at least one [220c student
project](https://ccrma.stanford.edu/wiki/Evolving_live_performance_setup),
and even the [CCRMA PhD students' system for allocating desk
space][desk allocation]. You can browse the alphabetical [list of all
CCRMA wiki pages][allwikipages].  The wiki has
[categories][categories] including [CCRMA User Guide][user guide
wiki], whose content area substantially and confusingly overlaps with
the non-wiki "guides" below. The wiki contains a mixture of current
and outdated information; the bottom of each wiki page tells you "This
page was last modified on" a certain date.

[desk allocation]: https://ccrma.stanford.edu/wiki/Desk_Allocation_at_CCRMA
[user guide wiki]: https://ccrma.stanford.edu/wiki/Category:CCRMA_User_Guide
[allwikipages]: https://ccrma.stanford.edu/wiki/Special:AllPages
[categories]:https://ccrma.stanford.edu/wiki/Special:Categories


**[CCRMA User Guides](https://ccrma.stanford.edu/guides/index.html)**
are a portion of the current [Drupal](https://www.drupal.org) website
intended to convey useful information about CCRMA's facilities.  These
are eventually planned to be absorbed into the new Markdown-based
system.  The [Room Guides](https://ccrma.stanford.edu/room-guides)
currently contain a mixture of current and outdated information; Matt
Wright refreshed all of the other guides ([Booking
Events](https://ccrma.stanford.edu/booking-events), [System
Guides](https://ccrma.stanford.edu/system-guides), and [Common
Areas](https://ccrma.stanford.edu/guide-common-areas)) in 2018 to
bring them up to date.


**Old CCRMA Guides** from before the Drupal website, implemented in
raw html (or perhaps LaTeX-to-html), located at
`/usr/ccrma/web/html/guides`.  These pages were created between 1997
and 2015 but almost none of these have been updated since 2008.
Perhaps the best of these is Juan Reyes' [Planet CCRMA Linux Survival
Guide][survival guide], full of great and almost entirely still-true
information about doing everything on Linux.  These often have author
and copyright date at the bottom.

[survival guide]: https://ccrma.stanford.edu/guides/planetccrma