Warning Livedoc is no longer being updated and will be deprecated shortly. Please refer to https://documentation.tjhsst.edu.

Difference between revisions of "Livedoc"

From Livedoc - The Documentation Repository
Jump to: navigation, search
m (Change LiveDoc to Livedoc)
m (Editing guidelines: categorize)
 
(2 intermediate revisions by one other user not shown)
Line 1: Line 1:
 
== About Livedoc ==
 
== About Livedoc ==
'''Livedoc''' is an online repository of documentation for the TJHSST Computer Systems Lab. All aspects of the lab should be throughly documented here in order to aid in the administration of the lab by the [[student system administrators]] and to keep a generally accurate history of the lab itself.
+
'''Livedoc''' is an online repository of documentation for the TJHSST Computer Systems Lab, originally set up on November 2, 2005 by [[User:Dan Tran|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==
 
==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 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.
+
*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===
 
===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 SV1 Supercomputer|Cray]] was brought in what year? why? etc). Other articles, particular those under the [[Index:Technologies|technologies]] category can contain more general knowledge that is applicable to the lab.
+
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 SV1 Supercomputer|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===
 
===Editing guidelines===
 
One of the reasons livedoc was created was to keep documentation in a standardized structure. Please read the [[Help:Editing|editing guidelines]] before writing or editing articles.
 
One of the reasons livedoc was created was to keep documentation in a standardized structure. Please read the [[Help:Editing|editing guidelines]] before writing or editing articles.
 +
[[Category:To Update]]

Latest revision as of 23:25, 26 February 2016

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.