Difference between revisions of "Help:Editing policies"

From SNIC Documentation
Jump to: navigation, search
Line 10: Line 10:
 
; [[Help:Categories and properties|Categories and properties]]
 
; [[Help:Categories and properties|Categories and properties]]
 
: What they are, how they are used, and how to create new ones.
 
: What they are, how they are used, and how to create new ones.
 +
; [[Help:Editing|Editing help]]
 +
: Help with syntax, formatting and other practicalities.
  
 
== Semantic mediawiki extension ==
 
== Semantic mediawiki extension ==
Line 24: Line 26:
 
=== 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)]].
 
== Editing help ==
 
Editing help is available here: [[Help:Editing]].
 

Revision as of 21:10, 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:

Recommendations for editors
How to configure your account and to make sure your information gets displayed correctly.
Naming protocol
How to choose and spell names, terms, titles and the like.
Creating pages
Nifty stuff with templates and examples that will reduce the amount of work you'll have to do.
Categories and properties
What they are, how they are used, and how to create new ones.
Editing help
Help with syntax, formatting and other practicalities.

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).