Help:Editing rules: Difference between revisions

The educational technology and digital learning wiki
Jump to navigation Jump to search
Line 1: Line 1:
Here is a simple set of rules that you should use:
Here is a simple set of rules that you should use:
== New articles ==


# Before starting a new article: search the wiki to check if there is already an article
# Before starting a new article: search the wiki to check if there is already an article
Line 6: Line 8:
#* else use complex links like <nowiki>[[link | your label]] </nowiki>
#* else use complex links like <nowiki>[[link | your label]] </nowiki>
#* See also "disambiguation pages" below, i.e. a content can be split up over several articles
#* See also "disambiguation pages" below, i.e. a content can be split up over several articles
# New articles:
# New article titles:
#* '''Never''' use capital letters except for the very first one (the only exception are proper names). Good: Educational theory - Bad: Educational Theory
#* '''Never''' use capital letters except for the very first one (the only exception are proper names). Good: Educational theory - Bad: Educational Theory
#* Use singular (e.g. theory, not theories)
#* Use singular (e.g. theory, not theories)
#* No articles (bad: "the xy theory ...", good: "xy theory")
#* Don't use articles (bad: "the xy theory ...", good: "xy theory")
#* If the term is very ambigous, use the procedure for disambiguation pages
#* If the term is very ambigous, use the procedure for disambiguation pages
# Disambiguation pages:
# Disambiguation pages:
#* These are small pages that will split an ambiguous term into more specific temrs (specific articles). Example: [[Activity]]
#* These are small pages that will split an ambiguous term into more specific temrs (specific articles). Example: [[Activity]]
#* Insert the disambiguation template <nowiki>{{disambig}}</nowiki> at the end of the article (will insert a message and disambiguation category.
#* Insert the disambiguation template <nowiki>{{disambig}}</nowiki> at the end of the article (will insert a message and disambiguation category.
#Under construction and Stubs:
#* Use the {{under construction}} template if you plan to finish a first acceptable version of your article fairly soon
#* Use the {{stub}} template if you just want to create an article, but without really working on it.
== Structure and categories ==
# Structure of articles:
# Structure of articles:
#* Use titles, e.g. <nowiki> == Level 1 == , === Level 2 ===, etc. </nowiki>
#* Use titles, e.g. <nowiki> == Level 1 == , === Level 2 ===, etc. </nowiki>
Line 24: Line 32:
# One article = one topic, i.e. create new pages for topics that are relevant to other articles.
# One article = one topic, i.e. create new pages for topics that are relevant to other articles.
#* Note: There is a system to compose articles from several pages if needed.
#* Note: There is a system to compose articles from several pages if needed.
== Images ==
# Images:
# Images:
#* To insert an image use <nowiki>[[Image:xxx.png]]</nowiki>
#* To insert an image use <nowiki>[[Image:xxx.png]]</nowiki>
Line 29: Line 40:
#* Indicate the source ! and date insertion time
#* Indicate the source ! and date insertion time
#* Note: Five <nowiki>~~~~~</nowiki> will do the trick
#* Note: Five <nowiki>~~~~~</nowiki> will do the trick
== Authorship ==
# Your opinions:
# Your opinions:
#* If they may be controversial, use your Wiki user ID
#* If they may be controversial, sign a statement with your Wiki user ID
 
# Useful shortcuts:
#* Three <nowiki>~~~</nowiki> insert your user ID and four <nowiki>~~~~</nowiki> insert your user ID + Time/Date
#* Three <nowiki>~~~</nowiki> insert your user ID and four <nowiki>~~~~</nowiki> insert your user ID + Time/Date
#* E.g. [[User:DSchneider|DSchneider]] thinks that these editing rules are just fine
#* E.g. [[User:DSchneider|DSchneider]] thinks that these editing rules are just fine
#* E.g. These rules need some improvement (11:21, 11 April 2006 (MEST) - [[User:DSchneider|DSchneider]])
#* E.g. These rules need some improvement (11:21, 11 April 2006 (MEST) - [[User:DSchneider|DSchneider]])

Revision as of 14:26, 17 May 2006

Here is a simple set of rules that you should use:

New articles

  1. Before starting a new article: search the wiki to check if there is already an article
  2. If a content exists under an other name:
    • use redirection IFF you feel that your concept should have its own entry
    • else use complex links like [[link | your label]]
    • See also "disambiguation pages" below, i.e. a content can be split up over several articles
  3. New article titles:
    • Never use capital letters except for the very first one (the only exception are proper names). Good: Educational theory - Bad: Educational Theory
    • Use singular (e.g. theory, not theories)
    • Don't use articles (bad: "the xy theory ...", good: "xy theory")
    • If the term is very ambigous, use the procedure for disambiguation pages
  4. Disambiguation pages:
    • These are small pages that will split an ambiguous term into more specific temrs (specific articles). Example: Activity
    • Insert the disambiguation template {{disambig}} at the end of the article (will insert a message and disambiguation category.
  5. Under construction and Stubs:
    • Use the

This article or section is currently under construction

In principle, someone is working on it and there should be a better version in a not so distant future.
If you want to modify this page, please discuss it with the person working on it (see the "history")

template if you plan to finish a first acceptable version of your article fairly soon

    • Use the

This article or section is a stub. It does not yet contain enough information to be considered a real article. In other words, it is a short or insufficient piece of information and requires additions.

Draft

template if you just want to create an article, but without really working on it.

Structure and categories

  1. Structure of articles:
    • Use titles, e.g. == Level 1 == , === Level 2 ===, etc.
  2. Categories:
    • Insert at least one category at the end of each article !, e.g. [[Category:educational technologies]]
    • You may suggest new categories if needed ! Use plural, not singular. (Categories are auto-creating, we will decide together if we keep yours ...).
  3. Links: use complex links when need, do not use: "(see here)".
    • Bad "this is a frequent statement in behaviorist theory" (see [Behaviorism)."
    • Good: "this is a frequent statement in behaviorist theory".
  4. One article = one topic, i.e. create new pages for topics that are relevant to other articles.
    • Note: There is a system to compose articles from several pages if needed.

Images

  1. Images:
    • To insert an image use [[Image:xxx.png]]
    • Please add a description for images that you upload
    • Indicate the source ! and date insertion time
    • Note: Five ~~~~~ will do the trick

Authorship

  1. Your opinions:
    • If they may be controversial, sign a statement with your Wiki user ID
  1. Useful shortcuts:
    • Three ~~~ insert your user ID and four ~~~~ insert your user ID + Time/Date
    • E.g. DSchneider thinks that these editing rules are just fine
    • E.g. These rules need some improvement (11:21, 11 April 2006 (MEST) - DSchneider)