Wiki Page Format and Structure Standards
This is a new page for wiki editors that explains how to create a new page, and what the standardized structure is for our pages. Having a somewhat universal structure to our pages will make them more readable and easier to browse. There will always be an exception to these rules, and we always prefer to have information available even it is incomplete or not well formatted, but these guidelines should be followed whenever possible. This guide doesn't cover how to actually edit the wiki. For that, please see the Help section of the wiki.
Contents
Format and Structure Defined
Before you make a page
First, search the wiki to make sure there is not already a page for the subject you are creating, or a page where the new information might fit. If a suitable page cannot be found, start thinking about what Categories the new page will fit. Avoid making new Categories if possible, and only make one if there really is no other category for the new page.
General Structure
A good starting point is to copy and paste this text into the body of the new page you are creating:
(In progress) First, define '''new_page_subject'''.
==Major Heading==
(To do)
===Sub Heading===
(To do)
==See Also==
===Additional Articles on MTF Wiki===
* [[Mixed Fermentation]]
===External Resources===
* [www.milkthefunk.com Example link.]
==References==
<references/>
[[Category:enter_your_category]]
The above code is a good template for new pages. The starting definition should be replaced, as well as the headings. The "See Also" part creates a section for internal links and external links. Promoting other pages on the wiki is a good idea, so be liberal with this section. The References part takes care of itself, all you have to do is use the <ref></ref> tags. Also, remember to plug in that Category. Every page should have at least one Category.
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:
- Begin the page with a definition of the subject of the page, with the first reference to the subject being bold. Subsequent mentions of the subject should be italicized.
- Technical terms should be italicized.
- 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 a more authoritative feel to it for readers.
- 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 Mixed Fermentation and Lactobacillus pages for other ideas on how to format certain things.
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 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.
- 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 others.