Difference between revisions of "How to Start an Article"

From Howtopedia - english
Jump to: navigation, search
('''Categories:''')
 
(76 intermediate revisions by 10 users not shown)
Line 1: Line 1:
'''AFTER CREATING OR CHOOSING A TARGET ARTICLE FROM THE MAIN CHAPTERS, COPY THIS ARTICLE WITH ITS SYNTAX FROM THE EDITING WINDOW (CLICK ON EDIT ABOVE THE ARTICLE) AND PASTE IT IN THE EDITING WINDOW OF YOUR FUTURE ARTICLE.'''
+
The objective of howtopedia is the collection, translation and promotion of high quality practical information focussing on essential simple technologies and knowledge for development:
'''PLEASE DO YOUR FIRST TRY IN THE [[sandbox|SANDBOX]]'''
+
*'''Simple technologies''' that can be achieved at minimal cost, use local materials, require minimal skills, are easy to understand and maintain, protect the environment, and comply with the principle of sustainability;
 +
*'''Practical knowledge''' is knowledge that is concrete, solution-oriented, field related and helps users to acquire new skills. <br>
 +
The scope of howtopedia reaches from rural to urban development: agriculture, water, energy, waste management, construction, small businesses, community, education, and health information.<br>
 +
 
 +
If you would like to take part in the project:<br>
 +
 
 +
# Please apply by filling in the form [[Special:ApplicationForm|here]] or contact us at info (@) howtopedia.org with your name, qualification, affiliated organisation or article proposal to receive a user name and password. We will be happy to answer your questions and to suggest ways and topics where you can help.
 +
# Browse through the library and check if there are already articles on similar topics, and evaluate whether it is necessary to create a new article, or whether it would be better to edit and add information to an existing article.
 +
# Alternatively, go to the category [[:Category:Stub|Stub]] to find articles that are in need of improvements.
 +
# After creating or choosing a target article from the main chapters, copy this article with its syntax from the editing window (click on edit above the article) and paste it in the editing window of your future article.''' <br>
 +
# Don't forget to save the article before quitting the editing window!
 +
# Please subscribe to the email notification of modifications by clicking on the watch button, above right.
 +
 
 +
 
 +
 
 +
 +
<center> '''PLEASE DO YOUR FIRST TRY IN THE [[sandbox|SANDBOX]]''' </center><br>
 +
 
 +
 
  
 
{{stub}}
 
{{stub}}
Line 17: Line 35:
  
 
==Description==
 
==Description==
Write here the description of the technology and the steps to achieve the goal. It should be recipe like.
+
Write here the description of the technology and the steps needed to achieve the goal. It should be recipe like, instructional in nature.
If there are several possibilities to do the same thing, think about dividing the article: Maybe there are even so many different possibilities that this technology needs a special section.
+
If there are several possible approaches to achieve the same outcome or activity, think about dividing the article. In the instance where there are so many different possibilities, it may well be that this technology needs a special section of its own.
Try to be as clear as possible, use relatively simple terms or give the definition of complicated words: Not everybody who reads (or writes) English is a native speaker!
+
Try to be as clear as possible, use relatively simple terms, or give the definition of complicated words: not everybody who reads (or writes) English is a native speaker!
 +
 
  
 
==Difficulties==
 
==Difficulties==
Don't forget pointing out difficulties, even potential dangers if they exist.
+
Don't forget to point out any difficulties, even potential dangers if they exist.
 
*Are there some parts that can't be replaced? Are there some difficult manoeuvres?
 
*Are there some parts that can't be replaced? Are there some difficult manoeuvres?
*Some difficulties might appear with the new good or the new common good, try to address such themes as management of the new good, repairs, acceptance and reaction of the community. Does the technology ask for a cultural change?  
+
*Some difficulties might appear with the new good or the new common good; try to address such themes as management of the new good, repairs, acceptance and reaction of the community. Does the technology ask for a cultural change?  
*If you think an information needs a special attention and should be diffused only under certain circumstances, consider:
+
*If you think any information needs special attention and should be distributed only under certain circumstances, consider:
# Not diffusing it at all,
+
# Not distributing it at all; and/or
# Warn us about the potential danger of one article at warn@howtopedia.org,
+
# Warning us about the potential dangers of an article at warn@howtopedia.org.
# Ask to have an article protected at protect@howtopedia.org.
 
  
 
==Success Story==
 
==Success Story==
Are important because they illustrate how a technology or a know-how have been adopted by some people and how they changed their lives. The story should be real and also show the difficulties that had to be overwhelmed. You are not selling a product, you are trying to give someone tools so he can decide if a technology is an appropriate solution to his problem or not.
+
Success stories are very important because they illustrate precisely how a technology or know-how have been adopted by certain people and can demonstrate the ways in which the technology or know-how have changed people's lives. The story should be genuine and must also show the challenges that had to be overcome. Remember that you are '''not''' selling a product; rather, you are trying to give someone the tools so that each person can decide if a technology is an appropriate solution to their problem or not.
  
 
==Plans, Illustrations, Posters==
 
==Plans, Illustrations, Posters==
Try to have the clearest illustrations possible, imagine them being photocopied 5 times and what's left of them. The best would be black and white line drawings.  
+
*Try to provide the clearest illustrations possible. Imagine them being photocopied 5 times and what's left of them after that! The best illustrations and diagrams are well drawn or computer made black and white line drawings.  
Have letters on the illustrations to make legends in several languages possible.
+
*Place letters on the illustrations to provide legends. Please aim to do this in several languages possible, or provide universally understood symbols.
Try to have precise plans, but keep in mind one should be able to adapt the design to it's possibilities.
+
*Try to provide precise plans, but keep in mind a reader should be able to adapt the design to various possible methods.
Ask yourself if a poster that could communicate the know-how would be relevant. Let some space for traductions in local languages, or make two versions of the poster.
+
*Ask yourself if a poster might be a good means for communicating the know-how. Leave some space for translations of the poster into local languages, or make a blank version of the poster.
We will try to raise a community of illustrators to help by the illustrations, but try to make at least a scheme for the start, so that this scheme can be later refined.
+
*We will try to raise a community of illustrators to help by the illustrations, but try to make at least a template for the start, so that this template can be later refined as required.
  
[[Image:Rainwater-harvesting.png|Rainwater harvesting]]
+
[[file:Rainwater-harvesting.png|Rainwater harvesting]]
[[Image:Rainwater-harvesting.png|center|400px|Rainwater harvesting]]
+
[[file:Rainwater-harvesting.png|center|400px|Rainwater harvesting]]
[[Image:Rainwater-harvesting.png|center|thumb|200px|Rainwater harvesting]]
+
[[file:Rainwater-harvesting.png|center|thumb|200px|Rainwater harvesting]]
  
  
helptopic on images: [http://www.mediawiki.org/wiki/Help:Images]
+
Help topic on images: [http://www.mediawiki.org/wiki/Help:Images]
  
 
==Contacts==
 
==Contacts==
They are the real people behind the technologies. That is to say You. It is important not to leave the technologies "alone", BUT don't give the contact information of someone you don't know and who didn't give his or her permission to do so.
+
There are the real people behind the technologies. That is to say ''you''. It is important to us that the technologies are not left "alone", but that visitors are able to have a chance to contact a specialist to follow up more specific information and to have their questions answered. This makes it important that you are willing to provide accessible contact details.
 +
 
 +
==Reference==
 +
You can find the original of this article at [http://www.xy.za/asdfghjkl.pdf asdfghjkl.pdf] <br>
 +
This article also refers to [http://www.xy.za/asdfghjkl.pdf asdfghjkl 2.pdf] <br>
 +
 
 +
==Contributions==
 +
This Article was initiated by [[User:Maud|Maud]] 09:16, 13 July 2009 (UTC), howtopedia. <br>
 +
M. Mitch, 13:40, Jan 14, 2009 (UTC) <br>
 +
V. Vople, 13:40, Jan 14, 2010 (UTC) <br>
 +
J. Johnson, 13:40, Jan 14, 2011 (UTC) <br>
 +
F. Tepper, [[User:Flickety|Flickety]] 07:44, 18 November 2009 (UTC)<br>
 +
 
 +
 
 +
You should sign your comment:
 +
*appending four tildes (<nowiki>~~~~</nowiki>) to the comment so as to add your user name plus date/time: [[User:Patricia|Patricia Zhang]] 13:40, Jan 14, 2007 (UTC)
 +
*Adding three tildes (<nowiki>~~~</nowiki>) will add just your user name: [[User:Patricia|Patricia Zhang]]
 +
 
 +
'''Important:''' Please click the '''watch''' button (above the article, next to Edit) to be informed per E-mail about possible changes done to your contribution.
  
 
==Links==
 
==Links==
Don't give too many links, try to give quality, not quantity. Choose them carefully as being real reference links for the technology you are presenting.
+
Don't add too many links (we are not aiming to be a "link farm"). Instead, try to provide quality links over quantity of links. Choose links carefully, to ensure that they are real reference links for the technology you are presenting, links that enhance the information you have provided.
  
==Bibliography==
 
The same as for the links.
 
If you have a very good bibliography, though, don't hesitate to create a separate article, specified as a bibliography, with links and books.
 
  
 
==Related articles==
 
==Related articles==
Mention here the other howtopedia articles that relate to the subject.
+
* Mention here the other howtopedia articles that relate to the subject.
Name them exactly the same as the original title so that redirection functions.
+
Name them exactly the same as the original title so that redirection functions.<br>
 +
* And link your article to its translation in another language: <nowiki>[[fr:Modèle]]</nowiki> this will appear in the left side bar.
 +
 
 +
==Categories==
 +
* Add or choose from those categories (that is to say, one or more themes for which this article is relevant), so that it can be recognized in these [[categories]], and quickly found by users.
 +
Write them this way <nowiki>[[category:Example]]</nowiki>.
 +
* If you create a new category, please add it here in this template article, so that the new category can be used by others.
 +
 
 +
 
 +
[[Category:Stub]]
 +
 
 +
[[Category:Agriculture]] [[Category:Urban Agriculture]] [[Category:Biogas]] [[Category:Cattle]] [[Category:Farming]] [[Category:Commercial]] [[Category:Communication]] [[Category:Community]] [[Category:Composting]] [[Category:Computer]] [[Category:Construction]] [[Category:Cooking]] [[Category:Cooling]] [[Category:Crops]] [[Category:Crisis Management]] [[Category:Energy]] [[Category:Education]] [[Category:Equipment Design]][[Category:Fertilizer]] [[Category:Food Poisoning and its Prevention]] [[Category:Food Processing]] [[Category:Forest]][[Category:Fruits]] [[Category:Health]] [[Category:Heating]] [[Category:Hygiene]] [[Category:Ideas]] [[Category:Insects]]  [[Category:Informatics]] [[Category:Mechanics]] [[Category:Pest control]] [[Category:Pollution]] [[Category:Prevention]] [[Category:Products]] [[Category:Pumps]][[Category:Recycling]] [[Category:Resource Management]] [[Category:Sanitation]] [[Category:Small Business]] [[Category:Small Industry]] [[Category:Soil]] [[Category:Run-Off]] [[Category:Transportation]] [[Category:Tree]] [[Category:Vegetables]] [[Category:Waste]] [[Category:Water]] [[Category:Water harvesting]] [[Category:Water purification]] [[Category:Irrigation]] [[Category:Sun]] [[Category:Wind]] [[Category:Sea]] [[Category:Fishing]] [[Category:Biodiversity]]
 +
 
 +
[[Category:Dangerous]] [[Category:Difficult]] [[Category:High Technology]] [[Category:Medium]] [[Category:Easy to Medium]] [[Category:Easy]]
 +
 
 +
[[Category:Global Technology]] [[Category:Local Technology]] [[Category:Arid Climate]] [[Category:Forest Environment]] [[Category:Global]] [[Category:Mediterranean Climate]] [[Category:Monsoon Climate]] [[Category:Montaneous Environment]] [[Category:Coastal Area]] [[Category:Lakes and Rivers]] [[Category:Rural Environment]] [[Category:Temperate Climate]] [[Category:Tropical Climate]] [[Category:Urban Environment]]
 +
 
 +
[[Category:Between 50 and 200 US$]]  [[Category:Less than 10 US$]] [[Category:Less than 50 US$]] [[Category:More than 200 US$]]
 +
 
 +
[[Category:Ashes]] [[Category:Banana]] [[Category:Biogas]] [[Category:Bricks]]
 +
[[Category:Cardboard]] [[Category:Cashew nut]] [[Category:Clay]] [[Category:Cement]] [[Category:Coal]] [[Category:Charcoal]] [[Category:Chillies]] [[Category:Coffee]] [[Category:Compost]] [[Category:Computer]] [[Category:Concrete]] [[Category:Cow dung]] [[Category:Flooding]] [[Category:Fuel]]  [[Category:Food Poisoning and its Prevention]] [[Category:Garlic]] [[Category:Glass]] [[Category:Kaolin]] [[Category:Lime]] [[Category:Manure]] [[Category:Milk]] [[Category:Mobile Phone]] [[Category:Peanut]] [[Category:Oil]] [[Category:Onions]]  [[Category:Paper]] [[Category:Plastic container]] [[Category:Pozzolanas]][[Category:Rainy season]] [[Category:Rice Husk]] [[Category:Salt]] [[Category:Sand]] [[Category:Sawdust]] [[Category:Seeds]] [[Category:Seedlings]] [[Category:Straw]] [[Category:Soya]] [[Category:Tea]] [[Category:Termites]] [[Category:Tomato]] [[Category:Tourism]]  [[Category:Tyres]] [[Category:Vetiver]] [[Category:Wood]] [[Category:Wool]] [[Category:Worms]] [[Category:Fly Ash]]  [[Category:One Person and more]] [[Category:Between 2 and 5 People]]
 +
[[Category:More than 5 Persons]] [[Category:More than 5 People]] [[Category:One Person]] [[Category:Up to 5 Persons]]
 +
[[Category:Household]] [[Category:Village]][[Category:Neighbourhood]] [[Category:School]]
 +
 +
[[Category:Application]] [[Category:Principles]] [[Category:Commercial]]
 +
 
  
=='''Categories:'''==
+
[[Category:Administration]] [[Category:Howtopedia requested articles]] [[Category:Howtopedia requested drawings]] [[Category:Howtopedia requested images]] [[Category:Pages listed for deletion]] [[Category:Permanently protected]] [[Category:Requested translation]] [[Category:Stub]] [[Category:Spell Check]]  
Mention the category, that is to say one or more themes for which this article is relevant, so that it can be recognized in these [[categories]], and quickly found by users.
 
Write them this way <nowiki>[[category:Example]]</nowiki>
 
[[Category:Example]] [[Category:Stub]]
 
  
[[Category:Agriculture]] [[Category:Biogas]] [[Category:Commercial]] [[Category:Communication]] [[Category:Community]] [[Category:Composting]] [[Category:Computer]] [[Category:Construction]] [[Category:Cooking]] [[Category:Cooling]] [[Category:Crisis Management]] [[Category:Energy]] [[Category:Equipment Design]] [[Category:Food Poisoning and its Prevention]] [[Category:Food Processing]] [[Category:Forest]] [[Category:Health]] [[Category:Heating]] [[Category:Hygien]] [[Category:Ideas]] [[Category:Informatics]] [[Category:Mecanics]] [[Category:Mechanics]] [[Category:Pest control]] [[Category:Pollution]] [[Category:Prevention]] [[Category:Products]] [[Category:Recycling]] [[Category:Sanitation]] [[Category:Small Business]] [[Category:Soil]] [[Category:Transportation]] [[Category:Waste]] [[Category:Water]]  
+
[[Category:Requested translation to Spanish]]  
 +
[[Category:Requested translation to French]]  
 +
[[Category:Requested translation to English]]  
 +
[[Category:Requested translation to Bangla]]  
  
[[Category:Dangerous]] [[Category:Difficult]] [[Category:Easy]] [[Category:High Technology]] [[Category:Medium]]
+
[[Category:Requested translation to Javanese]]  
 +
[[Category:Requested translation to Madarin]]  
 +
[[Category:Requested translation to Russian]]  
 +
[[Category:Requested translation to Swahili]]  
 +
[[Category:Requested translation to Tamil]]  
  
[[Category:Global Technology]] [[Category:Local Technology]] [[Category:Arid Climate]] [[Category:Forest Environment]] [[Category:Global]] [[Category:Mediterranean Climate]] [[Category:Monsoon Climate]] [[Category:Montaneous Environment]] [[Category:Rural Environment]] [[Category:Temperate Climate]] [[Category:Tropical Climate]] [[Category:Urban Environment]]
 
  
[[Category:Between 50 and 200 US$]] [[Category:Less than 10 US $]] [[Category:Less than 10 US$]] [[Category:Less than 50 US$]] [[Category:More than 200 US$]]
+
[[Category:Requested maps]] [[:Category:Image editing]][[Category:Requested definitions]]
  
[[Category:Ashes]] [[Category:Banana]] [[Category:Cardboard]] [[Category:Clay]] [[Category:Coffee]] [[Category:Cow dung]] [[Category:Garlic]] [[Category:Glass]] [[Category:Manure]] [[Category:Oil]] [[Category:Paper]] [[Category:Plastic container]] [[Category:Sawdust]] [[Category:Seeds]] [[Category:Seedlings]] [[Category:Straw]] [[Category:Vetiver]] [[Category:Wool]]
+
[[Category:Practical Action]] [[Category:Practical Action Update]] [[Category:Practical Action Spanish]]
[[Category:More than 5 Persons]] [[Category:One Person]] [[Category:Up to 5 Persons]]
 
[[Category:Application]] [[Category:Principles]]  
 
  
[[Category:Administration]] [[Category:Howtopedia requested articles]] [[Category:Howtopedia requested drawings]] [[Category:Howtopedia requested images]] [[Category:Pages listed for deletion]] [[Category:Permanently protected]]
+
[[ar:كيف ابدأ المقالة]]
 +
[[de:Neuen Artikel]]
 +
[[es:Cómo empezar]]
 +
[[en:How to Start an Article]]
 +
[[fr:Modèle]]
 +
[[hi:केसे करने के लिये]]
 +
[[pt:Como começar um artigo]]

Latest revision as of 18:04, 27 August 2010

The objective of howtopedia is the collection, translation and promotion of high quality practical information focussing on essential simple technologies and knowledge for development:

  • Simple technologies that can be achieved at minimal cost, use local materials, require minimal skills, are easy to understand and maintain, protect the environment, and comply with the principle of sustainability;
  • Practical knowledge is knowledge that is concrete, solution-oriented, field related and helps users to acquire new skills.

The scope of howtopedia reaches from rural to urban development: agriculture, water, energy, waste management, construction, small businesses, community, education, and health information.

If you would like to take part in the project:

  1. Please apply by filling in the form here or contact us at info (@) howtopedia.org with your name, qualification, affiliated organisation or article proposal to receive a user name and password. We will be happy to answer your questions and to suggest ways and topics where you can help.
  2. Browse through the library and check if there are already articles on similar topics, and evaluate whether it is necessary to create a new article, or whether it would be better to edit and add information to an existing article.
  3. Alternatively, go to the category Stub to find articles that are in need of improvements.
  4. After creating or choosing a target article from the main chapters, copy this article with its syntax from the editing window (click on edit above the article) and paste it in the editing window of your future article.
  5. Don't forget to save the article before quitting the editing window!
  6. Please subscribe to the email notification of modifications by clicking on the watch button, above right.



PLEASE DO YOUR FIRST TRY IN THE SANDBOX


This article is a draft. It was just started and needs further work.


How To .....

Short Description

  • Problem:
  • Idea:
  • Difficulty:
  • Price Range:
  • Material Needed:
  • Geographic Area:
  • Competencies:
  • How Many people?
  • How Long does it take?

Description

Write here the description of the technology and the steps needed to achieve the goal. It should be recipe like, instructional in nature. If there are several possible approaches to achieve the same outcome or activity, think about dividing the article. In the instance where there are so many different possibilities, it may well be that this technology needs a special section of its own. Try to be as clear as possible, use relatively simple terms, or give the definition of complicated words: not everybody who reads (or writes) English is a native speaker!


Difficulties

Don't forget to point out any difficulties, even potential dangers if they exist.

  • Are there some parts that can't be replaced? Are there some difficult manoeuvres?
  • Some difficulties might appear with the new good or the new common good; try to address such themes as management of the new good, repairs, acceptance and reaction of the community. Does the technology ask for a cultural change?
  • If you think any information needs special attention and should be distributed only under certain circumstances, consider:
  1. Not distributing it at all; and/or
  2. Warning us about the potential dangers of an article at warn@howtopedia.org.

Success Story

Success stories are very important because they illustrate precisely how a technology or know-how have been adopted by certain people and can demonstrate the ways in which the technology or know-how have changed people's lives. The story should be genuine and must also show the challenges that had to be overcome. Remember that you are not selling a product; rather, you are trying to give someone the tools so that each person can decide if a technology is an appropriate solution to their problem or not.

Plans, Illustrations, Posters

  • Try to provide the clearest illustrations possible. Imagine them being photocopied 5 times and what's left of them after that! The best illustrations and diagrams are well drawn or computer made black and white line drawings.
  • Place letters on the illustrations to provide legends. Please aim to do this in several languages possible, or provide universally understood symbols.
  • Try to provide precise plans, but keep in mind a reader should be able to adapt the design to various possible methods.
  • Ask yourself if a poster might be a good means for communicating the know-how. Leave some space for translations of the poster into local languages, or make a blank version of the poster.
  • We will try to raise a community of illustrators to help by the illustrations, but try to make at least a template for the start, so that this template can be later refined as required.

Rainwater harvesting

Error creating thumbnail: File missing
Error creating thumbnail: File missing
Rainwater harvesting


Help topic on images: [1]

Contacts

There are the real people behind the technologies. That is to say you. It is important to us that the technologies are not left "alone", but that visitors are able to have a chance to contact a specialist to follow up more specific information and to have their questions answered. This makes it important that you are willing to provide accessible contact details.

Reference

You can find the original of this article at asdfghjkl.pdf
This article also refers to asdfghjkl 2.pdf

Contributions

This Article was initiated by Maud 09:16, 13 July 2009 (UTC), howtopedia.
M. Mitch, 13:40, Jan 14, 2009 (UTC)
V. Vople, 13:40, Jan 14, 2010 (UTC)
J. Johnson, 13:40, Jan 14, 2011 (UTC)
F. Tepper, Flickety 07:44, 18 November 2009 (UTC)


You should sign your comment:

  • appending four tildes (~~~~) to the comment so as to add your user name plus date/time: Patricia Zhang 13:40, Jan 14, 2007 (UTC)
  • Adding three tildes (~~~) will add just your user name: Patricia Zhang

Important: Please click the watch button (above the article, next to Edit) to be informed per E-mail about possible changes done to your contribution.

Links

Don't add too many links (we are not aiming to be a "link farm"). Instead, try to provide quality links over quantity of links. Choose links carefully, to ensure that they are real reference links for the technology you are presenting, links that enhance the information you have provided.


Related articles

  • Mention here the other howtopedia articles that relate to the subject.

Name them exactly the same as the original title so that redirection functions.

  • And link your article to its translation in another language: [[fr:Modèle]] this will appear in the left side bar.

Categories

  • Add or choose from those categories (that is to say, one or more themes for which this article is relevant), so that it can be recognized in these categories, and quickly found by users.

Write them this way [[category:Example]].

  • If you create a new category, please add it here in this template article, so that the new category can be used by others. Category:Image editing