Livedoc

From Livedoc - The Documentation Repository
Jump to: navigation, search

About Livedoc

Livedoc is an online repository of documentation for the TJHSST Computer Systems Lab, originally set up on November 2, 2005 by Dan Tran. All aspects of the lab should be throughly documented here in order to aid in the administration of the lab by the Student Systems Administrators and to keep a generally accurate history of the lab itself.

What Livedoc should be

  • Livedoc should detail CSL specific documentation such as the lab's hardware, the configuration of services, the "big picture" of how everything goes together, etc. Livedoc is central location where all of this information should be recorded for current future sysadmins alike.
  • Livedoc can be thought of as The Book version 2.0. The main problem with the old book is that it was a clumsy way to record information that changed on a regular basis. Livedoc hopes to fix this by making it easily editable and readable in addition to being efficiently structured.

What articles should contain

Articles should mostly focus on the details of a particular topic (e.g. a special startup sequence, what the switches mean, how the blue lights are wired, etc.), although they can also touch upon a bit of history (e.g. the Cray was brought in what year? why? etc). Articles can also contain more general knowledge, but it should be applicable to the lab.

Editing guidelines

One of the reasons livedoc was created was to keep documentation in a standardized structure. Please read the editing guidelines before writing or editing articles.