To get updates on new site content, like us on Facebook or follow us on Twitter.

Difference between revisions of "Help:Writing and Editing for the JFA Wiki"

From JFA Wiki
(Tone)
Line 48: Line 48:
  
 
The new site already has lots of useful information, especially in providing talking points for  [[Replies Listing|replying to objections]] to animal rights and veganism. But a wiki takes an encyclopedic approach, which calls for articles on a wide range of related topics. For the JFA Wiki, this means topics that are germane to animal rights and vegan advocacy.
 
The new site already has lots of useful information, especially in providing talking points for  [[Replies Listing|replying to objections]] to animal rights and veganism. But a wiki takes an encyclopedic approach, which calls for articles on a wide range of related topics. For the JFA Wiki, this means topics that are germane to animal rights and vegan advocacy.
 +
 +
In addition to presenting information directly pertinent to animal rights, we also present the environmental, nutritional, and human social justice aspects of veganism in hopes of providing additional incentive for people to adopt a vegan lifestyle. Be we acknowledge that the case for animal rights and veganism does not depend on these considerations beyond showing that a vegan diet is adequate for good health.
  
 
=== How We Differ ===
 
=== How We Differ ===
Line 76: Line 78:
 
* Hate speech.
 
* Hate speech.
 
* Anything with an assumption, implicit or explicit, that animals are here for human exploitation.
 
* Anything with an assumption, implicit or explicit, that animals are here for human exploitation.
 +
 +
=== Point of View ===
 +
 +
We have adopted an objective point of view, similar to Wikipedia's neutral point of view, as explained below. An exception is that we are not neutral in our belief that it is morally wrong to unnecessarily harm animals. And the evidence that unnecessary harms are occurring on a grand scale cannot be plausibly denied.
 +
 +
Achieving the objective point of view means carefully and critically analyzing a variety of reliable sources and then attempting to convey to the reader the information contained in them fairly, proportionately, and as far as possible without editorial bias. We  should strive in good faith to provide complete information. Observe the following principles (adapted from Wikipedia) to achieve the level of neutrality that is appropriate for an encyclopedia:
 +
 +
* Avoid stating opinions as facts. Usually, articles will contain information about the significant opinions that have been expressed about their subjects. However, these opinions should not be stated in Wikipedia's voice. Rather, they should be attributed in the text to particular sources, or where justified, described as widespread views, etc.
 +
* Avoid stating validly contested assertions as facts. If different reliable sources make conflicting assertions about a matter, treat these assertions as opinions rather than facts, and do not present them as direct statements.
 +
* Avoid stating facts as opinions. Passages should not be worded in any way that makes it appear to be contested.
 +
* Present opinions and conflicting findings in a disinterested tone. Do not editorialize.
 +
* Indicate the relative prominence of opposing views. Ensure that the reporting of different views on a subject adequately reflects the relative levels of support for those views, and that it does not give a false impression of parity, or give undue weight to a particular view.
  
 
=== Public Doman ===
 
=== Public Doman ===
Line 82: Line 96:
  
 
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see JFA Wiki:Copyrights for details). Do not submit copyrighted work without permission!
 
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see JFA Wiki:Copyrights for details). Do not submit copyrighted work without permission!
 
  
 
=== Research ===
 
=== Research ===

Revision as of 15:19, 5 August 2019

Draft WIP

Revised 20:12, 3 August 2019 (PDT)

Because we are using the Mediawiki software platform, the same platform used by Wikipedia, some of the links on this page will direct you to documentation on the Mediawiki site or the Wikipedia site.

The JFA wiki offers a unique opportunity to contribute to the Animal Rights and Vegan movement by lending your writing and research skills to provide information useful to the community. We hope you will participate, and can't wait to see your contributions! You also have a chance to grow with us and become a trusted writer, bypassing moderation.

Creating an Account

You are welcome to make small edits anonymously, but for anything more substantial, you should create an account and verify your email address. This will allow you to:

  • Choose an appropriate user name, which will be reserved just for you on this site.
  • Create your own user page, to collaborate, share information about yourself, or just practice editing and publishing in your own sandbox.
  • Communicate with other editors via your own talk page. You can also opt in to exchanging emails with other users.
  • Use your watchlist to monitor changes made to pages that interest you, and be notified via email when a page you are watching is edited.
  • Facilitate the ability of other editors to communicate with you.
  • Use custom preferences to change the look and behavior of the JFA Wiki.
  • View a convenient list of all your contributions (edits).
  • Be eligible for consideration as a trusted contributor that can bypass moderation.

Please use a Firstname.Lastname format for your username. For example, Jane.Doe. Your username cannot be changed after an account is created. After you create your account, you will receive an email asking you to verify your email address. Some important features won't be available until your email address is verified.

Approval, Moderation and Collaboration

All edits require approval (a process called moderation) before they become part of page history and become visible to other users. Because of the moderation process, vandalism is pointless.

All contributions to JFA Wiki may be edited and substantially altered by other users. Your contributions could also be deleted. The following may result in you being blocked from further participation:

  • Reversing edits, made by moderators, managing editors, or copy editors.
  • Submitting content that violates these guidelines.

Editing

JFA Wiki provides the two editing tools that are often found on wiki sites, the source editor and the visual editor. You begin editing a page by clicking or tapping on Edit Source for the default editor or Edit for the visual editor, at the near the top-right of a page, or beside each Section Heading. Depending on your preference settings and whether you are an anonymous user one or both buttons may appear.

Default Editor

If you have edited a Wikipedia page you have used this editor. When you need to use some type of formatting, such as for new headings or bolding of text, you do this using wiki syntax or the buttons in the edit toolbar above the editing zone. See Help Editing for help. Most of what's on this page applies to this wiki except for Starting a New Page— see #Starting a New Article on this page for that. For help formatting, see Mediawiki Help Formatting.

Visual Editor

The Visual Editor provides more of a "what you see is what you get" editing experience. This editor was developed by the Wikimedia Foundation (WMF) to provide a way of editing does not require editors to learn wiki markup. The Visual Editor allows people to edit pages without having to learn wikitext markup.

Experienced editors still may prefer editing wikitext because they find it faster and more precise. Even editors who enable Visual Editor will have the wikitext option available from the toolbar for each page and section. The Visual Editor is fairly stable, but it still has some bugs and missing features. See the Visual Editor User Guide for help.

Content Guidelines

The new site already has lots of useful information, especially in providing talking points for replying to objections to animal rights and veganism. But a wiki takes an encyclopedic approach, which calls for articles on a wide range of related topics. For the JFA Wiki, this means topics that are germane to animal rights and vegan advocacy.

In addition to presenting information directly pertinent to animal rights, we also present the environmental, nutritional, and human social justice aspects of veganism in hopes of providing additional incentive for people to adopt a vegan lifestyle. Be we acknowledge that the case for animal rights and veganism does not depend on these considerations beyond showing that a vegan diet is adequate for good health.

How We Differ

As an example of how we differ from Wikipedia and other wikis, consider our article on chickens compared to Wikipedia's. Wikipedia provides general information that is well worth the read. But instead of trying to duplicate the information on Wikipedia, our article provides information on the aspects of chickens useful for advocacy. This includes summarized information on chicken sentience and cognition, the way we harm chickens, humane labels and certifications, nutritional information on chicken meat and eggs, and environmental harms associated with chicken production. As the site grows, it's likely that future articles will provide more detailed information in each of these areas.

Also, the JFA Wiki is not:

  • A home for opinion pieces, although this may be allowed later in a special section of the site.
  • A news website There are some good news websites available.
  • A recipe website. Some amazing recipe site can be found.

Tone

Use an informal academic tone in your writing. This is a bit vague, but you can review existing content on this site to get an idea of what this means.

Avoid:

  • Hyperbole and exaggeration.
  • Scare quotes. Scare quotes convey cynicism, which, unlike skepticism, is a liability.
  • Overly emotional language.
  • Ultimatums. “A man convinced against his will is of the same opinion still.” — Ben Franklin
  • Criticism of those in the movement who advocate strategies and tactics with which we disagree. Such criticism is sometimes justified, but it seems that plenty of energy is already being spent on such efforts.
  • Questioning a person’s or organization’s motives, especially those in the movement. Questioning motives requires a higher standard of evidence than questioning their position on a topic.

The following are prohibited:

  • Ad hominem attacks.
  • Racist, sexist, classist, homophobic, ageist, ableist, or demeaning language.
  • Hate speech.
  • Anything with an assumption, implicit or explicit, that animals are here for human exploitation.

Point of View

We have adopted an objective point of view, similar to Wikipedia's neutral point of view, as explained below. An exception is that we are not neutral in our belief that it is morally wrong to unnecessarily harm animals. And the evidence that unnecessary harms are occurring on a grand scale cannot be plausibly denied.

Achieving the objective point of view means carefully and critically analyzing a variety of reliable sources and then attempting to convey to the reader the information contained in them fairly, proportionately, and as far as possible without editorial bias. We should strive in good faith to provide complete information. Observe the following principles (adapted from Wikipedia) to achieve the level of neutrality that is appropriate for an encyclopedia:

  • Avoid stating opinions as facts. Usually, articles will contain information about the significant opinions that have been expressed about their subjects. However, these opinions should not be stated in Wikipedia's voice. Rather, they should be attributed in the text to particular sources, or where justified, described as widespread views, etc.
  • Avoid stating validly contested assertions as facts. If different reliable sources make conflicting assertions about a matter, treat these assertions as opinions rather than facts, and do not present them as direct statements.
  • Avoid stating facts as opinions. Passages should not be worded in any way that makes it appear to be contested.
  • Present opinions and conflicting findings in a disinterested tone. Do not editorialize.
  • Indicate the relative prominence of opposing views. Ensure that the reporting of different views on a subject adequately reflects the relative levels of support for those views, and that it does not give a false impression of parity, or give undue weight to a particular view.

Public Doman

Understand that you agree to irrevocably release anything you write for this site to the public domain. Everytime you edit and save changes, you are provided with a notice to this effect.

You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see JFA Wiki:Copyrights for details). Do not submit copyrighted work without permission!

Research

Seek to use the highest quality sources available. Do not misrepresent a source. Primary sources are preferred for factual data.

For interpretations of highly technical research or other data, secondary sources from objective experts can be more convincing primary sources, One research study rarely provides positive proof, so objective expert testimony can be more meaningful, not to mention more convincing.

Credible Sources

Sources should be credible to the target audience. For credibility with non-vegans, validated sources, to whatever extent possible and where appropriate, should not originate within the animal rights and vegan communities. Relying on experts in the animal rights or veganism movement is discouraged for establishing the veracity of positions widely doubted or not understood by those not in the movement.

For example, citing an organization named Animal Rights League, particularly for factual information, is not convincing to those who do not believe in animal rights, no matter how factual the information presented. These organizations include:

  • Any organization that is primarily an animal rights organization, an animal welfare organization, or a vegan organization.
  • Any organization whose name indicates it is an animal rights organization, an animal welfare organization, or a vegan organization.

According to a study on belief-revision policies, what one does with the information “depends substantially on her attitude towards the source of information: her assessment of the reliability of the source.”4

Sources friendly to opposing views can often be used to lend credence to a point. Example: “Even the National Dairy Association acknowledges . . .” The USDA, with its abundance of information (and as a friend of animal agriculture), is often a good source. If a quality source for a factual statement cannot be found, the statement should not be used. No exceptions. Plagiarism is not acceptable. When in doubt, credit the source. Using someone’s words without quotation marks is plagiarism even if you cite the source.

Starting a New Article

The focus in the near-term will be the general foundational articles that need to be written to fully realize the site's mission of being an encyclopedic resource. If you wish to write for the wiki, we hope you will choose one of these articles, or suggest an article which might also be considered foundational. Please consider what new article you would like to work on then email your.friends@justiceforanimals.org and we will create a draft for that article.

Needed Articles

In Reply To Articles Needed In Reply To Article Done
  • In reply to: More small animals are killed in plant farming than are killed by us eating them.
  • In reply to: Our brains evolved from eating animals.
Animal Articles Needed Animal Articles Done
  • Cows
  • Pigs
  • Fish
  • Turkeys
  • Shellfish
  • Chickens
Product Articles Needed Product Articles Done
  • Leather
  • Wool
  • Silk
  • Fur
  • Shellfish
  • Honey
Use Articles Needed Use Articles Done
  • Horse Racing
  • Rodeos
  • Fishing
  • Hunting
  • Zoos
  • Aquariums
  • Circuses
  • Research

None

Health and Nutrition Articles Needed Health and Nutrition Articles Done'
  • Industry-Funded Studies
  • Animal Protein
  • Diabetes
  • Heart Disease
  • Cholesterol
  • Cancer
  • Diabetes
  • None
Environment Articles Needed Environment Articles Done
  • Global Warming
  • Deforestation
  • Species Extinction
  • Fish Depletion
  • Water Pollution
  • Water Wastage
  • Ocean Dead Zones
  • Grazing