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 "Guidelines on Writing a Good Article"

From energypedia
***** (***** | *****)
m (Ranisha moved page Help:Guidelines on Writing a Good Article to Guidelines on Writing a Good Article without leaving a redirect)
***** (***** | *****)
m
Line 28: Line 28:
 
== Main Part ==
 
== Main Part ==
  
The body of the article should be clustered into [[Help:Add Headings|different headings]].&nbsp;<br/>
+
The body of the article should be clustered into [[Add Headings|different headings]].&nbsp;<br/>
  
 
== Further Information ==
 
== Further Information ==
Line 38: Line 38:
 
In order to ensure a high quality of articles and avoid plagiarism, we highly encourage all our authors to add relevant references to their articles. Please include the author's name, year of publication, title of publication and link to it, if possible in the reference section.
 
In order to ensure a high quality of articles and avoid plagiarism, we highly encourage all our authors to add relevant references to their articles. Please include the author's name, year of publication, title of publication and link to it, if possible in the reference section.
  
-> For instructions on how to add references please see the article: "'''[[Help:Insert References|Inserting References]]'''".
+
-> For instructions on how to add references please see the article: "'''[[Insert References|Inserting References]]'''".
  
 
== Article Categories<br/> ==
 
== Article Categories<br/> ==
Line 45: Line 45:
  
 
*To see a list of categories used on energypedia, click '''[[Special:Categories|here]]'''.
 
*To see a list of categories used on energypedia, click '''[[Special:Categories|here]]'''.
*For help on how to categorise articles, please click '''[[Help:Categorize an Article|here]]'''.
+
*For help on how to categorise articles, please click '''[[Categorize an Article|here]]'''.
  
 
<br/>
 
<br/>
Line 51: Line 51:
 
== Article Length ==
 
== Article Length ==
  
Long articles are difficult to follow and the reader can easily get lost or confused. Therefore, please create short articles. In the case of a long articles, kindly break them into smaller short articles and '''[[Help:Link to an Article|link them to one another]]'''.
+
Long articles are difficult to follow and the reader can easily get lost or confused. Therefore, please create short articles. In the case of a long articles, kindly break them into smaller short articles and '''[[Link to an Article|link them to one another]]'''.
  
 
== Add Pictures ==
 
== Add Pictures ==
  
Pictures increase the aesthetics of the article and attracts users. Therefore, whenever possible, please add pictures to your article. Before adding the picture, kindly [[Help:Upload Pictures and Documents|upload it]] to energypedia and then [[Help:Insert Pictures or Documents|link to it]].&nbsp;
+
Pictures increase the aesthetics of the article and attracts users. Therefore, whenever possible, please add pictures to your article. Before adding the picture, kindly [[Upload Pictures and Documents|upload it]] to energypedia and then [[Insert Pictures or Documents|link to it]].&nbsp;
  
 
Kindly add the appropriate copyrights to the pictures and do not upload pictures where the copyrights are not clear.
 
Kindly add the appropriate copyrights to the pictures and do not upload pictures where the copyrights are not clear.
Line 67: Line 67:
 
Links also help to structure a wiki so that the individual articles do not get lost. On energypedia we usually distinguish between two types of links:
 
Links also help to structure a wiki so that the individual articles do not get lost. On energypedia we usually distinguish between two types of links:
  
#'''Internal Link: '''The first option is to [[Help:Link to an Article|link to another article]] or to [[Help:Link to a Headline|link to a particular headline]] in another or the same article, within energypedia. If you want to link to a file it needs to be [[Help:Upload Pictures and Documents|uploaded before]]. For instructions on linking to a file, click [[Help:Insert File as Picture / Link|here]].
+
#'''Internal Link: '''The first option is to [[Link to an Article|link to another article]] or to [[Link to a Headline|link to a particular headline]] in another or the same article, within energypedia. If you want to link to a file it needs to be [[Upload Pictures and Documents|uploaded before]]. For instructions on linking to a file, click [[Insert File as Picture / Link|here]].
#'''External Link: '''For instructions on linking to external websites, click&nbsp;[[Help:Link to an External Website|here.]]In case of external links, there is a small arrow next to the link.
+
#'''External Link: '''For instructions on linking to external websites, click&nbsp;[[Link to an External Website|here.]]In case of external links, there is a small arrow next to the link.
  
 
{| cellspacing="1" cellpadding="1" border="1" style="width: 100%"
 
{| cellspacing="1" cellpadding="1" border="1" style="width: 100%"
Line 79: Line 79:
 
{{Help Magic Words}}
 
{{Help Magic Words}}
  
[[Category:Help|{{PAGENAME}}]]
+
[[Category:Help]]

Revision as of 09:56, 8 November 2016


Article Theme

Energypedia is a wiki based platform for information on renewable energy, energy access and energy efficiency in the context of developing countries. Therefore, all articles on energypedia should fit in with the above mentioned themes.

Article Title and Headings

The title of the article should reflect the theme of the article. Kindly capitalise the first letter of all the main words in the article title as well as in the headlines. For example, instead of writing "energy source" as the article title, please write "Energy Source". 

Article Structure

A good article should have the following structure:

Overview

The "Overview" section in each article should give a short summary of the article so that other users can get an initial understanding of the article.

Main Part

The body of the article should be clustered into different headings

Further Information

This part should include links to other articles or relevant documents for additional information. 

References

In order to ensure a high quality of articles and avoid plagiarism, we highly encourage all our authors to add relevant references to their articles. Please include the author's name, year of publication, title of publication and link to it, if possible in the reference section.

-> For instructions on how to add references please see the article: "Inserting References".

Article Categories

To make your articles easily accessible to other energypedia users, don't forget to categorise them. Categories help to consolidate the articles into relevant themes, making it easier for other users to search and find them.

  • To see a list of categories used on energypedia, click here.
  • For help on how to categorise articles, please click here.


Article Length

Long articles are difficult to follow and the reader can easily get lost or confused. Therefore, please create short articles. In the case of a long articles, kindly break them into smaller short articles and link them to one another.

Add Pictures

Pictures increase the aesthetics of the article and attracts users. Therefore, whenever possible, please add pictures to your article. Before adding the picture, kindly upload it to energypedia and then link to it

Kindly add the appropriate copyrights to the pictures and do not upload pictures where the copyrights are not clear.

Integration Into the Wiki Structure

Links (External/Internal)

Links are especially useful to other users who may want to get further information on a topic. They help to make an article short and precise by interlinking between articles and not repeating the information available elsewhere.

Links also help to structure a wiki so that the individual articles do not get lost. On energypedia we usually distinguish between two types of links:

  1. Internal Link: The first option is to link to another article or to link to a particular headline in another or the same article, within energypedia. If you want to link to a file it needs to be uploaded before. For instructions on linking to a file, click here.
  2. External Link: For instructions on linking to external websites, click here.In case of external links, there is a small arrow next to the link.

Example
According to the World Health Organization (WHO) as many as 1.6 million people die each year as a result of it. This can be compared with one death every 20 seconds.