Difference between revisions of "Help:Editing policies"

From SNIC Documentation
Jump to: navigation, search
(Set up your user page correctly)
Line 1: Line 1:
 
This page contains information on how one should edit this wiki, eg: best practices, protocols, templates and the like.
 
This page contains information on how one should edit this wiki, eg: best practices, protocols, templates and the like.
 +
 +
== Semantic mediawiki extension ==
 +
The snicdocs wiki uses the [http://semantic-mediawiki.org| 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:
 +
 +
: <nowiki>[[competence::Python]]</nowiki> to make [[competence::Python]]
 +
 +
and the search/generate syntax is equally straightforward
 +
 +
: <nowiki>{{#ask: [[Category:Software]] [[Category:Bioinformatics]] |?centre }}</nowiki> to make ''redacted, do not use before the extension is properly installed, or it may mess up the page's categories''
 +
 +
as long as we do not let nomenclature run rampant and diverge (see: the problem with the semantic web).
 +
 +
In case the examples below appear in red, or if you see similar broken links in other places on the wiki, it is 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, notify [[User:Joel Hedlund (NSC)]].
 +
 +
  
 
== Recommendations for editors ==
 
== Recommendations for editors ==

Revision as of 20:29, 15 June 2011

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

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:

[[competence::Python]] to make Python

and the search/generate syntax is equally straightforward

{{#ask: [[Category:Software]] [[Category:Bioinformatics]] |?centre }} to make redacted, do not use before the extension is properly installed, or it may mess up the page's categories

as long as we do not let nomenclature run rampant and diverge (see: the problem with the semantic web).

In case the examples below appear in red, or if you see similar broken links in other places on the wiki, it is 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, notify User:Joel Hedlund (NSC).


Recommendations for editors

Set up your watch lists and notifications

  1. Go to your preferences page and add your email.
  2. Configure your account so that pages you create automatically get added to your watchlist, and that notifications will go to your email.

Set up your user page correctly

  1. Tag your user page with the categories "Applications expert" and your research area (at least one, eg "Bioinformatics").
  2. List your special competences using verbatim semantic medawiki property tags, like so [[competence::Python]] to make e.g: Python, note double colons.

best practices

category naming scheme and protocol

page designs / templates

subscription lists

help links