13,586
edits
Changes
→General Format
===General Format===
To begin, a good article to look at that contains the structure we are looking for is the [[Mixed Fermentation]] page. It has some good examples of what we are looking for. Here are some general guidelines:
# Editors should write articles using straightforward, succinct, easily understood language and structure articles with consistent, reader-friendly layouts and formatting.
# Begin the page with a definition of the subject of the page, with the first mention of the subject being bolded.
# Technical terms should be italicized or quoted.
# Inner wiki page links should be used whenever possible. This promotes views on other pages.
# References should be used whenever possible, even if the wiki editor is an expert on the subject. Doing so gives the wiki readers a more authoritative feel to it source for readersthe information presented on this wiki. For reference format, please read [[Main_Page#Regarding_Referencing_Style|Regarding Referencing Style]].
# Use "(To do)" and "(In progress)" to indicate if sections of a page are not complete.
# Make use of tables, images, and bullets when possible.
# Look at the wiki markup of [[Mixed Fermentation]] and ''[[Lactobacillus]]'' pages for other ideas on how to format certain things.
# All entries should be spell checked and grammar checked.
===Referencing===
Our general practice is to provide references for information presented on this wiki. We will cite scientific academic and peer-reviewed publications or other reliable published sources when possible. However, due to the nature and current status of this craft, there are various potentially helpful sources of information that are not or cannot be peer reviewed or sometimes even published. Because of this we occasionally reference the personal experiences of our members, citing either blogs and other online articles, or posts on the Milk The Funk Facebook page. We leave it to the reader to decide whether or not the information from such references is valid. (Note that when a reference links to the MTF Facebook page, wiki readers will not be able to access it unless they are members of the group on Facebook.)
We generally use Wikipedia's inline citation method of referencing. Specifically, we use the full numbered footnotes style, otherwise known as "Shortened notes". Hyperlinked numbers will appear inline as superscripts following a sentence or paragraph, and will link directly to footnotes at the bottom of the page which list the full citation. Due to the limited number of wiki editors and the limited time that they volunteer to write for this wiki, references may not be formatted to a scholarly standard, but they should always give enough information so that readers can easily track down the references themselves. If a particular sentence does not have an inline superscript number reference, look for it at the end of the paragraph or after successive sentences.
Look at pages such as [[Brettanomyces]] or [[Lactobacillus]] to see how our referencing style works as far as format and markup.
''Example wiki markup:''
A single occurrence of a reference on one page:
<code>
<nowiki><ref>[http://www.milkthefunk.com Milk The Funk.]</ref></nowiki>
</code>
Reference the same source multiple times on a one page:
<code>
<nowiki>First reference: <ref name="name_of_ref">[http://www.milkthefunk.com Milk The Funk.]</ref></nowiki>
</code>
<code>
<nowiki>Subsequent references: <ref name="name_of_ref" /></nowiki>
</code>
===Other Guidelines===