13,703
edits
Changes
→General Format
==Goal of the wiki==
# Being a place to track and catalog information (culture charts, secondary metabolites, etc).
# Being a place to track the information shared by reputable Milk The Funk members. Note that there is a fine line between "internet lore", "personal opinion", and "valuable insight". This has been a delicate road to walk, but I feel like we have some real experts who's opinions can be quoted. When referencing these things, make it clear that it was stated by the person who stated it. This gives them the responsibility for saying it!
# Cataloging outside information. There is a plethora of outside information. It is up to us to filter it out, organize it, and deem it worthy of linking to on this wiki.
==Format and Structure Defined==
===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 reference to mention of the subject being boldbolded. # Technical terms should be italicizedor 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 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===
* Be aware of all of the other pages that are on the wiki so that they can be cross referenced if needed on your new page.
* Ask fellow wiki editors and the main MTF group to proof read your writing, and check for factual consistencies.
* Expect that your work can be edited by anyone on the wiki team. However, please respect the previous editor's work. If changing a wiki page that someone else has been editing, the polite thing to do is to send them a message and get their feedback on your suggestions or changes.
* General writing style should be as informational as possible, and as free from bias and personal opinion of the writer as possible. Instead, quote or reference the opinion of reliable and reputable sources.
* Avoid re-writing material that is in brewing books such as ''America Sour Beers''. We should supplement the information in these books, and citing too much information from a book might discourage sells of books and alienate their authors from our group!
* Avoid using pseudonyms for scientific names. For example, instead of typing "Lacto", "Brett" or "Sacch", type "''Lactobacillus''", "''Brettanomyces''", and "''Saccharomyces''". Scientific names should be italicizedand otherwise formatted as per [https://en.wikipedia.org/wiki/Binomial_nomenclature binomial nomenclature]. Occurrences of pseudonyms on the wiki should be corrected.