Difference between revisions of "Policy"

From Recidemia
Jump to: navigation, search
(→‎Recipe Policy)
Line 1: Line 1:
−
{{cooknav}}
+
This page describes policies for pages in this wiki.
  
−
This page describes policies for pages in the [[Cookbook]]. It is a "living document" so it will change over time to reflect the standards created by Cookbook [[Cookbook:Contributors|contributors]].
+
==References==
−
 
 
−
==Recipe Policy==
 
 
Each recipe requires a title, followed by at least two notable references and then a sentence or two describing the recipe.  Recipe pages should not contain the history of a recipe or any other editorials.  After the description, the list of ingredients must be shown followed by the instructions.  Links to ingredients should be links to the page on Wikipedia not a local version.  Next should be links to the recipes of notable variations with a quick summary of each variation.  This is then followed by the references, a link to the relevant  Wikipedia pages and then External Links.
 
Each recipe requires a title, followed by at least two notable references and then a sentence or two describing the recipe.  Recipe pages should not contain the history of a recipe or any other editorials.  After the description, the list of ingredients must be shown followed by the instructions.  Links to ingredients should be links to the page on Wikipedia not a local version.  Next should be links to the recipes of notable variations with a quick summary of each variation.  This is then followed by the references, a link to the relevant  Wikipedia pages and then External Links.
−
 
  
 
Generally speaking, for a given food, there should be only one recipe per locale per language and the recipe need to be self-contained.  Exceptions include variations where an ingredient is optional or substituted but the instructions and other portions remain exactly the same as the original recipes.
 
Generally speaking, for a given food, there should be only one recipe per locale per language and the recipe need to be self-contained.  Exceptions include variations where an ingredient is optional or substituted but the instructions and other portions remain exactly the same as the original recipes.
  
 
==Recipe Formatting==
 
==Recipe Formatting==
−
Recipes should be formatted according to the [[Cookbook:Policy/Recipe template|recipe template]].
+
Recipes should be formatted according to the [[Policy/Recipe template|recipe template]].
  
 
== Pages needing work ==
 
== Pages needing work ==
Line 22: Line 19:
  
 
==== Name ====
 
==== Name ====
−
Recipes should be named according to their traditional name, their origin, or their ingredients. Avoid naming recipes for people, unless it is a well-known recipe by that name.  
+
Recipes should be named according to their name as per the references.
  
−
Recipes with a non-English name that have a common English name should be named with their common English name. For example, the primary name for [[Cookbook:Khaeng Keaw Wan]] should be [[Cookbook:Thai Green Curry]]. If necessary or desired a redirect from the name in the original language can be created. In cases where the non-English name is the common name, that name should be used, as in [[Cookbook:Huevos Rancheros]].
+
Recipes with a non-English name that have a common English name should be named with their common English name. For example, the primary name for [[Khaeng Keaw Wan]] should be [[Thai Green Curry]]. If necessary or desired a redirect from the name in the original language can be created. In cases where the non-English name is the common name, that name should be used, as in [[Huevos Rancheros]].
  
 
Recipes names with special characters ([[w:Diacritic|diacritics]], etc) should be primarily spelled with simple [[w:ASCII|ASCII]] characters and a redirect should be created with the special characters included.
 
Recipes names with special characters ([[w:Diacritic|diacritics]], etc) should be primarily spelled with simple [[w:ASCII|ASCII]] characters and a redirect should be created with the special characters included.
  
 
==== Special Diets ====
 
==== Special Diets ====
−
Recipes for a [[Cookbook:Special Diets|special diet]] which are substantially adjusted variations of a normal recipe should be denoted by the diet name in parentheses after the name of the recipe. A vegan variation of [[Cookbook:Chili]] would be [[Cookbook:Chili (Vegan)]]; a gluten-free variation of [[Cookbook:Brownie]] would be [[Cookbook:Brownies (Gluten-Free)]]; a lactose-free variation of [[Cookbook:Milkshake]] would be [[Cookbook:Milkshake (Lactose-Free)]]. Recipes which adhere to a special diet, but are not variations for that specific diet ''should not'' be named in this fashion; instead only the appropriate category should be added. Trivial variations should be listed on the recipe page itself.
+
Recipes for a [[Special Diets|special diet]] which are substantially adjusted variations of a normal recipe should be denoted by the diet name in parentheses after the name of the recipe. A vegan variation of [[Chili]] would be [[Chili (Vegan)]]; a gluten-free variation of [[Brownie]] would be [[Brownies (Gluten-Free)]]; a lactose-free variation of [[Milkshake]] would be [[Milkshake (Lactose-Free)]]. Recipes which adhere to a special diet, but are not variations for that specific diet ''should not'' be named in this fashion; instead only the appropriate category should be added. Trivial variations should be listed on the recipe page itself.
  
 
==== Duplicate Recipes and Disambiguation Pages ====
 
==== Duplicate Recipes and Disambiguation Pages ====
 
When there is more than one recipe for a single type of food, there are several ways to resolve the situation:
 
When there is more than one recipe for a single type of food, there are several ways to resolve the situation:
−
# If one recipe is of poor quality, delete it.
+
# If one recipe is of poor quality or has no references, delete it.
−
# If one recipe can be expressed as a variation upon the other, include it in the variations section and delete the original.
+
# If one recipe can be expressed as a variation upon the other, include it in the variations section.
 
# If the recipes can be merged into a single recipe, merge them and delete the originals.
 
# If the recipes can be merged into a single recipe, merge them and delete the originals.
 
# Create a disambiguation page for the 'abstract' type of food (using the <nowiki>{{cookdp}}</nowiki> template as a header) and give each recipe a unique name.
 
# Create a disambiguation page for the 'abstract' type of food (using the <nowiki>{{cookdp}}</nowiki> template as a header) and give each recipe a unique name.
  
−
In the last case, the distinguishing name should be as descriptive of the unique qualities of the recipe as possible. For example, a disambiguation page is [[Cookbook:Lasagne]] which links to [[Cookbook:Traditional Lasagne]], [[Cookbook:Ricotta Lasagne]], and [[Cookbook:Lasagne with bean sauce]]. If there is not an appropriately descriptive way to distinguish the recipes, roman numerals should be used, as in [[Cookbook:Hummus I]].
+
===Categories===
−
 
+
Cookbook-related categories are not yet entirely standardized, but these generally seem to be in the "normal" [[w:Wikipedia:Naming conventions (capitalization)|wikipedia form]] of capitalized first letter, lowercased first letter elsewhere (except with proper nouns).
−
===Cookbook Categories===
 
−
Cookbook-related categories are not entirely standardized, but these generally seem to be in the "normal" [[w:Wikipedia:Naming conventions (capitalization)|wikipedia form]] of capitalized first letter, lowercased first letter elsewhere (except with proper nouns).
 
  
 
For recipe categorization by ingredient, origin, diet, meal type, and recipe type classifications there is a tendency to use the "___ recipes" format e.g.:
 
For recipe categorization by ingredient, origin, diet, meal type, and recipe type classifications there is a tendency to use the "___ recipes" format e.g.:
Line 50: Line 45:
 
* [[:Category:Dessert recipes]] (by meal type)
 
* [[:Category:Dessert recipes]] (by meal type)
  
−
For ingredient categorization, a plural form is generally used, e.g.:
+
For localization categorization use the list of [[locations]]:
−
* [[:Category:Fats and oils]]
+
* [[:Category:Japan]]
−
* [[:Category:Cheese]]
+
* [[:Category:Italy]]
−
 
 
−
==Featured Recipe and Ingredient==
 
−
The featured recipe and ingredient should be chosen to highlight the potential of the [[Cookbook]]. They should therefore be well written and wikified. In addition, the featured recipe should:
 
−
* have a picture of the finished recipe (if possible)
 
−
* follow the [[Cookbook:Policy/Recipe template|recipe template]]
 
−
* have a recipe summary (see template above)
 
−
* have proper categories (by ingredient, diet, region, etc as appropriate)
 
−
* be an entire food item (i.e. not a component as in pie crust, sauces)
 
−
 
 
−
The featured ingredient should:
 
−
* have a picture of the ingredient
 
−
* have proper categories (by ingredient, diet, region, etc as appropriate)
 
−
 
 
−
The featured recipe and ingredient should be updated as frequently as once per week.
 
−
 
 
−
===Selection===
 
−
Cookbook contributors and users should tag worthy modules with [[:Category:Featured recipe candidate]] or [[:Category:Featured ingredient candidate]].
 
−
 
 
−
===Procedure===
 
−
* Edit [[Template:Featured recipe]] or [[Template:Featured ingredient]].
 
−
* Purge the cache of the main cookbook page, by [http://en.wikibooks.org/w/wiki.phtml?title=Cookbook:Table_of_Contents&action=purge clicking here]. This which will allow non-logged in users to see the change.
 
−
* Add [[:Category:Featured recipes]] or [[:Category:Featured ingredients]] to the featured item.
 
−
 
 
−
==Available Cookbook-Related Templates==
 
−
: ''See also [[:Category:Cookbook templates]]''
 
−
{| border="1" cellspacing="0" cellpadding="3"
 
−
|-
 
−
! What to type !! What it makes !! Where&nbsp;it&nbsp;goes
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Cooknav|cooknav]]}}
 
−
|
 
−
{{cooknav}}
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Recipe|recipe]]}}
 
−
|
 
−
{{recipe}}<br/>note: also includes the page using the template in [[:Category:Recipes]]
 
−
|Top of Page, instead of <nowiki>{{cooknav}}</nowiki>
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Ingredient|ingredient]]}}
 
−
|
 
−
{{ingredient}}<br/>
 
−
note: also includes the page using the template in [[:Category:Ingredients]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Equipment|equipment]]}}
 
−
|
 
−
{{equipment}}<br/>note: also includes the page using the template in [[:Category:Equipment]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Unit|unit]]}}
 
−
|
 
−
{{unit}}<br/>note: also includes the page using the template in [[:Category:Units of measurement]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Technique|technique]]}}
 
−
|
 
−
{{technique}}<br/>note: also includes the page using the template in [[:Category:Cooking techniques]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Diet|diet]]}}
 
−
|
 
−
{{diet}}<br/>note: also includes the page using the template in [[:Category:Diets]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Seafood|seafood]]}}
 
−
|
 
−
{{seafood}}<br/>note: also includes the page using the template in [[:Category:Seafood]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Meat|meat]]}}
 
−
|
 
−
{{meat}}<br/>note: also includes the page using the template in [[:Category:Meat and poultry]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Cheese|cheese]]}}
 
−
|
 
−
{{cheese}}<br/>note: also includes the page using the template in [[:Category:Cheeses]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Fruit|fruit]]}}
 
−
|
 
−
{{fruit}}<br/>note: also includes the page using the template in [[:Category:Fruits]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Vegetable|vegetable]]}}
 
−
|
 
−
{{vegetable}}<br/>note: also includes the page using the template in [[:Category:Vegetables]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Nut|nut]]}}
 
−
|
 
−
{{nut}}<br/>note: also includes the page using the template in [[:Category:Nuts and seeds]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Seed|seed]]}}
 
−
|
 
−
{{seed}}<br/>note: also includes the page using the template in [[:Category:Nuts and seeds]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Cereal|cereal]]}}
 
−
|
 
−
{{cereal}}<br/>note: also includes the page using the template in [[:Category:Cereals]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Herb|herb]]}}
 
−
|
 
−
{{herb}}<br/>note: also includes the page using the template in [[:Category:Herbs and Spices]]
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Spice|spice]]}}
 
−
|
 
−
{{spice}}<br/>note: also includes the page using the template in [[:Category:Herbs and Spices]]
 
−
|Top of Page
 
−
|-
 
−
|
 
−
<pre>{{Recipesummary|
 
−
|Category=Dessert recipes
 
−
|Servings=1-2
 
−
|Energy=100 Cal (400 kJ)
 
−
|Time=30 minutes
 
−
|Difficulty=Medium, requires specific tools
 
−
|Rating=3
 
−
|Image=[[Image:Hamburger_sandwich.jpg|300px]]
 
−
}}</pre>
 
−
|
 
−
{{Recipesummary|
 
−
|Category=Dessert recipes
 
−
|Servings=1-2
 
−
|Energy=100 Cal (400 kJ)
 
−
|Time=30 minutes
 
−
|Difficulty=Medium, requires specific tools
 
−
|Rating=3
 
−
|Image=[[Image:Hamburger_sandwich.jpg|300px]]
 
−
}}
 
−
<br style="clear:both"/>
 
−
|Top of Page, above <nowiki>{{cooknav}}</nowiki> or <nowiki>{{recipe}}</nowiki>
 
−
|
 
−
|-
 
−
|
 
−
<nowiki>{{</nowiki>[[Template:Recipesummary|recipesummary]]<nowiki>|Dessert recipes|1-2|30 minutes|3|[[Image:Hamburger_sandwich.jpg|300px]]|100 Cal (400 kJ)}}</nowiki>
 
−
|
 
−
{{Recipesummary|Dessert recipes|1-2|30 minutes|3|[[Image:Hamburger_sandwich.jpg|300px]]|100 Cal (400 kJ)}}
 
−
<br style="clear:both"/>
 
−
|Top of Page, above <nowiki>{{cooknav}}</nowiki> or <nowiki>{{recipe}}</nowiki>
 
−
|
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Cookwork|cookwork]]|Optional reason for work}}
 
−
|
 
−
{{cookwork|Optional reason for work}}
 
−
|Top of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Cookstub|cookstub]]}}
 
−
|
 
−
{{cookstub}}
 
−
| Bottom of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:1881|1881]]}} <br> [[Template talk:1881|Talk]]
 
−
|
 
−
{{1881}}
 
−
|Bottom of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Oscookbook|Oscookbook]]}} <br> [[Template talk:Oscookbook|Talk]]
 
−
|
 
−
{{Oscookbook}}
 
−
|Bottom of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Decameron|Decameron]]}} <br> [[Template talk:Decameron|Talk]]
 
−
|
 
−
{{Decameron}}
 
−
|Bottom of Page
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Featured recipe|featured recipe]]}}
 
−
|
 
−
{{featured recipe}}
 
−
|Anywhere.
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Featured ingredient|featured ingredient]]}}
 
−
|
 
−
{{featured ingredient}}
 
−
|Anywhere.
 
−
|-
 
−
| <pre>{{Nutrition Summary|
 
−
|ServingSize=1/6 of recipe (300 g)
 
−
|Servings=6
 
−
|Cals=128
 
−
|FatCals=31
 
−
|TotalFat=3 g
 
−
|SatFat=2 g
 
−
|Cholesterol=7 mg
 
−
|Sodium=351 mg
 
−
|Carbs=19 g
 
−
|Fiber=3 g
 
−
|Sugars=0 g
 
−
|Protein=6 g
 
−
|VitaminA=405%
 
−
|VitaminC=15%
 
−
|Calcium=8%
 
−
|Iron=8%
 
−
}}
 
−
</pre>
 
−
|{{Nutrition Summary|
 
−
|ServingSize=1/6 of recipe (300 g)
 
−
|Servings=6
 
−
|Cals=128
 
−
|FatCals=31
 
−
|TotalFat=3 g
 
−
|SatFat=2 g
 
−
|Cholesterol=7 mg
 
−
|Sodium=351 mg
 
−
|Carbs=19 g
 
−
|Fiber=3 g
 
−
|Sugars=0 g
 
−
|Protein=6 g
 
−
|VitaminA=405%
 
−
|VitaminC=15%
 
−
|Calcium=8%
 
−
|Iron=8%
 
−
}}
 
−
|Top of Page, after <nowiki>{{recipesummary}}</nowiki>, but before navigation
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Nutritionsummary|nutritionsummary]]<nowiki>|1/6 of recipe (300 g)|6|128|31|3 g|2 g|7 mg|351 mg|19 g|3 g|0 g|6 g|405%|15%|8%|8%}}</nowiki>
 
−
|{{nutritionsummary|1/6 of recipe (300 g)|6|128|31|3 g|2 g|7 mg|351 mg|19 g|3 g|0 g|6 g|405%|15%|8%|8%}}
 
−
|Top of Page, after <nowiki>{{recipesummary}}</nowiki>, but before navigation
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Seasonality|Seasonality]]<nowiki>|Apricot|1|1|1|1|3|3|3|2|2|1|1|1}}</nowiki>
 
−
|{{Seasonality|Apricot|1|1|1|1|3|3|3|2|2|1|1|1}}
 
−
|Top of ´Seasonality´ paragraph.
 
−
|-
 
−
| <nowiki>{{</nowiki>[[Template:Seasonality|Seasonality]]<nowiki>|Apricot|1|1|1|1|3|3|3|2|2|1|1|1|2|3|3|3|2|1|1|1|1|1|1|1}}</nowiki>
 
−
|{{Seasonality|Apricot|1|1|1|1|3|3|3|2|2|1|1|1|2|3|3|3|2|1|1|1|1|1|1|1}}
 
−
|Top of ´Seasonality´ paragraph.
 
−
|}
 
−
 
 
−
===Usage notes===
 
−
#<nowiki>{{Recipesummary}}</nowiki>:
 
−
#* All fields are '''optional''', see [[Template:Recipesummary/Examples]] for examples on using this template.
 
−
#* The "Category" tries to resolve to an actual category, but does ''not'' include the recipe in that category.
 
−
#* Rating is between 1 and 5 inclusive.
 
−
#<nowiki>{{nutritionsummary}}</nowiki> is shorthand for <nowiki>{{Nutrition Summary}}</nowiki>. Its arguments are in the order they are displayed.
 
−
#<nowiki>{{Seasonality}}</nowiki>:
 
−
#* The numbers entered are 1,2 or 3 for each month. 1 means the ingredient is not in season, 2 means the ingredient is not at it´s best, but is grown by natural means and 3 means the ingredient is in season. These values are entered for the northern hemisphere. The values for the southern hemisphere are automatically rotated 6 months.
 
−
#* Should preferably be accomplished by a small paragraph explaining the details of the seasonality of the ingredient. The page should also:
 
−
#** be tagged with one or more of [[:Category:Spring ingredients]], [[:Category:Summer ingredients]],  [[:Category:Autumn ingredients]], [[:Category:Winter ingredients]] or [[:Category:Ingredients available all year]].
 
−
#** be added to the tables on the [[cookbook:Seasonality|seasonality page]].
 
−
#<nowiki>{{SeasonalitySpec}}</nowiki> is used to enter the values for the southern hemisphere manually. The template has 24 number fields one per month per hemisphere, from Jan to Dec, northern hemisphere first.
 
−
 
 
  
−
[[Category:Cookbook|!]]
+
[[Category:Main|!]]

Revision as of 16:56, 28 March 2012

This page describes policies for pages in this wiki.

References

Each recipe requires a title, followed by at least two notable references and then a sentence or two describing the recipe. Recipe pages should not contain the history of a recipe or any other editorials. After the description, the list of ingredients must be shown followed by the instructions. Links to ingredients should be links to the page on Wikipedia not a local version. Next should be links to the recipes of notable variations with a quick summary of each variation. This is then followed by the references, a link to the relevant Wikipedia pages and then External Links.

Generally speaking, for a given food, there should be only one recipe per locale per language and the recipe need to be self-contained. Exceptions include variations where an ingredient is optional or substituted but the instructions and other portions remain exactly the same as the original recipes.

Recipe Formatting

Recipes should be formatted according to the recipe template.

Pages needing work

Pages which need work should be tagged with the {{cookwork}} template, and will appear in Category:Cookbook pages needing work. When a recipe has been sufficiently improved, the template should be removed.

Naming Conventions

Cookbook Pages

Case

The de-facto naming convention for Cookbook pages is title case.

Name

Recipes should be named according to their name as per the references.

Recipes with a non-English name that have a common English name should be named with their common English name. For example, the primary name for Khaeng Keaw Wan should be Thai Green Curry. If necessary or desired a redirect from the name in the original language can be created. In cases where the non-English name is the common name, that name should be used, as in Huevos Rancheros.

Recipes names with special characters (diacritics, etc) should be primarily spelled with simple ASCII characters and a redirect should be created with the special characters included.

Special Diets

Recipes for a special diet which are substantially adjusted variations of a normal recipe should be denoted by the diet name in parentheses after the name of the recipe. A vegan variation of Chili would be Chili (Vegan); a gluten-free variation of Brownie would be Brownies (Gluten-Free); a lactose-free variation of Milkshake would be Milkshake (Lactose-Free). Recipes which adhere to a special diet, but are not variations for that specific diet should not be named in this fashion; instead only the appropriate category should be added. Trivial variations should be listed on the recipe page itself.

Duplicate Recipes and Disambiguation Pages

When there is more than one recipe for a single type of food, there are several ways to resolve the situation:

  1. If one recipe is of poor quality or has no references, delete it.
  2. If one recipe can be expressed as a variation upon the other, include it in the variations section.
  3. If the recipes can be merged into a single recipe, merge them and delete the originals.
  4. Create a disambiguation page for the 'abstract' type of food (using the {{cookdp}} template as a header) and give each recipe a unique name.

Categories

Cookbook-related categories are not yet entirely standardized, but these generally seem to be in the "normal" wikipedia form of capitalized first letter, lowercased first letter elsewhere (except with proper nouns).

For recipe categorization by ingredient, origin, diet, meal type, and recipe type classifications there is a tendency to use the "___ recipes" format e.g.:

For localization categorization use the list of locations:

Retrieved from "http://www.recidemia.com/index.php?title=Policy&oldid=96264"