Make sure you register to our monthly newsletter, it's going out soon! Stay up do date about the latest energy news and our current activities.
Click here to register!

Difference between revisions of "Energypedia - Do's and Dont's"

From energypedia
***** (***** | *****)
m (Created page with "==== '''Ten things you should do and ten things you should not while being on energypedia''': ==== Image:Dos.jpg #'''Start writing!'''<br>If you have practical informatio...")
 
***** (***** | *****)
m
Tag: 2017 source edit
 
(17 intermediate revisions by 6 users not shown)
Line 1: Line 1:
==== '''Ten things you should do and ten things you should not while being on energypedia''':  ====
+
{{Back to Help Portal}} [[File:Dos.jpg|78px|Do's|alt=Do's]]
  
[[Image:Dos.jpg]]  
+
#'''Start writing!'''<br/>If you have practical information or experiences to share then just [[Create_a_New_Article|start writing a new article]] or edit an existing one. A wiki article will never be completed and is always work in progress, so do not think that your knowledge is not worth to be written down.
 +
#'''Keep it short!'''<br/>Focus on the relevant information and avoid unnecessary empty phrases and passages like prefaces or acknowledgments. Instead of writing a long article rather try to split it into several interlinked shorter ones which will help the readers to quickly find the exact piece of information that they are looking for.
 +
#'''Choose a precise title!'''<br/>Most users will find your article via a title search, so find a concise but meaningful title which reflects the article's subject as precise as possible.
 +
#'''Structure your article!'''<br/>Give your article a useful structure by including [[Add_Headings|headlines]] and [[Create_Bullet_Points_and_Numbered_Lists|bullet points]].
 +
#'''Design your article!'''<br/>Make your article visually more attractive for the reader by including informative [[Insert_Tables|tables]], [[Insert_File_as_Picture_/_Link|pictures and graphs]].
 +
#'''Link your articles!'''<br/>Instead of writing the same information again in your text (for example, definitions or procedures), simply [[Link_to_an_Article|link to existing articles]] which already explain the relevant point in detail. This will not only increase the information value of your article but also the likelihood of people finding it on energypedia.
 +
#'''Categorize your article!'''<br/>All articles should be [[Categorize_an_Article|categorized]] with one or more category. This will help users to find your article and more generally will give energypedia an underlining structure.
 +
#'''Keep editing articles!'''<br/>To continuously improve energypedia, its users have to fill content gaps, correct typing errors or change outdated information if they come across them. That is why [[Edit_an_Article|editing articles]] is so important for the quality of a wiki.
 +
#'''Be rational!'''<br/>While working collaboratively with others on an article you might disagree about some passages. Avoid constant reverting of other people's edits which will lead into edit wars. Rather start a discussion explaining your thinking and reasons for edits and allow others to response. Thereby keep in mind that you argue facts not personalities.
 +
#'''Be polite!'''<br/>Above all, whatever you are doing - be it writing on somebody's wall or responding to a discussion - be always polite and treat your counterpart with respect. Even in disputes try to stay calm and work constructively towards agreement amongst all involved actors.<br/>
  
#'''Start writing!'''<br>If you have practical information or&nbsp;experiences to share then just [http://help.energypedia.info/index.php/Create_a_new_article '''start writing a new article'''] or edit an existing one. A wiki article&nbsp;will never be completed and is&nbsp;always work in progress, so do not think that your knowledge is not worth to be written down. But remember [[Energypedia - What it is and what not|'''what energypedia is and what it is&nbsp;not''']].
+
[[File:Donts.jpg|100px|Dont's|alt=Dont's]]
#'''Keep it short!'''<br>Focus on the relevant&nbsp;information and avoid unnecessary empty phrases and passages like prefaces or acknowledgments. Instead of writing a long article rather try to split it into several interlinked shorter ones which will help the readers to quickly find the exact piece of information that they are looking for.
 
#'''Choose a precise title!'''<br>Most users will find your article via a title [http://help.energypedia.info/index.php/Search_Articles '''search'''], so find a concise but meaningful title which reflects the article's subject as precise as possible.
 
#'''Structure your article!'''<br>Give your article a useful structure by including&nbsp;[http://help.energypedia.info/index.php/Add_headlines '''headlines'''] and [http://help.energypedia.info/index.php/Create_Bullet_Points_and_Numbered_Lists '''bullet points'''].&nbsp;
 
#'''Design your article!'''<br>Make your article visually more attractive for the reader by&nbsp;including informative [http://help.energypedia.info/index.php/Draw_Tables '''tables'''], [http://help.energypedia.info/index.php/Insert_File_as_Picture '''pictures and graphs'''].
 
#'''Link your articles!'''<br>Instead of writing the same information again in your text (for example, definitions or procedures), simply [http://help.energypedia.info/index.php/Link_Articles '''link to existing articles'''] which already explain the relevant point in detail. This will not only increase the information value of your article&nbsp;but also&nbsp;the likelihood of people finding it on energypedia.&nbsp;
 
#'''Categorize&nbsp;your article!'''<br>All articles should be [http://help.energypedia.info/index.php/How_to_use_Categories '''categorized'''] with one or more&nbsp;category. This will&nbsp;help users&nbsp;to find your article&nbsp;and more generally will give energypedia an underlining structure.
 
#'''Keep editing articles!'''<br>To continuously improve energypedia, its users&nbsp;have to fill content gaps, correct typing errors or&nbsp;change outdated information&nbsp;if they come across them. That is why [http://help.energypedia.info/index.php/Edit '''editing articles'''] is so important for the quality of a wiki.
 
#'''Be rational!'''<br>While working collaboratively with others on an article you might disagree about some passages. Avoid&nbsp;constant reverting of other people's edits which will lead into edit wars. Rather [http://help.energypedia.info/index.php/Discussions '''start a discussion'''] explaining your thinking and reasons for edits and allow others to response. Thereby keep in mind that you argue facts&nbsp;not personalities.
 
#'''Be polite!'''<br>Above all, whatever you are doing - be it [http://help.energypedia.info/index.php/Social_Networking '''writing on somebody's wall'''] or responding to&nbsp;a discussion - be always polite and treat your counterpart with respect. Even in disputes try to stay calm and work constructively towards agreement amongst all involved actors.<br>&nbsp;&nbsp;&nbsp;
 
  
[[Image:Donts.jpg]]
+
#'''Simple uploading of files!'''<br/>Rather summarize relevant content in a wiki article or link directly to a file on another homepage as energypedia is not a file sharing platform.
 +
#'''Copy and paste!'''<br/>The advantage of energypedia is that it collects, summarizes and combines knowledge. Hence copy and paste of whole publications does not offer any additional value for energypedia readers (besides that it is probably an copyright violation). Rather ask yourself which parts of a publication are relevant and in which existing articles you might be able to integrate them (Don't forget to cite and reference correctly!).
 +
#'''Links to closed systems!'''<br/>If you link to a file, make sure that it is an open (password unprotected) website since otherwise energypedia users will not be able to access these documents.
 +
#'''Slang or colloquial language!'''<br/>Energypedia's claim is to offer quality information on renewable energies, do not let people think you have nothing important to tell by using sloppy expressions in your article.
 +
#'''Unspecific titles!'''<br/>An overly unspecific title makes it very difficult for readers to identify if an article is interesting for them or not.&nbsp;
 +
#'''Arbitrary content!'''<br/>Energypedia aims at compiling information on renewable energy and all related issue (for example, social and environmental impacts). So think first if your content fits on this platform.
 +
#'''Personal insults!'''<br/>Energypedia will not tolerate personal insults against other users or social groups in any form! Violations of this rule might lead to exclusion from energypedia!
 +
#'''Edit wars!'''<br/>The ability to change articles on energypedia is a core advantage over ordinary web pages, however it can cause so-called edit wars when editors disagree about content and repeatedly rewrite each other's contributions. Such a series of back-and-forth reverts is very unconstructive for the whole community and destroys the working atmosphere amongst its users. If you realize that there is disagreement about content, do not just re-edit but rather start a discussion to solve the dispute in a civilized manner.
  
#'''Simple uploading of files!'''<br>Rather&nbsp;summarize relevant content in a wiki article or link directly to a file on another homepage as energypedia is not a file sharing platform.
+
<br/>{{Help Magic Words}}
#'''Copy and paste!'''<br>The advantage of energypedia is that it collects, summarizes and combines knowledge. Hence copy and paste of whole publications does not offer any additional value for energypedia readers (besides that it is probably an copyright violation). Rather ask yourself which parts of a publication are relevant and in which existing articles you might be able to integrate them (Don't forget to cite and reference correctly!).
+
 
#'''Links to closed systems!'''<br>If you link to a file,&nbsp;make sure that&nbsp;it is an open (password unprotected)&nbsp;website since otherwise energypedia users will not be able to access these documents.
+
[[Category:Help]]
#'''"Further Readings" sections!'''<br>All important information should be included in wiki articles making "Further reading" obsolete.
 
#'''Complaints about poor content!'''<br>If you think that an article is incomplete or even incorrect then do not simply&nbsp;complain about it but help to improve energypedia's content: start a discussion about questionable statements or mark articles with one or more [[Maintenance boxes|'''maintenance boxes''']], edit existing articles or&nbsp;even create a new one on topics which have not yet been dealt with.
 
#'''Slang or colloquial language!'''<br>Energypedia's claim is to offer quality information on renewable energies, do not let people think you have nothing important to tell by using sloppy expressions in your article.
 
#'''Unspecific titles!'''<br>An overly unspecific title makes it very difficult for readers to identify if an article is interesting for them or not. Moreover, due to technical reasons,&nbsp;no articles can have an identitical&nbsp;title which makes specific enough article titles a necessity.
 
#'''Arbitrary content!'''<br>Energypedia aims at compiling information on renewable energy and all related issue (for example, social and environmental impacts). So think first if your content fits on this platform.
 
#'''Personal insults!'''<br>Energypedia will not tolerate personal insults against other users or social groups in any form!&nbsp;Violations of this rule might lead to exclusion from energypedia!
 
#'''Edit wars!'''<br>The ability to change articles on energypedia is a core advantage over ordinary web pages, however it can cause so-called edit wars when editors disagree about content and repeatedly rewrite each other's contributions. Such a series of back-and-forth reverts is very unconstructive for the whole&nbsp;community and destroys the working atmosphere amongst its users. If you realize that there is disagreement about content, do not just re-edit but rather start a discussion to solve the dispute in a civilized manner.
 

Latest revision as of 06:35, 1 December 2021

Do's

  1. Start writing!
    If you have practical information or experiences to share then just start writing a new article or edit an existing one. A wiki article will never be completed and is always work in progress, so do not think that your knowledge is not worth to be written down.
  2. Keep it short!
    Focus on the relevant information and avoid unnecessary empty phrases and passages like prefaces or acknowledgments. Instead of writing a long article rather try to split it into several interlinked shorter ones which will help the readers to quickly find the exact piece of information that they are looking for.
  3. Choose a precise title!
    Most users will find your article via a title search, so find a concise but meaningful title which reflects the article's subject as precise as possible.
  4. Structure your article!
    Give your article a useful structure by including headlines and bullet points.
  5. Design your article!
    Make your article visually more attractive for the reader by including informative tables, pictures and graphs.
  6. Link your articles!
    Instead of writing the same information again in your text (for example, definitions or procedures), simply link to existing articles which already explain the relevant point in detail. This will not only increase the information value of your article but also the likelihood of people finding it on energypedia.
  7. Categorize your article!
    All articles should be categorized with one or more category. This will help users to find your article and more generally will give energypedia an underlining structure.
  8. Keep editing articles!
    To continuously improve energypedia, its users have to fill content gaps, correct typing errors or change outdated information if they come across them. That is why editing articles is so important for the quality of a wiki.
  9. Be rational!
    While working collaboratively with others on an article you might disagree about some passages. Avoid constant reverting of other people's edits which will lead into edit wars. Rather start a discussion explaining your thinking and reasons for edits and allow others to response. Thereby keep in mind that you argue facts not personalities.
  10. Be polite!
    Above all, whatever you are doing - be it writing on somebody's wall or responding to a discussion - be always polite and treat your counterpart with respect. Even in disputes try to stay calm and work constructively towards agreement amongst all involved actors.

Dont's

  1. Simple uploading of files!
    Rather summarize relevant content in a wiki article or link directly to a file on another homepage as energypedia is not a file sharing platform.
  2. Copy and paste!
    The advantage of energypedia is that it collects, summarizes and combines knowledge. Hence copy and paste of whole publications does not offer any additional value for energypedia readers (besides that it is probably an copyright violation). Rather ask yourself which parts of a publication are relevant and in which existing articles you might be able to integrate them (Don't forget to cite and reference correctly!).
  3. Links to closed systems!
    If you link to a file, make sure that it is an open (password unprotected) website since otherwise energypedia users will not be able to access these documents.
  4. Slang or colloquial language!
    Energypedia's claim is to offer quality information on renewable energies, do not let people think you have nothing important to tell by using sloppy expressions in your article.
  5. Unspecific titles!
    An overly unspecific title makes it very difficult for readers to identify if an article is interesting for them or not. 
  6. Arbitrary content!
    Energypedia aims at compiling information on renewable energy and all related issue (for example, social and environmental impacts). So think first if your content fits on this platform.
  7. Personal insults!
    Energypedia will not tolerate personal insults against other users or social groups in any form! Violations of this rule might lead to exclusion from energypedia!
  8. Edit wars!
    The ability to change articles on energypedia is a core advantage over ordinary web pages, however it can cause so-called edit wars when editors disagree about content and repeatedly rewrite each other's contributions. Such a series of back-and-forth reverts is very unconstructive for the whole community and destroys the working atmosphere amongst its users. If you realize that there is disagreement about content, do not just re-edit but rather start a discussion to solve the dispute in a civilized manner.