Differences
This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
best_practices_for_managing_this_wiki [2009/05/12 20:37] cturner |
best_practices_for_managing_this_wiki [2019/01/07 17:20] (current) |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Best Practices for Managing This Wiki ====== | ====== Best Practices for Managing This Wiki ====== | ||
| - | Topics on this page address common practices, or standards, for creating, editing and managing content on the Acquisitions, Cataloging & Processing Staff Wiki. Applying these conventions will create a more friendly environment for wiki users. In addition to what's covered here, the [[http://webman.library.umass.edu/doku.php?id=bestpractices|Best Practice Guidelines for Web Content Creation]] is a useful and relevant document. | + | Topics on this page address common practices, or standards, for creating, editing and managing content on the Information Resources Management Staff Wiki. Applying these conventions will create a more friendly environment for wiki users. In addition to what's covered here, the UMass Libraries Web Coordinating Committee [[http://webman.library.umass.edu/doku.php?id=bestpractices|Best Practice Guidelines for Web Content Creation]] is a useful and relevant document. |
| ===== Creating new pages ===== | ===== Creating new pages ===== | ||
| Line 23: | Line 23: | ||
| When you save a new page, it will automatically appear within the alphabetical list in the Index column to the left of the [[Start]] page. Depending on the subject of the page, you will need to add the filename (page title) to the Start page within the appropriate functional area(s). It may be listed in more than one place, as appropriate. To create a link to a new file on the start page: Go to the start page, click on edit this page, add the page title within double brackets. | When you save a new page, it will automatically appear within the alphabetical list in the Index column to the left of the [[Start]] page. Depending on the subject of the page, you will need to add the filename (page title) to the Start page within the appropriate functional area(s). It may be listed in more than one place, as appropriate. To create a link to a new file on the start page: Go to the start page, click on edit this page, add the page title within double brackets. | ||
| - | ===== Documenting workflows that span across more than one unit ===== | + | ===== Reviewing a page draft ===== |
| - | + | After you've written a new page, solicit feedback from your colleagues about its clarity, accuracy and comprehensiveness. It's difficult to transfer a process you know well from your head to writing, and something that might be crystal clear to you might be confusing to others. Try to consider others needs for the documentation and incorporate it in the text and/or formatting. | |
| - | A job that involves multiple units should be documented in one file and linked from multiple departmental areas of the home page. Furthermore, headings should be used to designate different parts and areas of responsibility, thus generating the file’s Table of Contents and navigation links. For a good example of this, please see the [[Serials New Titles]] file which covers steps taken in several units to add a new serial title to our collections. This will make it easier for staff to understand the entire workflow rather than just their own narrow function in the workflow. Knowing who else is involved in the workflow and what their responsibilities in the workflow are can often be helpful. | + | |
| ===== Signing up for email notifications about changes made to wiki pages ===== | ===== Signing up for email notifications about changes made to wiki pages ===== | ||
