|
|
| (4 intermediate revisions by one user not shown) |
| Line 3: |
Line 3: |
| | |:Main_Page|Go to the Main Page | | |:Main_Page|Go to the Main Page |
| | |:Help:Main_Page|Back to the Help Portal | | |:Help:Main_Page|Back to the Help Portal |
| − | }} | + | }}<br/> |
| | | | |
| | <br/> | | <br/> |
| | | | |
| − | == <span class="mw-headline" id="Article_Theme">Article Theme </span> ==
| + | <br/> |
| | | | |
| − | 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.
| + | == Before starting to write an article<br/> == |
| | | | |
| − | == <span class="mw-headline" id="Article_Title_and_Headings">Article Title and Headings </span> ==
| + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | | | |
| − | 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'''".
| + | WOCATpedia aims to create easy access to knowledge and first-hand experience in Sustainable Land Management (SLM) and water management, in developing countries over the past few decades, and to the latest developments in this field.<br/> |
| | | | |
| − | == <span class="mw-headline" id="Article_Structure">Article Structure </span> ==
| + | <u>Thus, WOCATpedia consists of two main components in its initial phase:</u> |
| | | | |
| − | A good article should have the following structure: | + | *A collection of short articles: providing an overview on sustainable land and water management in development cooperation, with references to documents for further study and links to WOCATpedia’s own library<br/> |
| | + | *WOCATpedia's library: a collection of documents on sustainable land and water management in development cooperation, with abstracts and keywords<br/> |
| | | | |
| − | *'''[[Guidelines_on_Writing_a_Good_Article|Overview / Introduction]]''' | + | <br/> |
| − | *'''[[Guidelines_on_Writing_a_Good_Article|Main Part]]''' | + | |
| − | *'''[[Guidelines_on_Writing_a_Good_Article|Further Information]]''' | + | == General considerations<br/> == |
| − | *'''[[Guidelines_on_Writing_a_Good_Article|References]] '''(please use appropriate references within your article) | + | |
| − | *'''[[Guidelines_on_Writing_a_Good_Article|Categories]] '''(categorise your articles according to the theme of the article)<br/> | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span> |
| | + | |
| | + | *WOCATpedia is a sort of a specialised encyclopaedia. It is neither an in-depth academic text-book nor a manual for SLM.<br/> |
| | + | *Articles are to create an overview of the different topics of SLM.<br/> |
| | + | *Articles should also provide an easy access to the primary specialist documentation and should list sources where further details, which cannot be presented in the article, can be found. Research what documents and resources are available in the specific area you are overviewing, and propose relevant publications for the library. Please create links in your article to these sources. |
| | + | *Because of its orientation to development cooperation, an article should, whenever useful and possible, point to context-specific aspects and documents through which users can be informed on good practices and examples of work under specific climatic, socio-cultural or economic conditions. |
| | + | *The article should give inviting opportunity for others to share their approaches and experiences |
| | + | *Avoid large amounts of quantitative data. Presenting an overview means giving an idea of magnitude or scale, or a ‘bigger/smaller as’ comparison. |
| | + | *At the beginning of the article, the relation of the subject to climate change and food security should be highlighted. |
| | + | *Concrete examples or links to documents with country-specific examples (challenges, attempts, success factors, lessons learned) are useful. |
| | + | *Use graphics and other illustrations as a means to highlight the complexity of content (which also reduces/eliminates lengthy text passages). |
| | + | *An objective stile with a simple language should be used.<br/> |
| | + | |
| | + | <br/> |
| | + | |
| | + | == Priority users and aims of articles<br/> == |
| | + | |
| | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span> |
| | + | |
| | + | WOCATpedia focuses on two main types of users: generalists working in development organisations, and practitioners in development programmes. The first, generalists, are not necessarily experts in the field and may be in need of a concise overview on specific aspects of sustainable land and water management. They may be involved in planning or evaluation of development projects, in preparing and /or taking decisions, in understanding policy papers, etc. The second type of users are the practitioners, who have practical competences in specific aspects of water management in agriculture but seek a well-structured overview on ‘what else’ needs to be taken into consideration as they plan and work. From this overview, they can then choose to go into depth in specific areas and would value the practical applications found in studies or project descriptions in WOCATpedia documentation. The site- and context-specific information in sustainable land and water management documents, offered by WOCATpedia is of high value to the practitioner, and is thus an important aim of the platform.<br/>Other likely users are the general public, such as students, journalists, etc.<br/> |
| | + | |
| | + | <br/> |
| | + | |
| | + | <br/> |
| | + | |
| | + | == Writing a good article - general Guidelines<br/> == |
| | + | |
| | + | == Structure of articles<br/> == |
| | + | |
| | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span> |
| | + | |
| | + | All articles longer than one (web screen) page should have a short table of contents with keywords. |
| | + | |
| | + | <u>The main structure for an WOCATpedia article should be as follows:</u><br/> |
| | + | |
| | + | 1. Short definition of the subject – including a brief indication of the link to AWM. This should be written so that the reader can easily decide if they want to continue or not. The definition should not exceed 10 lines. |
| | + | |
| | + | 2. Table of contents – minimum of four points (including ‘references’ and ‘further reading’) |
| | + | |
| | + | 3. Introduction/background – why and how this subject is relevant to AWM |
| | + | |
| | + | 4. Main section – may be divided into several sub-sections, according to subject matter |
| | + | |
| | + | 5. Illustrations of related examples, if suitable |
| | + | |
| | + | 6. References – systematically integrating links to the primary source documentation of WOCATpedia (see below) |
| | + | |
| | + | 7. Further readings – books, articles, Internet pages, etc. which are not necessarily present in the WOCATpedia library |
| | + | |
| | + | An example of a typical overview-article structure can be found [[Water,_energy_and_food_nexus|here]] |
| | + | |
| | + | <br/> |
| | + | |
| | + | == Guidelines for length and format of articles == |
| | + | |
| | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | + | |
| | + | *Recommended length of article (if not defined differently, e.g. calls): 1.5 - 3 pages of text or 800 - 2500 words (not counting any graphics)<br/> |
| | + | *Use Arial font, size 11 |
| | + | *Integrate pictures and graphics within the text |
| | + | |
| | + | <br/> |
| | + | |
| | + | == <span class="mw-headline" id="Article_Title_and_Headings">Article Title and Headings</span><br/> == |
| | + | |
| | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | + | |
| | + | 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 "'''organic agriculture"''' as the article title, please write "'''Organic Agriculture'''". <br/> |
| | + | |
| | + | == <span class="mw-headline" id="Article_Structure">Article Structure</span><br/> == |
| | + | |
| | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | + | |
| | + | A good article should have the following structure:<br/> |
| | + | |
| | + | *'''Overview / Introduction'''<br/> |
| | + | *'''Main Part'''<br/> |
| | + | *'''Further Information'''<br/> |
| | + | *'''References '''(please use appropriate references within your article)<br/> |
| | + | *'''Categories '''(categorise your articles according to the theme of the article)<br/> |
| | + | |
| | + | == <span class="mw-headline" id="Overview">Overview</span><br/> == |
| | | | |
| − | == <span class="mw-headline" id="Overview">Overview </span> ==
| + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | | | |
| | 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. | | 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. |
| | | | |
| − | == <span class="mw-headline" id="Main_Part">Main Part </span> == | + | == <span class="mw-headline" id="Main_Part">Main Part</span><br/> == |
| | | | |
| − | The body of the article should be clustered into [[Add_Headings|Add Headings]]. <br/>
| + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | | | |
| − | == <span class="mw-headline" id="Further_Information">Further Information </span> == | + | The body of the article should be clustered into [[Help:Add_headlines|Add Headings]]. <br/> |
| | + | |
| | + | == <span class="mw-headline" id="Further_Information">Further Information</span><br/> == |
| | + | |
| | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | | | |
| | This part should include links to other articles or relevant documents for additional information. | | This part should include links to other articles or relevant documents for additional information. |
| | | | |
| − | == <span class="mw-headline" id="References">References</span> ==
| |
| | | | |
| − | 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: "'''[[Insert_References|Insert References]]'''".
| + | <br/> |
| | | | |
| | == <span class="mw-headline" id="Article_Categories">Article Categories</span><br/> == | | == <span class="mw-headline" id="Article_Categories">Article Categories</span><br/> == |
| | + | |
| | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | | | |
| | 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.<br/> | | 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.<br/> |
| | | | |
| − | *To see a list of categories used on energypedia, click '''[[Special:Categories|Special:Categories]]'''. | + | *To see a list of categories used on energypedia, click '''[[Special:Categories|Special:Categories]]'''.<br/> |
| − | *For help on how to categorise articles, please click '''[[Categorize_an_Article|Categorize an Article]]'''. | + | *For help on how to categorise articles, please click '''[[Help:Categorising_Articles|Categorise an Article]]'''.<br/> |
| | | | |
| | <br/> | | <br/> |
| | | | |
| − | == <span class="mw-headline" id="Article_Length">Article Length</span> == | + | == <span class="mw-headline" id="Article_Length">Article Length</span><br/> == |
| | | | |
| − | 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 to an Article]]'''.
| + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | | | |
| − | == <span class="mw-headline" id="Add_Pictures">Add Pictures</span> ==
| + | 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:Linking_to_Another_Article|Link to an Article]]'''.<br/> |
| | | | |
| − | 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 Pictures and Documents]] to energypedia and then [[Insert_Pictures_or_Documents|Insert Pictures or Documents]]. | + | == <span class="mw-headline" id="Add_Pictures">Add Pictures</span><br/> == |
| | + | |
| | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | + | |
| | + | 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:Uploading_Pictures_and_Documents|Upload Pictures and Documents]] to energypedia and then [[Help:Insert_File_as_Picture|Insert Pictures or Documents]]. <br/> |
| | | | |
| | 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. |
| | | | |
| | + | == <span class="mw-headline" id="References">References and quotations</span><br/> == |
| | + | |
| | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | + | |
| | + | 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.<br/> |
| | + | |
| | + | '''-> For instructions on how to add references please see the article: "[[Help:Insert_References|Insert References]]".'''<br/> |
| | + | |
| | + | All specific facts, examples and quotations should list the exact reference. Sources are indicated by footnotes. Attention should be paid to using a uniform and consistent format.<br/>Direct quotations should be marked in the following way:<br/> |
| | + | |
| | + | <br/> |
| | + | <p style="text-align: center">'''“Effective water use for food security under climate change is essential.”'''</p><p style="text-align: center"></p> |
| | + | <u>Example for listing of references:</u><br/> |
| | + | |
| | + | *GIZ (2011): Land Use Planning. Concept, tools and applications. |
| | + | *Millner, H. (1992): International theories of cooperation among nations. A review essay. In: World Politics, Edition 44, pp. 4-66. |
| | + | |
| | + | <br/> |
| | + | |
| | + | <u>Author/s of publications provided by institution should be included in the reference, if mentioned.</u> |
| | + | |
| | + | *GIZ/Petermann, T. (1993): Irrigation and the environment. A review of environment issues. Part I & II. |
| | + | |
| | + | If a publication is available online, provide the URL and include the date of access:<br/> |
| | + | |
| | + | *FAO (1986): Water lifting devices Irrigation. Irrigation and drainage Paper 43. [http://www.fao.org/docrep/010/ah810e/ah810e00.htm http://www.fao.org/docrep/010/ah810e/ah810e00.htm] [Access 2012-09-28] |
| | + | |
| | + | <br/> |
| | + | |
| | + | <u>If a website is used as a reference, provide the source as follows and include the date of access:</u> |
| | + | |
| | + | *GIZ: Rural development. www.giz.de/en/ourservices/rural_development.html [Access 2012-09-26]<br/> |
| | + | |
| | + | <br/> |
| | + | |
| | + | == Illustrations: pictures, graphics and tables == |
| | + | |
| | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | + | |
| | + | Include all pictures, graphics and tables directly in the text and provide references by footnotes. |
| | + | |
| | + | You can only insert files that have been uploaded to the WOCATpedia file list earlier (see guidelines for [[Upload_Publications|Upload Publications]]). |
| | + | |
| | + | <u>Files have to be named in the following way:</u> |
| | + | |
| | + | <u>Pictures:</u> |
| | + | |
| | + | *Women weeding grass in Mali, 2007, Guenther, N. |
| | + | *Women weeding grass in Peru, 1986, FAO |
| | + | |
| | + | <u>Graphics and tables:</u> |
| | + | |
| | + | *Dimensions of water use, 1982, FAO |
| | + | *Dimensions of food security, 1998, Guenther, N. modified after UNICEF |
| | + | *Dimensions of climate change, 2004, Guenther, N.<br/> |
| | + | <br/> |
| | == <span class="mw-headline" id="Integration_Into_the_Wiki_Structure">Integration Into the Wiki Structure</span><br/> == | | == <span class="mw-headline" id="Integration_Into_the_Wiki_Structure">Integration Into the Wiki Structure</span><br/> == |
| | | | |
| | == <span class="mw-headline" id="Links_.28External.2FInternal.29">Links (External/Internal)</span><br/> == | | == <span class="mw-headline" id="Links_.28External.2FInternal.29">Links (External/Internal)</span><br/> == |
| | + | |
| | + | <span style="color:#D3D3D3">'''_____________________________________________________________________________________________'''</span><br/> |
| | | | |
| | 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 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. |
| Line 70: |
Line 218: |
| | 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 [[Link_to_an_Article|Link to an Article]] or to [[Link_to_a_Headline|Link to a 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|Upload Pictures and Documents]]. For instructions on linking to a file, click [[_Link|Insert File as Picture / Link]]. | + | #'''Internal Link: '''The first option is to [[Help:Linking to Another Article|Link to an Article]] or to [[Help:Link to a Headline|Link to a Headline]] in another or the same article, within energypedia. If you want to link to a file it needs to be [[Help:Uploading Pictures and Documents|Upload Pictures and Documents]]. For instructions on linking to a file, click [[Help:Insert File as Picture|Insert File as Picture / Link]]. |
| − | #'''External Link: '''For instructions on linking to external websites, click [[Link_to_an_External_Website|Link to an External Website]]In case of external links, there is a small arrow next to the link. | + | #'''External Link: '''For instructions on linking to external websites, click link to an external website. In case of external links, there is a small arrow next to the link. |
| | | | |
| | '''Example'''<br/><span style="line-height: 1.5em; font-size: 13.6px">According to the </span>'''World Health Organization ([http://www.who.int/en/ WHO]) '''<span style="line-height: 1.5em; font-size: 13.6px">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.</span> | | '''Example'''<br/><span style="line-height: 1.5em; font-size: 13.6px">According to the </span>'''World Health Organization ([http://www.who.int/en/ WHO]) '''<span style="line-height: 1.5em; font-size: 13.6px">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.</span> |
| Line 77: |
Line 225: |
| | <br/>__NOAUTHORLIST__ __noeditsection__ </div> | | <br/>__NOAUTHORLIST__ __noeditsection__ </div> |
| | | | |
| − | [[Category:Help]]
| |
| | [[Category:Basics]] | | [[Category:Basics]] |
| | + | [[Category:Help]] |
WOCATpedia aims to create easy access to knowledge and first-hand experience in Sustainable Land Management (SLM) and water management, in developing countries over the past few decades, and to the latest developments in this field.
WOCATpedia focuses on two main types of users: generalists working in development organisations, and practitioners in development programmes. The first, generalists, are not necessarily experts in the field and may be in need of a concise overview on specific aspects of sustainable land and water management. They may be involved in planning or evaluation of development projects, in preparing and /or taking decisions, in understanding policy papers, etc. The second type of users are the practitioners, who have practical competences in specific aspects of water management in agriculture but seek a well-structured overview on ‘what else’ needs to be taken into consideration as they plan and work. From this overview, they can then choose to go into depth in specific areas and would value the practical applications found in studies or project descriptions in WOCATpedia documentation. The site- and context-specific information in sustainable land and water management documents, offered by WOCATpedia is of high value to the practitioner, and is thus an important aim of the platform.
Other likely users are the general public, such as students, journalists, etc.
All articles longer than one (web screen) page should have a short table of contents with keywords.
1. Short definition of the subject – including a brief indication of the link to AWM. This should be written so that the reader can easily decide if they want to continue or not. The definition should not exceed 10 lines.
2. Table of contents – minimum of four points (including ‘references’ and ‘further reading’)
3. Introduction/background – why and how this subject is relevant to AWM
4. Main section – may be divided into several sub-sections, according to subject matter
5. Illustrations of related examples, if suitable
6. References – systematically integrating links to the primary source documentation of WOCATpedia (see below)
7. Further readings – books, articles, Internet pages, etc. which are not necessarily present in the WOCATpedia library
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 "organic agriculture" as the article title, please write "Organic Agriculture".
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.
This part should include links to other articles or relevant documents for additional information.
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.
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.
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 to energypedia and then Insert Pictures or Documents.
Kindly add the appropriate copyrights to the pictures and do not upload pictures where the copyrights are not clear.
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.
All specific facts, examples and quotations should list the exact reference. Sources are indicated by footnotes. Attention should be paid to using a uniform and consistent format.
Direct quotations should be marked in the following way:
If a publication is available online, provide the URL and include the date of access:
Include all pictures, graphics and tables directly in the text and provide references by footnotes.
You can only insert files that have been uploaded to the WOCATpedia file list earlier (see guidelines for Upload Publications).
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:
