Views

Difference between revisions of "What should I mind when editing?"

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search
(Neutralität und Objektivität)
 
(15 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<div class="breadcrumb">
+
{{Breadcrumb|en|Was muss ich beim Bearbeiten beachten?|Getting started}}
{{up}} [[Getting started]] | {{de}} [[Was muss ich beim Bearbeiten beachten?]]
 
</div>
 
  
 
__TOC__
 
__TOC__
 +
== Neutrality and Objectivity==
  
== Neutrality and objectivity==
+
This Wiki should be an informative place that allows an open exchange of information. For this to work, users must observe a couple of ground rules. This not only affects contributions on discussion pages, but primarily also the style of writing in your own articles. The following should therefore be avoided:
 
 
This Wiki should be an informative place that allows an open exchange of information. For this to work, users must observe a couple of ground rules. This not only affects articles on discussion pages, but primarily the style of writing in your own articles. You should therefore avoid:
 
  
 
* Malicious slander,
 
* Malicious slander,
Line 14: Line 11:
 
* Intentional misinformation.
 
* Intentional misinformation.
  
In terms of neutrality and objectivity, we follow the same guidelines as Wikipedia. Refer to its article esen Sie dort den Artikel [http://en.wikipedia.org/wiki/Wikipedia:Neutral_point_of_view Neutral point of view]!
+
In terms of neutrality and objectivity, we follow the same guidelines as Wikipedia. Refer to the article there entitled [http://en.wikipedia.org/wiki/Wikipedia:Neutral_point_of_view Neutral point of view]!
  
== Verständlichkeit und Anschaulichkeit ==
+
== Comprehensibility and Clarity ==
  
Viele Artikel dieses Wikis sind technische Dokumentation. Gute technische Dokumentation achtet auf leichte Textverständlichkeit. Sätze sollten nicht verschachtelt sein. Jeder Satz sollte eine klare, eigene Aussage enthalten. Komplexe Sachverhalte sollten zusätzlich veranschaulicht werden. Zur Veranschaulichung eignen sich je nach Sachverhalt Beispiele, illustrierende Grafiken oder Multimedia-Material wie kleine Filme, die einen Ablauf zeigen. Lesen Sie dazu auch: [[How do I add images and multimedia?]]
+
Many articles in this Wiki are technical documents. Good technical documentation ensures that the text can be easily understood. Convoluted sentences should be avoided. Each sentence should make a clear, idiosyncratic statement. Complex facts should also be properly clarified. Suitable means of providing clarification include, depending on circumstances, illustrative graphics or multimedia material such as short filmlets that illustrate operation. Please refer here to: [[How do I add images and multimedia?]]
  
== Integration in das Wiki ==
+
== Integration in the Wiki ==
  
Neue Artikel sollten mit den übrigen Wiki-Inhalten "harmonisieren". Das bedeutet:
+
New articles should be in harmony with the remaining Wiki contents. This means:
  
* New articles sollten sich in Bezug auf Länge und Detailtiefe an vergleichbaren Artikeln orientieren.
+
* New articles should be based in terms of length and level of detail on comparable articles.
* Verwenden Sie möglichst die gleiche Fachterminologie wie andere, vergleichbare Artikel innerhalb des Wikis.
+
* If possible, use the same specialist terminology as other comparable articles within the Wiki.
* Verlinken Sie neue Artikel wie in [[How do I create an article?]] beschrieben.
+
* Link the new article as described in [[How do I create an article?]].

Latest revision as of 07:33, 27 April 2011

Neutrality and Objectivity

This Wiki should be an informative place that allows an open exchange of information. For this to work, users must observe a couple of ground rules. This not only affects contributions on discussion pages, but primarily also the style of writing in your own articles. The following should therefore be avoided:

  • Malicious slander,
  • Personal insults,
  • Typical troll expressions,
  • Intentional misinformation.

In terms of neutrality and objectivity, we follow the same guidelines as Wikipedia. Refer to the article there entitled Neutral point of view!

Comprehensibility and Clarity

Many articles in this Wiki are technical documents. Good technical documentation ensures that the text can be easily understood. Convoluted sentences should be avoided. Each sentence should make a clear, idiosyncratic statement. Complex facts should also be properly clarified. Suitable means of providing clarification include, depending on circumstances, illustrative graphics or multimedia material such as short filmlets that illustrate operation. Please refer here to: How do I add images and multimedia?

Integration in the Wiki

New articles should be in harmony with the remaining Wiki contents. This means:

  • New articles should be based in terms of length and level of detail on comparable articles.
  • If possible, use the same specialist terminology as other comparable articles within the Wiki.
  • Link the new article as described in How do I create an article?.