User Tools

Site Tools


webteam:draft_guidelines

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
webteam:draft_guidelines [2011/03/22 15:34]
aatre
webteam:draft_guidelines [2012/11/21 07:03] (current)
paxed MeeGo -> Evergreen
Line 1: Line 1:
 ====== Draft Wiki Guidelines ====== ====== Draft Wiki Guidelines ======
 +
 +Evergreen has [[http://​docs.evergreen-ils.org/​|formal documentation]] maintained by the community'​s [[evergreen-docs:​dig|Documentation Interest Group]] but there is also a large body of information contributed by the community as a whole located on the [[http://​www.evergreen-ils.org/​dokuwiki/​|Evergreen wiki]]. ​ (A wiki is a special kind of website that makes it easy for everyone to easily add and improve web pages -- [[http://​simple.wikipedia.org/​wiki/​Wiki|learn more]].) ​ Contributing articles, guides, or tutorials to the wiki -- or improving articles that others have already contributed -- is a very helpful way to participate in the Evergreen community.
 +
 +Creating articles in the wiki is a collaborative process. After you have written your article others may
 +
 +  * Edit
 +  * Alter
 +  * Adapt
 +  * Add
 +
 +So don't worry about making your article perfect the first time through. Don't hesitate to add content you think is useful and don't hesitate to make edits where you think you can help. There'​s always somebody to fix anything that breaks.
 +
 +===== Get an account! =====
 +
 +To get a DokuWiki account send a request to <​docs@evergreen-ils.org>​.
 +
 +===== Posting Guidelines =====
 +
 +Here are a few guidelines to keep in mind when using the Evergreen wiki:
 +  * '''​Search first''':​ Before creating a new page or making significant contributions to a page, please do a quick search to make sure that you aren't duplicating existing content on the wiki or other areas of evergreen-ils.org.
 +  * '''​Contribute''':​ The wiki is a resource for anyone to use. Just keep the content relevant, that is anything related to Evergreen as long as it meets our other guidelines should be appropriate.
 +  * '''​Make improvements''':​ If you find a typo or inaccurate information,​ just fix it.
 +  * '''​Keep it legal''':​ respect licenses and copyright. Only post content you own or provide attribution for content under a license that permits reuse.
 +  * '''​Be nice''':​ Keep the language clean (no swearing) and show respect for other contributors.
 +  * '''​Respect links''':​ Please provide [[http://​www.mediawiki.org/​wiki/​Help:​Redirects|redirects]] when you move content. Many people use the wiki and may have created bookmarks or linked to your content.
 +
 +===== The Wiki is Public =====
 +
 +Everything in the wiki is public.
 +
 +Every edit and every new page created goes into the [[http://​evergreen-ils.org/​dokuwiki/​doku.php?​do=recent|recent changes]] feed, which means that people will see your edits even if you haven'​t yet linked to a page.
 +
 +Once it's out there, it's public. ​
 +  * Technically,​ administrators can delete things, but the wiki content may be mirrored, has feeds and is in the Google cache, so deleting something doesn'​t make it go away.
 +  * When you delete content from a page, the original content will still remain in the history for that page.
 +
 +When you contribute content to the wiki (or edit existing content), there is a small notice that appears on the page stating:
 +
 +//By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 3.0 Unported//
 +
 +Since the wiki is a community effort, all contributions must be "​licensed"​ to the community as a whole. ​ [[http://​creativecommons.org/​licenses/​by-sa/​3.0/​|Learn more about the "​Creative Commons BY-SA 3.0 license"​ here]].
 +===== Using the Wiki (How-to) =====
 +
 +=== Where to start ===
 +
 +Before creating a new page, you should first make sure that a page on your topic does not already exist:
 +
 +  - In the search box in the upper right corner, enter your topic.
 +  - If the exact topic exists, the page will open.
 +  - If there are related pages, you will get a search results page. Check if your topic is in the results.
 +  - If your topic does not exist, choose '''​create this page'''​.
 +
 +=== How to edit a page ===
 +
 +If you'd like to change a page.
 +
 +  - Make sure that you are logged in to [http://​www.evergreen-ils.org evergreen-ils.org] ​
 +  - Click the '''​Edit'''​ link in the right column.
 +  - Enter your changes in the box.
 +  - In the '''​Summary'''​ box, enter a short explanation of what you did.
 +  - Click '''​Show preview'''​ if you want to check your changes.
 +  - Click '''​Save page'''​.
 +
 +Deleting pages:
 +  * Pages can only be deleted by wiki admins. ​
 +  * Before you request a deletion, think about whether a redirect would be more appropriate.
 +  * Place pages that you would like deleted in the "​[[:​Category:​Die die die|Die die die]]" category by adding this line to the page to be deleted: ''<​nowiki>​{{delete}}</​nowiki>''​
 +    * You can also specify the reason by adding ''<​nowiki>​{{delete|reason}}</​nowiki>''​ -line (where "​reason"​ is your reason) instead.
 +  * Please keep in mind that any page added to this category will be permanently deleted. ​
 +  * Admins will check this category periodically and delete the pages, so don't worry if your page isn't deleted immediately.
 +
 +=== Creating a subpage ===
 +
 +Many sections in th wiki are organized by subtopic, like [[Quality/​Compliance]] for example. There has been some confusion about how to create subpages, so here are the instructions:​
 +  * Make sure you are logged in (and see instructions above for searching before you create a new page)
 +  * In the search box, type Quality/My new page name
 +  * Click "​Go"​
 +
 +Please note that to avoid creating orphan pages (that is, wiki pages that no other wiki page links to) it is recommended that you create a page by linking to it first, and then clicking on the link to the non-existent page. For example [[Quality/​My new page name]]. Please also note that creating sub-pages more than 2 deep is advised against, since it makes link names longer, and does not help with the maintenance of the wiki. See the [[#Style]] section for the very brief style guide to the wiki.
 +
 +For more information see:  [[Help:​Signatures]] and [[Help:Talk pages]].
  
 ===== IMPORTANT! Namespaces! ===== ===== IMPORTANT! Namespaces! =====
Line 63: Line 144:
  
 ===== Spell Check ===== ===== Spell Check =====
-Please spell check your work, either with UK or USA English; many visitors do not have English as their primary language.+Please spell check your work, either with UK or USA English
 + 
 + 
 +===== Credit ===== 
 + 
 +''​Based on [[http://​wiki.maemo.org/​Contributing_to_the_wiki|Maemo wiki contribution guidelines]]''​. 
 + 
 +''​Based on [[http://​wiki.meego.com/​Wiki_contribution_guidelines|MeeGo Wiki contribution guidelines]]''​.
webteam/draft_guidelines.1300822461.txt.gz · Last modified: 2011/03/22 15:34 by aatre

© 2008-2017 GPLS and others. Evergreen is open source software, freely licensed under GNU GPLv2 or later.
The Evergreen Project is a member of Software Freedom Conservancy.