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
(Creating an Account)
(Continual Refinement)
 
(82 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{jfa-top}}
 
{{jfa-top}}
  
Draft WIP
+
''This page is a work-in-process draft.''
  
The JFA Wiki offers you a unique opportunity to contribute to the Animal Rights and Vegan movement by lending your writing and research skills to this collaborative site. 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 contributor, moderator, or editor, as explained below.
+
== Background ==
  
{{jfa-note}}
+
The JFA Wiki offers you a unique opportunity to contribute to the animal rights and vegan movement by lending your writing and research skills, as well as your specialized knowledge to this collaborative site.  You also have a chance to grow with us and become a trusted contributor, moderator, or editor, as [[#Contributors, Editors, Moderation, and Approval | explained below]]. We hope you will participate, and can't wait to see your contributions.
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.
 
{{jfa-note-end}}
 
  
== Creating an Account ==
+
== Continual Refinement ==
  
Before you can edit content, you must create an account and verify your email address. This will allow you to:
+
You can write new articles, paid or not as explained below. Our wiki platform also allows you to help with making continual refinements and improvements with smaller edits.
  
* Edit existing pages content and create new draft pages.
+
Smaller edits can:
* Be eligible for consideration as a contributor or senior contributor.
 
* View a convenient list of all your contributions (edits).
 
* 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.
 
* Create your own user page to share information about yourself.
 
* Opt into exchanging emails with other users.
 
* Use custom preferences to change the look and behavior of the JFA Wiki.
 
  
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.
+
* clarify, or correct grammar and spelling
 +
* bring an article up to date
 +
* correct faulty or weak logic
 +
* add additional pertinent information
 +
* provide more convincing or compelling wording
 +
* provide additional evidence
 +
* replace unconvincing or weaker evidence
  
== Contributors and Editors ==
+
== Paid Assignments ==
  
Due to the nature of the subject matter on this site, we are using a multilevel moderation and approval system which will render vandalism pointless. As a user, your edits require moderation (acceptance) before they become part of [https://meta.wikimedia.org/wiki/Help:Page_history page history] and become visible to other users.
+
Our recent [[Wiki Go-Live Announcement (2019-08-19)|conversion to a wiki]] expanded the mission of the site to include being an encyclopedic and collaborative resource for animal rights and vegan advocacy, not just a resource to aid in answering objections. This calls for new foundational articles (as shown in [[Help:Future Home Page | our vision for a future home page]]) on a variety of topics—one for each species of farmed animal; one for each kind of product made from animals; one for each of the ways we exploit animals; one for each of the health problems that are mitigated by a plant-based diet, etc.
  
As you make more edits, you can progress from ''user'' to other more trusted levels:
+
To kickstart our goal of meeting this expanded mission, we are offering paid assignments for new articles. We expect these paid assignments to continue until at least the foundational articles needed are completed. These paid assignments will in no way stop writers from contributing their time to the wiki without remuneration.
  
* ''Contributor'': Your edits bypass moderation and show up in page history. They must still be approved to show up in the default view of a page, but your changes are readily viewable by anyone.
+
Our current rate of eight cents per-word USD is at least competitive, if not high, for non-profit assignments. As an example of what you can earn, our 6,568-word article on Chickens would pay $525, while a short article like the one on Honey would pay $123. These numbers assume you have contributed all the words to the article.
  
* ''Senior Contributor'': Your edits bypass moderation and approval, but may still be reversed by an editor.
+
To learn more about writing assignments, both paid and unpaid, see [[Help:Writing Assignments|Writing Assignments]].
  
* ''Moderator'': You provide the first level of defense against vandalism, misuse, and other violations.
+
== Articles Needed ==
  
* ''Topic Editor'': You provide compliance oversight of one subject area, such as environment, health, or ethics.
+
The focus for new articles in the near-term will be foundational articles that need to be written to fully realize the site's new mission of being an encyclopedic resource. You can find a list of these foundational articles in [[Help:Future Home Page | our vision for a future home page]].
  
* ''Copy Editor'': You contribute to the style guides and help enforce compliance with the style guides and other guidelines.
+
== Technical Help ==
  
* ''Managing Editor'': The managing editor takes the lead in managing the site and it's contributed content.
+
Technical help can be found at [[Help:Technical Help and Hints]].
  
At any level, all contributions to JFA Wiki may be edited and substantially altered by other users. Your contributions could also be deleted.
+
== Qualifications ==
  
The following may result in you being blocked from further participation:
+
Our ideal writer, particularly those writing new articles under assignment:
* Reversing edits made by editors.
 
* Consistently submitting content that violates these guidelines.
 
  
== The Editing Process ==
+
* cares about animal rights and veganism
 +
* can write with a friendly voice
 +
* holds a college degree or equivalent work experience
 +
* has experience authoring and/or editing online content
 +
* possesses a willingness and an ability to perform academic research
 +
* is committed to providing high-quality, accurate information
 +
* can take direction from editors and work in a collaborative environment.
  
The JFA Wiki provides the two editing tools that are often found on wiki sites, the source editor and the visual editor. When you are logged in, you can begin editing a page by clicking or tapping on ''Edit Source'' for the default editor or ''Edit'' for the visual editor, 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.
+
== Expectations ==
  
=== Default Editor ===
+
Before you consider writing for us, you need to understand the kind of writing that will be expected and accepted. This is covered in the[[Help:Content Guidelines | Content Guidelines]]. But the best way to get a feel for what is expected is to familiarize yourself with existing articles. As the[[Help:Content Guidelines | Content Guidelines]] explain, the articles on this site are written in an informal academic tone with an objective point of view, and substantively differ from articles on other wiki sites such as Wikipedia.
  
If you have edited a Wikipedia page you have used the default 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. For  help with editing see [https://www.mediawiki.org/wiki/Help:Editing Help Editing]. Most of what's on [https://www.mediawiki.org/wiki/Help:Editing Help Editing] applies to the JFA Wiki except for ''Starting a New Page''— see [[#Starting a New Article | Starting a New Article]] for that. For help with formatting, see [https://www.mediawiki.org/wiki/Help:Formatting Mediawiki Help Formatting].
+
Because providing credible citations for factual statements is a requirement, much of the time spend on an article will be spent in research. If you are a new contributor to the site, we will more closely monitor your progress on an article to help ensure you stay on track and that you don't waste time on content that will not be accepted.
  
=== Visual Editor ===
+
== Creating an Account and Your User Page ==
  
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.
+
Before you can write articles and edit content, you need to create an account and verify your email address, according to the guidance offered in the article [[Help:Your Account and Personalization]]. Creating an account offers benefits beyond just enabling editing, as is discussed in the article.
  
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. Also, the visual editor requires a separate server that periodically may not be avaialble. See [https://www.mediawiki.org/wiki/Help:VisualEditor/User_guide the Visual Editor User Guide ] for help.
+
== Contributors, Editors, Moderation, and Approval ==
  
== Content Guidelines ==
+
Due to the nature of the subject matter on this site, we are using a multilevel moderation and approval system which will render vandalism pointless and encourage compliance with [[Help:Content Guidelines | our guidelines]]. As a user, your edits will require moderation (acceptance) before they become part of [https://meta.wikimedia.org/wiki/Help:Page_history page history] and become visible to other users.
  
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.
+
As you make more edits, you have a chance to progress from ''user'' to other more trusted levels:
  
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.
+
* ''Contributor'': Your edits bypass moderation and show up in [https://meta.wikimedia.org/wiki/Help:Page_history page history]. They must still be approved to show up in the default view of a page, but your changes are readily viewable by anyone.
  
=== How We Differ ===
+
* ''Senior Contributor'': Your edits bypass both moderation and approval, but could still be reversed by an editor.
  
As an example of how we differ from Wikipedia and other wikis, consider our [[Chickens|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.
+
* ''Moderator'': You provide the first level of defense against vandalism, misuse, and other violations.
  
Also, the JFA Wiki is not:
+
* ''Topic Editor'': You provide compliance oversight of one subject area, such as ethics, environment, health, or ethics.
  
* A home for opinion pieces, although this may be allowed later in a special section of the site.
+
* ''Copy Editor'': You contribute to the style guides and help enforce compliance with the style guides and other guidelines. A copy editor also edits to improve readability, clarity, fitness for purpose, grammar, and style.
* A news website There are some good news websites available.
 
* A recipe website. Some amazing recipe site can be found.
 
  
=== Tone ===
+
* ''Managing Editor'':  The managing editor takes the lead in managing the site and its contributed content.
  
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.
+
At any level, all contributions to JFA Wiki may be edited and substantially altered by other users. It's also possible your edits could be reversed.  
  
Avoid:
+
The following may result in you being blocked from further participation:
* Hyperbole and exaggeration.
+
* Reversing edits made by editors.
* Scare quotes. Scare quotes convey cynicism, which, unlike skepticism, is a liability.
+
* Consistently submitting content that violates  [[Help:Content Guidelines |guidelines]].
* 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 considering a variety of reliable sources and then presenting the information as fairly as possible without bias. Observe the following principles (adapted from Wikipedia) to achieve objectivity:
 
 
 
* Avoid stating opinions as facts. Opinions 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.
 
 
 
=== Style Guide ===
 
 
 
The Chicago Manual of Style (17th Edition) is JFA's main style guide. The style decisions unique to JFA are addressed in our own [[Help:Style Guide | Style Guide]] which takes first priority.
 
 
 
=== Research and Sources ===
 
 
 
Seek to use the highest quality sources available. Primary sources are strongly preferred for factual data. For interpretations of highly technical research or other data, secondary sources from objective experts who are qualified to evaluate primary sources can be employed. One research study rarely provides positive proof of anything, so objective in some cases expert testimony can be more meaningful, not to mention more convincing.
 
 
 
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.
 
 
 
Sources friendly to opposing views can often be used to lend credence to a point.
 
For 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.
 
 
 
Do not plagiarize. Using someone’s words without quotation marks is plagiarism even if you cite the source.
 
 
 
=== Public Doman ===
 
 
 
Understand that you agree to irrevocably release anything you write for this site to the public domain. Every time 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.
 
 
 
== Starting a New Article ==
 
 
 
The focus in the near-term will be 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 the foundational articles listed below, or suggest an article which might also be considered foundational. Once you decide on the topic and title, create a draft article using the form below. A new article will be created in the Draft namespace with some boilerplate text to help you get started.
 
 
 
Once the article is completed, email yourfriends@justicefornamimals.org to request it be moved out of the draft namespace. Note that articles in the draft namespace are not subject to the same level of moderation of other articles. But editors will still be keeping an eye on your work and may make modifications and suggestions along the way to help you comply with guidelines.
 
 
 
<inputbox>
 
type=create
 
namespaces=Draft
 
width=100
 
break=no
 
buttonlabel=Create new article
 
default=(Article title)
 
</inputbox>
 
 
 
== Needed Articles ==
 
 
 
{| class="wikitable"
 
|'''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.
 
|
 
{{#dpl:
 
| namespace=
 
| category = Reply
 
| mode = userformat
 
| secseparators = *[[%PAGE%|, ]] \n,
 
| include =  {Jfa-meta}:meta-title
 
| noresultsheader =  * No results for Topic: Reply
 
}}
 
|-
 
|'''Animal Articles Needed'''
 
|'''Animal Articles Done'''
 
|-
 
|
 
* Cows
 
* Pigs
 
* Fish
 
* Turkeys
 
* Shellfish
 
|
 
* [[Chickens]]
 
|-
 
|'''Product Articles Needed'''
 
|'''Product Articles  Done'''
 
|-
 
|
 
* Leather
 
* Wool
 
* Silk
 
* Fur
 
* Shellfish
 
|
 
* [[Honey, Bees, and Pollination]]
 
|-
 
|'''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
 
|}
 
  
 
{{jfa-meta}}
 
{{jfa-meta}}

Latest revision as of 09:44, 30 October 2019

This page is a work-in-process draft.

Background

The JFA Wiki offers you a unique opportunity to contribute to the animal rights and vegan movement by lending your writing and research skills, as well as your specialized knowledge to this collaborative site. You also have a chance to grow with us and become a trusted contributor, moderator, or editor, as explained below. We hope you will participate, and can't wait to see your contributions.

Continual Refinement

You can write new articles, paid or not as explained below. Our wiki platform also allows you to help with making continual refinements and improvements with smaller edits.

Smaller edits can:

  • clarify, or correct grammar and spelling
  • bring an article up to date
  • correct faulty or weak logic
  • add additional pertinent information
  • provide more convincing or compelling wording
  • provide additional evidence
  • replace unconvincing or weaker evidence

Our recent conversion to a wiki expanded the mission of the site to include being an encyclopedic and collaborative resource for animal rights and vegan advocacy, not just a resource to aid in answering objections. This calls for new foundational articles (as shown in our vision for a future home page) on a variety of topics—one for each species of farmed animal; one for each kind of product made from animals; one for each of the ways we exploit animals; one for each of the health problems that are mitigated by a plant-based diet, etc.

To kickstart our goal of meeting this expanded mission, we are offering paid assignments for new articles. We expect these paid assignments to continue until at least the foundational articles needed are completed. These paid assignments will in no way stop writers from contributing their time to the wiki without remuneration.

Our current rate of eight cents per-word USD is at least competitive, if not high, for non-profit assignments. As an example of what you can earn, our 6,568-word article on Chickens would pay $525, while a short article like the one on Honey would pay $123. These numbers assume you have contributed all the words to the article.

To learn more about writing assignments, both paid and unpaid, see Writing Assignments.

Articles Needed

The focus for new articles in the near-term will be foundational articles that need to be written to fully realize the site's new mission of being an encyclopedic resource. You can find a list of these foundational articles in our vision for a future home page.

Technical Help

Technical help can be found at Help:Technical Help and Hints.

Qualifications

Our ideal writer, particularly those writing new articles under assignment:

  • cares about animal rights and veganism
  • can write with a friendly voice
  • holds a college degree or equivalent work experience
  • has experience authoring and/or editing online content
  • possesses a willingness and an ability to perform academic research
  • is committed to providing high-quality, accurate information
  • can take direction from editors and work in a collaborative environment.

Expectations

Before you consider writing for us, you need to understand the kind of writing that will be expected and accepted. This is covered in the Content Guidelines. But the best way to get a feel for what is expected is to familiarize yourself with existing articles. As the Content Guidelines explain, the articles on this site are written in an informal academic tone with an objective point of view, and substantively differ from articles on other wiki sites such as Wikipedia.

Because providing credible citations for factual statements is a requirement, much of the time spend on an article will be spent in research. If you are a new contributor to the site, we will more closely monitor your progress on an article to help ensure you stay on track and that you don't waste time on content that will not be accepted.

Creating an Account and Your User Page

Before you can write articles and edit content, you need to create an account and verify your email address, according to the guidance offered in the article Help:Your Account and Personalization. Creating an account offers benefits beyond just enabling editing, as is discussed in the article.

Contributors, Editors, Moderation, and Approval

Due to the nature of the subject matter on this site, we are using a multilevel moderation and approval system which will render vandalism pointless and encourage compliance with our guidelines. As a user, your edits will require moderation (acceptance) before they become part of page history and become visible to other users.

As you make more edits, you have a chance to progress from user to other more trusted levels:

  • Contributor: Your edits bypass moderation and show up in page history. They must still be approved to show up in the default view of a page, but your changes are readily viewable by anyone.
  • Senior Contributor: Your edits bypass both moderation and approval, but could still be reversed by an editor.
  • Moderator: You provide the first level of defense against vandalism, misuse, and other violations.
  • Topic Editor: You provide compliance oversight of one subject area, such as ethics, environment, health, or ethics.
  • Copy Editor: You contribute to the style guides and help enforce compliance with the style guides and other guidelines. A copy editor also edits to improve readability, clarity, fitness for purpose, grammar, and style.
  • Managing Editor: The managing editor takes the lead in managing the site and its contributed content.

At any level, all contributions to JFA Wiki may be edited and substantially altered by other users. It's also possible your edits could be reversed.

The following may result in you being blocked from further participation:

  • Reversing edits made by editors.
  • Consistently submitting content that violates guidelines.