OSE Wiki Standards: Difference between revisions

From Open Source Ecology
Jump to navigation Jump to search
No edit summary
No edit summary
Line 2: Line 2:
The goal of OSE Wiki Standards is to maximize public participation by keeping things simple. The intended audience is non-advanced users, who are interested in contributing meaningfully to a wiki. The highest level of skill required is to use templates, filling in one's information as needed - to provide advanced formatting and modification without having to know how to program that format or modification in HTML or wiki markup .
The goal of OSE Wiki Standards is to maximize public participation by keeping things simple. The intended audience is non-advanced users, who are interested in contributing meaningfully to a wiki. The highest level of skill required is to use templates, filling in one's information as needed - to provide advanced formatting and modification without having to know how to program that format or modification in HTML or wiki markup .


=Cardinal Rules=
*The power of wiki comes from using wiki words - links to other wiki pages, created by using double brackets.


=Features Not Used=
=Features Not Used=
Here we explain which features we consciously not use on the wiki, with a goal to keep things simple.
Here we explain which features we consciously not use on the wiki, with a goal to keep things simple.
Features Not Used are those features which are not encouraged in order to maximize public participation in wiki editing. For example, the syntax for using the full power of References (Cite) in Mediawiki requires a bit of study - see [https://www.mediawiki.org/wiki/Extension:Cite] - which is geared for more advanced users. For OSE purposes, we prefer in normal documentation work to simply create internal links with additional information or a link to an external link. This way, no new syntax is needed to keep it simple, and new wiki words are defined.
Features Not Used are those features which can be used but are not encouraged for beginning users in order to maximize public participation in wiki editing. For example, the syntax for using the full power of References (Cite) in Mediawiki requires a bit of study - see [https://www.mediawiki.org/wiki/Extension:Cite] - which is geared for more advanced users. For OSE purposes, we prefer in normal documentation work to simply create internal links with additional information or a link to an external link. This way, no new syntax is needed to keep it simple, and new wiki words are defined.





Revision as of 17:22, 8 January 2016

Introduction

The goal of OSE Wiki Standards is to maximize public participation by keeping things simple. The intended audience is non-advanced users, who are interested in contributing meaningfully to a wiki. The highest level of skill required is to use templates, filling in one's information as needed - to provide advanced formatting and modification without having to know how to program that format or modification in HTML or wiki markup .

Cardinal Rules

  • The power of wiki comes from using wiki words - links to other wiki pages, created by using double brackets.

Features Not Used

Here we explain which features we consciously not use on the wiki, with a goal to keep things simple. Features Not Used are those features which can be used but are not encouraged for beginning users in order to maximize public participation in wiki editing. For example, the syntax for using the full power of References (Cite) in Mediawiki requires a bit of study - see [1] - which is geared for more advanced users. For OSE purposes, we prefer in normal documentation work to simply create internal links with additional information or a link to an external link. This way, no new syntax is needed to keep it simple, and new wiki words are defined.


These are useful, but to simplify matters in a 'brute force fashion' of not invoking any features for which there are simple workarounds that emphasize platform simplicity over 'complexity', we choose the simple workaround.*See example reference by clicking edit. [1]

Explanations, Annotations, Semantic Mediawiki Extension

  • U
  1. . This is a references at bottom of page.