Wiki Work

Module 15: Contributing to the Wiki

The iSIKHNAS Wiki

The iSIKHNAS Wiki was started in 2013 as a collaborative documentation tool for use during the development of the system. As it grew, iSIKHNAS became much more sophisticated and complex. The number of users increased dramatically and all required training in the use of the system. The iSIKHNAS Wiki soon became the central repository for all the resources required for supporting the system and its users. Now it is the primary source of all information related to the system, the training of users and the management of training materials and other documentation.

What is a WIKI?

Depending on its purpose a wiki can be described as

• a collaborative document exchange
• a database for creating, browsing and searching through information
• a knowledge management system
• a group learning tool
• a version control manager for documents
• a mass collaborative document handler
• an internal documentation repository.

Advantages

• anyone can edit
• easy to use and learn
• Wikis are instantaneous so there is no need to wait for a publisher to create a new edition or update information
• people located in different parts of the world can work on the same document
• the wiki software keeps track of every edit made and it's a simple process to revert back to a previous version of an article
• widens access to the power of web publishing to non-technical users
• the wiki has no predetermined structure - consequently it is a flexible tool which can be used for a wide range of applications
• there are a wide range of open source software wiki's to choose from so licensing costs shouldn't be a barrier to installing an institutional wiki

Disadvantages

Advantages in one context, may be disadvantages in another.

• Anyone can edit so this may be too open for some applications, for example confidential documentation. However it is possible to regulate user access.
• Open to SPAM and Vandalism if not managed properly. There are easy ways to restore a page however, and on WikiEducator you must be logged in to edit pages so this reduces vandalism by automated spam bots.
• Requires Internet connectivity to collaborate, but technologies to produce print versions of articles are improving
• The flexibility of a wiki's structure can mean that information becomes disorganised. As a wiki grows, the community plans and administers the structure collaboratively.

Participants

60px

The four basic types of users who participate in wikis are

• readers
• authors - contributes to the content of the wiki, uploads material, etc.
• wiki administrator - maintains wiki content and is provided additional functions pertaining to pages (e.g. page protection and deletion)and can adjust users' access rights by, for instance, blocking them from editing.
• system administrator - responsible for installation and maintenance of the wiki engine and the container web server.

Getting started

English - Here are some basic editing tips to help you get started

Bahasa Indonesia - Help : Penyuntingan

Log in

To edit an existing content or create new pages on the iSIKHNAS wiki you must first make sure you have permission to contribute and that you have been given a User Name and Password. Contact the Champions if you would like to be involved.

• Go to the bottom of any page of the wiki and click on Log in.

• You will be taken to the log in page.

• Log in using the User Name and Password. You can always change the password later.

Once you are logged in you will notice that the top right hand menu has changed. There are now more options available to you but most importantly this means you can now edit content on the wiki.

Menu before log in

Menu after log in

For a page which is still linked to the translation system

• If you want to edit this page you will have to choose the "translate" option in the menu.

For a page which is independent of the translation system

• Click on Edit on this menu. This will take you to an editable version of the page.

Example page: Published version

The url for this page is http://wiki.isikhnas.com/w/About_iSIKHNAS/id

• Click on Edit in the menu at the top right hand corner

Example page: Editable version

Wiki formatting

You can use the toolbar at the top of the Edit page which puts the correct mark-up in automatically.

Or you can insert the "mark up" language manually yourself as you write the content.

This table shows you the toolbar icon as well as the manual mark up format.

There are a few good ways of learning this system of formatting text

• Open the same page on two different tabs of your browser. Go into edit mode on one of the pages and look at the formatting which exists in the published page then look back at the editable version to see how the formatting appears. You will quickly start to realise how the mark up language works and some of the "rules" for using wiki formatting. Remember to save your changes.

• Open one page in edit mode and toggle between the Edit and the View tabs. Remember to save your changes.

Pages linked to the Translation system

Many pages were created first in English and then a Bahasa Indonesia version of the original or 'master' pages has been created. These pages are linked so that an update or change in the Master page can be tracked and made in the Bahasa Indonesia page.

At the moment most pages are linked in this way and to make any changes to the Bahasa version you will have to edit them through the translation system by pressing on the Translate option on your menu.

Very soon these pages will be unlinked and set free from the English master page. This will take place as more expertise develops and more people are willing to take responsibility for keeping the Wiki up to date. These unlinked pages will be able to be edited using the Edit option on the menu.

To edit a linked page

• Go to the page you wish to edit.
  • You want to edit the SMS Operational Instructions for a particular message. You go to the main SMS Information menu page and choose the DX message from the list. Click on the DX: Diagnosa Definitif : Definitive diagnosis.

• At the moment you will be taken to the English master page. If you want to edit the English version and leave the translators to edit the Bahasa Version then just click on Edit in the menu at the top right hand of the page. If you want to look at tht Bahasa translation then look at the language choice bar at the top of this page.

• Click on Bahasa Indonesia and this will take you to the translated page. You will see that there is no longer an Edit at the menu in the top right hand corner.

• Instead, click on the Translate option. This takes you to a two sided page. The left column is the original English text divided into small chunks for easier translation. The right hand column is the Bahasa Indonesia version. Some or all of it will be translated from the English, depending on the progress the translation team have made. Make sure that the language at the top of the page says Bahasa Indonesia as the translated language.

• To start to edit the translated text click on the portion of text you wish to edit. It will look like this

• Make changes and be sure to press Save translation at the bottom of the window.

Setting pages free - How to detach a page from the translation system

Eventually most of the wiki pages should become independent from the translation system so that they are no longer linked with the English master pages and only ever edited or created in Bahasa Indonesia. It is advisable to keep some up to date information about iSIKHNAS available in English for any international viewers who are interested in finding out more about this wonderful system. Most pages will soon be kept up to date by Bahasa Indonesian speakers for a soley Indonesian audience.

Here is how to unlink a page which has been created in English, translated into Bahasa Indonesia and which is going to be "taken over" by an Indonesian editor. You can only do this if you have Administrator Rights in the iSIKHNAS Wiki.

Step 1: Go to the English version of the page you wish to unlink.

Step 2: Choose Edit from the menu in the top right-hand corner.

Step 3:

You will have to confirm that you really want to remove this page from the translation system. You should be aware that by doing this step the language selector and translated page names will stop working. The translation pages will become editable.