Difference between revisions of "Help:Editing policies"

From SNIC Documentation
Jump to: navigation, search
Line 22: Line 22:
 
=== Notice ===
 
=== Notice ===
 
In case the examples appear in red, or if you see similar broken links with double colons in them in other places on the wiki, '''''do not edit the links'''''. They appear because you have happened to come across the pages before we have managed to install the semantic mediawiki extension properly on our production server.  This problem should disappear very shortly, and if it persists beyond your definition of shortly, it may help to edit the page, do nothing, and click save, to prod mediawiki to regenerate the links. If nothing works, please notify [[User:Joel Hedlund (NSC)]].
 
In case the examples appear in red, or if you see similar broken links with double colons in them in other places on the wiki, '''''do not edit the links'''''. They appear because you have happened to come across the pages before we have managed to install the semantic mediawiki extension properly on our production server.  This problem should disappear very shortly, and if it persists beyond your definition of shortly, it may help to edit the page, do nothing, and click save, to prod mediawiki to regenerate the links. If nothing works, please notify [[User:Joel Hedlund (NSC)]].
 
== Creating pages ==
 
;Ensure that you have [[#Set up your watch lists and notifications|set up your watch preferences and notifications]] correctly.
 
:Watch all pages that you create. Unwatched pages rot and we do not want that.
 
;Look at the [[:Category:Example page|example pages]]
 
:These are in the proper layout and use all the nifty templates for getting all the required information right. Chances are that much of the tedious work has already been done for you.
 
;Put some deep thought into the choice of page title.
 
:This is a wiki, so it matters a lot. See the relevant [[:Category:Example page|example pages]] for more details. Read the [[#Titles, headings and names|naming policies for titles, headings and names]] so you get it right.
 
;Create the talk page
 
:Also called the Discussion page. As this wiki is not open for unauthenticated editing other than through the talk pages, these are our primary form of input from the general public.
 
 
== Page examples, designs and templates ==
 
The examples and designs are all here:
 
:[[:Category:Example page]]
 
along with motivation on why you should not call them <s>templates</s> (because mediawiki has called dibs on that term).
 
  
 
== Editing help ==
 
== Editing help ==
 
Editing help is available here: [[Help:Editing]].
 
Editing help is available here: [[Help:Editing]].

Revision as of 20:53, 27 June 2011

This page contains information on how one should edit this wiki, eg: best practices, protocols, templates and the like.

These pages are a highly recommended read for new editors:

  1. Help:Recommendations for editors
    How to configure your account and to make sure your information gets displayed correctly.
  2. Help:Naming protocol
    How to choose and spell names, terms, titles and the like.
  3. Help:Categories and properties
    What they are, how they are used, and how to create new ones.

Semantic mediawiki extension

The snicdocs wiki uses the semantic mediawiki extension, which enables nifty things like dynamic generation of lists, tables and mashups based on tagged data in ordinary wiki pages. The annotation is unobtrusive, e.g:

I am competent with [[expertise::Python]].

to note that this page (or rather the person described by this page) is competent in Python. The search/generate syntax is equally straightforward

{{#ask: [[Category:Software]] [[Category:Bioinformatics]] |?centre }}

However, we must not let nomenclature run rampant and diverge (see: the problem with the semantic web). See naming protocol below.

Notice

In case the examples appear in red, or if you see similar broken links with double colons in them in other places on the wiki, do not edit the links. They appear because you have happened to come across the pages before we have managed to install the semantic mediawiki extension properly on our production server. This problem should disappear very shortly, and if it persists beyond your definition of shortly, it may help to edit the page, do nothing, and click save, to prod mediawiki to regenerate the links. If nothing works, please notify User:Joel Hedlund (NSC).

Editing help

Editing help is available here: Help:Editing.