Middlebury

Difference between revisions of "Wiki Purpose and Content"

(added point about applying tags/categories)
Line 1: Line 1:
 
= LIS Wiki Purpose and Content:  =
 
= LIS Wiki Purpose and Content:  =
 
=== General discussion page to promote dialogue on the LIS Wiki Purpose and its Content  ===
 
  
 
==== Q. What is the purpose of the LIS Wiki?  ====
 
==== Q. What is the purpose of the LIS Wiki?  ====
  
A. From Wiki: “The LIS Wiki contains documentation and project updates from across LIS”. The purpose is to have a single repository for publicly accessible LIS documentation. Users only have to become familiar with one platform for finding answers. In addition, the Wiki can provide space for internal (private) documentation, which is more easily searchable by LIS staff than a proliferation of documents in scattered folders on servers.  
+
A. From Wiki: “The LIS Wiki contains documentation and project updates from across LIS”. The purpose is to have a single repository for publicly accessible LIS documentation. Users only have to become familiar with one platform for finding answers. In addition, the Wiki can provide space for internal (private) documentation, which is more easily searchable by LIS staff than a proliferation of documents in scattered folders on servers.
  
From the original LIS Website team [https://mediawiki.middlebury.edu/wiki/LIS/LIS_Website_Recommendations Recommendations] (pre-web redo): A wiki that holds the technical and procedural documentation maintained by LIS staff, chiefly the Helpdesk and Telephone Services documentation.  
+
From the original LIS Website team [https://mediawiki.middlebury.edu/wiki/LIS/LIS_Website_Recommendations Recommendations] (pre-web redo): A wiki that holds the technical and procedural documentation maintained by LIS staff, chiefly the Helpdesk and Telephone Services documentation.
  
 
==== Q. What goes in the LIS Wiki?  ====
 
==== Q. What goes in the LIS Wiki?  ====
  
A.  
+
A.
  
*Documentation for users about how to use the systems and services we support  
+
*Documentation for users about how to use the systems and services we support
*Local/internal documentation on procedures and policies  
+
*Local/internal documentation on procedures and policies
 
*User information that would take up too much real-estate on a Drupal page (e.g., Borrowing, Helpdesk)<br>
 
*User information that would take up too much real-estate on a Drupal page (e.g., Borrowing, Helpdesk)<br>
  
 
==== Guidelines for consistency:  ====
 
==== Guidelines for consistency:  ====
  
*Keep pages short  
+
*Keep pages short
*Create TOC (if page is NOT short) by making section headings (4 or more = TOC)<br>  
+
*Create TOC (if page is NOT short) by making section headings (4 or more = TOC)<br>
 
*Assign tags/categories to each page. &nbsp;Check for relevant tags/categories before creating a new one.
 
*Assign tags/categories to each page. &nbsp;Check for relevant tags/categories before creating a new one.
  
 
==== Problems that can point to above:  ====
 
==== Problems that can point to above:  ====
  
*Poor relevancy of search results  
+
*Poor relevancy of search results
*Duplication of content  
+
*Duplication of content
*Lack of consistent tags/categories  
+
*Lack of consistent tags/categories
 
*Lack of guidelines for creation and maintenance of content<br>
 
*Lack of guidelines for creation and maintenance of content<br>
  
Line 34: Line 32:
 
''[Web Team: maybe omit this section? I believe I added to the Basecamp documentation, which originally mentioned 'education' -- Perhaps add&nbsp; something like "for quick help, see ''[[Help:Editing|''this guide'']]''." -- RJ]''
 
''[Web Team: maybe omit this section? I believe I added to the Basecamp documentation, which originally mentioned 'education' -- Perhaps add&nbsp; something like "for quick help, see ''[[Help:Editing|''this guide'']]''." -- RJ]''
  
*Layout  
+
*Layout
*Linking  
+
*Linking
*Images  
+
*Images
 
*Color, fonts, etc.<br>
 
*Color, fonts, etc.<br>
  
[[Category:Wiki]] [[Category:Wiki_Purpose]] [[Category:Wiki_Content]]
+
[[Category:Wiki]]
 +
[[Category:Wiki Purpose]]
 +
[[Category:Wiki Content]]

Revision as of 10:08, 3 May 2011

LIS Wiki Purpose and Content:

Q. What is the purpose of the LIS Wiki?

A. From Wiki: “The LIS Wiki contains documentation and project updates from across LIS”. The purpose is to have a single repository for publicly accessible LIS documentation. Users only have to become familiar with one platform for finding answers. In addition, the Wiki can provide space for internal (private) documentation, which is more easily searchable by LIS staff than a proliferation of documents in scattered folders on servers.

From the original LIS Website team Recommendations (pre-web redo): A wiki that holds the technical and procedural documentation maintained by LIS staff, chiefly the Helpdesk and Telephone Services documentation.

Q. What goes in the LIS Wiki?

A.

  • Documentation for users about how to use the systems and services we support
  • Local/internal documentation on procedures and policies
  • User information that would take up too much real-estate on a Drupal page (e.g., Borrowing, Helpdesk)

Guidelines for consistency:

  • Keep pages short
  • Create TOC (if page is NOT short) by making section headings (4 or more = TOC)
  • Assign tags/categories to each page.  Check for relevant tags/categories before creating a new one.

Problems that can point to above:

  • Poor relevancy of search results
  • Duplication of content
  • Lack of consistent tags/categories
  • Lack of guidelines for creation and maintenance of content

Advanced training — beyond the basics:

[Web Team: maybe omit this section? I believe I added to the Basecamp documentation, which originally mentioned 'education' -- Perhaps add  something like "for quick help, see this guide." -- RJ]

  • Layout
  • Linking
  • Images
  • Color, fonts, etc.
Powered by MediaWiki