Help:Editing rules: Difference between revisions

The educational technology and digital learning wiki
Jump to navigation Jump to search
Line 14: Line 14:
We do not require "neutral point of view", "no research", "quality" etc. as it is for instance the case in the Wikipedia [[Wikipedia:Neutral point of view | policy]]. Simply follow academic standards of presentation, i.e. make sure that readers can find out whether a statement is based on solid research, on speculation, on opinion, on practical experience, etc. and whether it may be controversial.  
We do not require "neutral point of view", "no research", "quality" etc. as it is for instance the case in the Wikipedia [[Wikipedia:Neutral point of view | policy]]. Simply follow academic standards of presentation, i.e. make sure that readers can find out whether a statement is based on solid research, on speculation, on opinion, on practical experience, etc. and whether it may be controversial.  


Also make sure that the reader understands if an entry is a "good" piece or just "notetaking" (see [[#Templates_for_page_status | page status templates]] below). So far (12:27, 21 September 2006 (MEST)), most entries are ''just notetaking'' :)
Also make sure that the reader understands if an entry is a "good" piece or just "notetaking" (see [[#Templates_for_page_status | page status templates]] below). So far (12:37, 21 September 2006 (MEST)), most entries are ''just notetaking'' :)


; Recognition
; Recognition
Line 51: Line 51:


If an entry (articile title) exists under an other name (title):
If an entry (articile title) exists under an other name (title):
* You can use the redirection feature to point from a new page name to another existing one. Create the new page and insert a single line like it can be found in the [[http://edutechwiki.unige.ch/mediawiki/index.php?title=Teaching_strategy&redirect=no | Teaching strategy]] page:
* You can use the redirection feature to point from a new page name to another existing one. Create the new page and insert a single line like it can be found in the [[http://edutechwiki.unige.ch/mediawiki/index.php?title=Teaching_strategy&redirect=no Teaching strategy]] page:
: <nowiki>#REDIRECT [[Pedagogic strategy]]</nowiki>
: <nowiki>#REDIRECT [[Pedagogic strategy]]</nowiki>
* Alternatively to use your favorite synonym for a concept in an other article, use complex links like <nowiki>[[link | your label]] </nowiki>
* Alternatively to use your favorite synonym for a concept in an other article, use complex links like <nowiki>[[link | your label]] </nowiki>
Line 61: Line 61:


== Templates for page status ==
== Templates for page status ==
* Since this Wiki (so far) is mostly used as a [[note taking]] device, it is useful to tell users something about the status of an entry with a banner. For this purpose we created some templates.
* Since this Wiki (so far) is mostly used as a [[note taking]] device, it is useful to tell users something about the status of an entry with a banner. For this purpose we created some templates.
* Templates refer to code inserted between <nowiki>{{...}}</nowiki>, i.e. they will add contents to a page, insert it into a category and maybe modify it's look.
* [[:Category:Under construction]]
* [[:Category:Incomplete]]
* [[:Category:Stubs]]
* [[:Category:Rough draft]]
 
* Templates refer to code inserted between <nowiki>{{...}}</nowiki>. Our page status templates will add a banner to a page and insert the page into a maintenance category.
* We are not yet sure which templates to use here, e.g. the Wikipedia [[Wikipedia:Template_messages | has lots]], but we certainly can do with less. See the [[:Category:Templates]] for a list of templates in use. Here are the most important ones:
* We are not yet sure which templates to use here, e.g. the Wikipedia [[Wikipedia:Template_messages | has lots]], but we certainly can do with less. See the [[:Category:Templates]] for a list of templates in use. Here are the most important ones:


Line 71: Line 77:
#* Use the <nowiki>{{under construction}}</nowiki> template if you are working on an article and want other people to know about. Once you stop working on it you may revert the article to "incomplete" or "stub"
#* Use the <nowiki>{{under construction}}</nowiki> template if you are working on an article and want other people to know about. Once you stop working on it you may revert the article to "incomplete" or "stub"
# Planned contents, i.e. stubs ([[:Template:Stub]])
# Planned contents, i.e. stubs ([[:Template:Stub]])
#* Use the  <nowiki>{{stub}}</nowiki> template if you just want to create an article, but without really working on it.
#* Use the  <nowiki>{{stub}}</nowiki> template if you just want to create an article add a few definitions, references and links, but without really working on it.
# Incomplete articles  ([[:Template:Incomplete]])
# Incomplete articles  ([[:Template:Incomplete]])
#* Use the  <nowiki>{{Incomplete}}</nowiki> template to signal that an article is ok as a resource, but that it should be further improved in various ways (e.g. by adding new sections, reorganizing contents, etc.)
#* Use the  <nowiki>{{Incomplete}}</nowiki> template to signal that an article is ok as a resource, but that it should be further improved in various ways (e.g. by adding new sections, reorganizing contents, etc.)
# Rough draft ([[:Template:Rough draft]])
#* The {{Rough draft}} template is for people who are afraid to publish really unfinished things. [[User:DSchneider|DSchneider]] never uses it, but it was a request from our students ...
Please do not edit the templates themselves ! (unless you know about wiki programming).


== Structure and categories ==
== Structure and categories ==

Revision as of 11:37, 21 September 2006

Here is a set of rules that you should use. These rules are open for negotiation. Use the Discussion page to discuss.

Contents of this Wiki

Edutech Wiki contains articles related to educational technology and all related fields (e.g. see the the big picture

No spamming of any sort is tolerated, i.e. we explicitly refuse entries not related to educational technology and related subject matters! In most countries spamming is not allowed, legal action can be taken quite easily and fines can be substantial. All your actions are registered by IP ! (see also the privacy policy). We also reserve the right to block access to any user, IP number or even whole domains !

This Wiki is managed by TECFA and DSchneider and we are open to any sorts of collaboration.

Authorship and opinions

No neutral point of view

We do not require "neutral point of view", "no research", "quality" etc. as it is for instance the case in the Wikipedia policy. Simply follow academic standards of presentation, i.e. make sure that readers can find out whether a statement is based on solid research, on speculation, on opinion, on practical experience, etc. and whether it may be controversial.

Also make sure that the reader understands if an entry is a "good" piece or just "notetaking" (see page status templates below). So far (12:37, 21 September 2006 (MEST)), most entries are just notetaking :)

Recognition

If you wish, you can sign an article with your name and institution, e.g. something like this: ;[[User:DSchneider | Daniel K. Schneider]] :''TECFA, University of Geneva'' which will show as:

Daniel K. Schneider
TECFA, University of Geneva

Of course if you modify an existing article then you may have a look at the history and add at least the wiki login names of those who made significant contributions. Also, someone else may add stuff to your stuff and add his own name. Authorship is something that may need some more discussion, and we should write a template for this.

Your opinions
  • If they may be controversial, sign a statement with your Wiki user ID (or even better with your full name and a link to your wiki ID)
  • Three ~~~ insert your user ID
E.g. DSchneider thinks that these editing rules are just fine
  • Four ~~~~ insert your user ID + Time/Date
E.g. These rules need some improvement (11:21, 11 April 2006 (MEST) - DSchneider)
If you totally disagree with an article
  • You first may try to discuss (use the article's discussion page)
  • If you believe that there can't be a way to present different views and opinions within an article, just write your own with an other title, but link the two please.

New articles

Improve old contents
  • Before starting a new article: search the wiki to check if there is already an article. If so, try to improve it.
New article titles ( important ! )
  • 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")
Synonyms, multiple meanings etc.

If an entry (articile title) exists under an other name (title):

  • You can use the redirection feature to point from a new page name to another existing one. Create the new page and insert a single line like it can be found in the [Teaching strategy] page:
#REDIRECT [[Pedagogic strategy]]
  • Alternatively to use your favorite synonym for a concept in an other article, use complex links like [[link | your label]]

If a term for an article title has too many meanings:

  • Create a small page that lists various meanings and insert a "disambig" template (see below).
  • Then write your article under a more specific title.
  • To see some examples look at the Disambiguation category

Templates for page status

  • Templates refer to code inserted between {{...}}. Our page status templates will add a banner to a page and insert the page into a maintenance category.
  • We are not yet sure which templates to use here, e.g. the Wikipedia has lots, but we certainly can do with less. See the Category:Templates for a list of templates in use. Here are the most important ones:
  1. Disambiguation pages (Template:disambig):
    • These are small pages that will split an ambiguous term into more specific terms (specific articles). Example: Activity
    • Insert the disambiguation template {{disambig}} at the end of the article (will insert a message and disambiguation category.
  2. Under construction (Template:Under construction):
    • Use the {{under construction}} template if you are working on an article and want other people to know about. Once you stop working on it you may revert the article to "incomplete" or "stub"
  3. Planned contents, i.e. stubs (Template:Stub)
    • Use the {{stub}} template if you just want to create an article add a few definitions, references and links, but without really working on it.
  4. Incomplete articles (Template:Incomplete)
    • Use the {{Incomplete}} template to signal that an article is ok as a resource, but that it should be further improved in various ways (e.g. by adding new sections, reorganizing contents, etc.)
  5. Rough draft (Template:Rough draft)
    • The

This article is a rough draft

It has been posted by an author who is not afraid to let an audience look at its current state.
In principle, he is working on it and there should be a better version soon.
If you plan to help, please use the discussion page or wait until the article reverts to a better status, e.g. incomplete

template is for people who are afraid to publish really unfinished things. DSchneider never uses it, but it was a request from our students ...

Please do not edit the templates themselves ! (unless you know about wiki programming).

Structure and categories

Please make sure that your articles are structured and that they belong to some category. Also try to link articles to each other.

Structure of articles
  • Use titles, e.g. == Level 1 == , === Level 2 ===, etc.
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 ...).
  • See the start page for a list of major categories, or look at the full list
Links
  • use complex links when needed, 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".
Good: "this is a frequent statement in [[Behaviorism | behaviorist theory]]".
One article = one topic
  • Create new pages for topics that are relevant to other articles. This is not an iron rule. You can, within article introduce and redefine a concept that is treated elsewhere (in this case don't make it too long and add a link to article in question).
  • Note: There is a system to compose articles from several pages if needed.
Organization of content
  • There are no rules. Most of what you currently see in this wiki is simply the result of DSchneider's way of doing it. Of course at some point it probably would be nice to make a distinction between research-oriented articles and more practical ones or even find a way to deal with both types of information within a single one.
Bibliography and citations within an article
  • There are no rules for the bibliography and citations. Doing it right is probably too time consuming (open to discussion)
  • But please make sure that you add the full references for citations (so that people can find them).
  • Also make sure to add some "open content" links for people without access to commercial services.

Images, quotations and citations

Inserting an image
  • To insert an image you can do better than [[Image:xxx.png]]
E.g. [[image:input-process-output-paradigm.png|frame|none|Input-process-output paradigm]]
Document an image (when you upload it)
  • Please add a description for images that you upload
  • Indicate the source (avoid using pictures that may be undercopyright or ask permission to reproduce)
Cite please !
  1. Always quote the source, never copy/paste from the web without indication of the source and if possible date of retrieval
    • Do note copy whole pages, even if you cite the source. Use some "liberal idea" of fair practise.
  2. Use the quotation templates if you want
Useful shortcuts
  • Five ~~~~~ inserts the current date.

Example:

At the time of writing it was ~~~~~
At the time of writing it was 17:04, 18 May 2006 (MEST).
  • The {{retr}} template will show as:
retrieved, 17:17, 15 September 2006 (MEST)