Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
best_practices_for_managing_this_wiki [2009/02/02 14:07]
mbanach
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 =====
 +Before you create a new page, review existing pages on the wiki to look for the same or related content. Browse the index or body of the Start page, and do a search for terms that describe the subjects in your new page. If your documentation might be integrated into an existing page, discuss the possibilities with its primary contact. If the workflow or procedure you are describing is related to another one, link to it. Our goal is to provide a streamlined set of documents without redundancy. This also relates to [[http://​wws.library.umass.edu/​wikis/​acp/​doku.php?​id=best_practices_for_managing_this_wiki#​documenting_workflows_that_span_across_more_than_one_unit|Documenting Workflows that Span Across More Than One Unit]].
 ===== Naming new pages ===== ===== Naming new pages =====
 When you create a new page, type the shortest, most descriptive and sensible title possible. Start with a word that is essential to what the file is about, e.g. "​serials"​ or "​monographs",​ rather than its type, e.g. "​workflow"​ or "​procedure"​. Give this some thought before you actually create the file. Make it plain English. It's easier to choose a good name at the outset than it is to delete a file and create a new one with a better name.  When you create a new page, type the shortest, most descriptive and sensible title possible. Start with a word that is essential to what the file is about, e.g. "​serials"​ or "​monographs",​ rather than its type, e.g. "​workflow"​ or "​procedure"​. Give this some thought before you actually create the file. Make it plain English. It's easier to choose a good name at the outset than it is to delete a file and create a new one with a better name. 
Line 21: 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.
  
 +===== 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.
  
 +===== Signing up for email notifications about changes made to wiki pages =====
 +
 +Everyone should subscribe to page changes for pages you are responsible for as the primary contact. ​ Everyone should also subscribe to page changes for pages with instructions you use to do your work.  By subscribing to page changes on a particular wiki page, you will receive an email each time the page is changed or updated.  ​
 +
 +To subscribe to page changes follow these instructions:​
 +
 +After you've logged in with your user account, go to the page you wish to monitor. At the bottom of the page, select "​Subscribe Page Changes"​. This will trigger an email sent to your account whenever someone saves a change to that particular page. 
 +
 +Once you've subscribed to receive a change notification,​ the link at the bottom of the page will change to "​Unsubscribe Page Changes"​. If you want to cease notifications,​ select this option.
 +
 +
 + --- //​[[cturner@library.umass.edu|Primary contact: Christine Turner]]//
  
best_practices_for_managing_this_wiki.1233583633.txt.gz · Last modified: 2019/01/07 17:20 (external edit)
[unknown link type]Back to top
www.chimeric.de Creative Commons License Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0