Help:Style Guide
From JFA Wiki
Revision as of 18:23, 2 May 2019 by Greg.Fuller (talk | contribs)
Read This First
The Chicago Manual of Style (17th Edition) is JFA's main style guide; therefore, most of JFA’s style will not be listed here. However, since this page lists both a) style decisions unique to JFA and b) all the ways in which JFA’s style deliberately diverts from the CMOS, this page always takes first priority.
- For spelling, use the first spelling entry in the online Merriam-Webster Collegiate Dictionary. This can be found (with subscription) by traveling to http://unabridged.merriam-webster.com/ and selecting Collegiate via the Reference drop-down menu. Exceptions will be listed below, in the (future) TERMINOLOGY section.
- If that dictionary doesn’t contain a term or all a term's necessary information (e.g., spelling for plurals, verb endings, etc.), consult the online Merriam-Webster Unabridged Dictionary (also requiring subscription) via the same link but with Unabridged selected in the drop-down menu.
- If a rule conflicts with what is generated by standard wiki markup (and if overcoming that standard markup would result in extra work), consider using the wiki convention and documenting that somewhere appropriate.
Bold text examples represent the correct way to style text. Non-bold text examples (which generally appear beneath bold ones) represent incorrect ways to style text.
Punctuation
Apostrophes
- Use curly apostrophes, not straight ones
- I can’t believe you don’t like seitan!
- I can't believe you don't like seitan!
Colons
- Using a colon after an introductory sentence fragment
- If what comes after the colon is a full sentence, capitalize after the colon
- Note: These are words.
- Note: these are words.
- If what comes after the colon is not a full sentence, lowercase after the colon
- Example: sheep.
- Example: Sheep.
Commas
- Use a comma before “too” (when meaning “also")
- And we want to see you there, too!
- And we want to see you there too!
- And you, too, are appreciated.
- And you too are appreciated.
- Don’t waste too much time!
- Don’t waste, too much time!
- Use a comma before “either” (when appropriate)
- We shouldn’t waste time, either.
- We shouldn’t waste time either.
- I can’t tell if either is joking.
- I can’t tell if, either is joking.
- Use a comma before “also” (when appropriate)
- We’ll be stopping in New York, also.
- We’ll be stopping in New York also.
- We’ll also be stopping in New York.
- We’ll, also be stopping in New York.
- Do not use a comma before “as well”
- I need a mask as well.
- I need a mask, as well.
Ellipses
- Use them sparingly
- Use an unspaced ellipsis character (ALT+0133 on PC, OPTION+; on Mac)…
- at the end of a complete sentence that is trailing off
- Speciesism has seen its end…
- Speciesism has seen its end….
- Speciesism has seen its end. . .
- Speciesism has seen its end . . .
- Speciesism has seen its end...
- at the end of an incomplete sentence that is trailing off
- But I don’t think we…
- But I don’t think we....
- But I don’t think we. . .
- But I don’t think we . . .
- But I don’t think we...
- at the beginning of a sentence that has an initial dramatic pause
- We are AV. …Expect us.
- We are AV…Expect us.
- We are AV. ….Expect us.
- We are AV….Expect us.
- We are AV. . . .Expect us.
- We are AV . . . Expect us.
- We are AV. ...Expect us.
- We are AV...Expect us.
- in the middle of a sentence when a distinct pause is desired
- It’s time…that we got serious.
- It’s time….that we got serious.
- It’s time. . .that we got serious.
- It’s time . . . that we got serious.
- It’s time...that we got serious.
- It’s time … that we got serious.
- It’s time… that we got serious.
- It’s time …that we got serious.
Exclamation points
- Avoid them
- The evidence for environmental destruction is clear.
- The evidence for environmental destruction is clear!
- Why would anyone knowingly support cruelty?
- Why would anyone knowingly support cruelty?!
- Never use more than a single exclamation point in a row
- Let’s make some vegans!
- Let’s make some vegans!!
- Let’s make some vegans!!!
- Let’s make some vegans!!!!!!!!!!
Multiple punctuation marks
- Use “?!” and never “!?”
- What do you mean?!
- What do you mean!?
- What do you mean?!!
- What do you mean!??
Question marks
- Never use more than a single question mark in a row
- Who’s ready to make history?
- Who’s ready to make history??
- Who’s ready to make history???
Quotation marks
- Use curly quotation marks (the default for Google Docs), not straight ones
- I said, “I’ll never miss a Cube.”
- I sad, "I’ll never miss a Cube."
Titles
Page Titles
- Avoid apostrophes; write around the need to use them
- The Final Fall of Carnism
- Carnism's Final Fall
- I cannot go vegan because I am lazy.
- I can't go vegan because I'm lazy.
- Avoid em dashes; use these methods (appropriately) to write around them:
- Rewording
- I am a lion, so I must eat meat!
- I am a lion, and I must eat meat!
- I am a lion and so must eat meat!
- Because I am a lion, I must eat meat!
- I am a lion. I must eat meat!
- I am a lion! I must eat meat!
- I am a lion—I must eat meat!
- Colon
- It finally happened: I am vegan.
- It finally happened—I am vegan.
- Semicolon
- I am a monster; I actually like soy.
- I am a monster—I actually like soy.
- Parentheses or spaced hyphens
- I like veggies (if they are cooked well, that is).
- I like veggies - if they are cooked well, that is.
- I like veggies—if they are cooked well, that is.
- When (if ever) will it end?
- When - if ever - will it end?
- When—if ever—will it end?
[Expand] Titles
- Begin the title with either "Extra:" or "Details:"
- Extra: Animal Lives "Saved" versus "Prevented"
- Details: Animal Lives "Saved" versus "Prevented"
- Animal Lives "Saved" versus "Prevented"
- Use headline-style capitalization
- Extra: More on "Cruelty Free"
- Extra: More on "cruelty free"
Reply Titles
- Use the prefix In reply to: followed by a space and the actual title
- In reply to: Every vegan I have met is weak or unintelligent
- Every vegan I have met is weak or unintelligent
- Use sentence-style capitalization
- In reply to: I hate vegetables, and my canines do, too
- In reply to: I Hate Vegetables, and My Canines Do, Too
- Avoid terminal punctuation (except in the meta-title). It causes problems with social media sharing.
- In reply to: Every vegan I have met is weak or unintelligent
- In reply to: Every vegan I have met is weak or unintelligent.
- In reply to: Every vegan I have met is weak or unintelligent!
- Use terminal punctuation in the meta title of the jfa-meta template, which is placed in the text of the article near the bottom. This causes the properly punctuated version to appear as the title.
- {{jfa-meta | meta-title = In reply to: Every vegan I have met is weak or unintelligent. …}}
- Phrase the title as a supposed statement of fact that a non-vegan would say when arguing against veganism
- In rely to: Lions are not vegan; therefore, I cannot be vegan
- In reply to: Non-vegans falsely imply that humans have the same needs as lions"
Fact-Sheet Titles
- Use sentence-style capitalization
- Animal agriculture is the number-one cause of deforestation
- Animal Agriculture Is the Number-One Cause of Deforestation
- Avoid terminal punctuation (except in the meta-title). It causes problems with social media sharing.
- Veganism as an ethical stance has existed for thousands of years
- Veganism as an ethical stance has existed for thousands of years.
- Use terminal punctuation in the meta title of the jfa-meta template, which is placed in the text of the article near the bottom. This causes the properly punctuated version to appear as the title.
- {{jfa-meta | meta-title = Veganism as an ethical stance has existed for thousands of years. …}}
- Word titles as true statements of real-world facts
- A reduction in demand causes a reduction in supply.
- A reduction in demand will make the world vegan overnight.
- You are a bad person if you buy animal products.
- Supply and demand.
The Rest
Abbreviations
- Don't use abbreviations for social-media platforms; write out the platforms' names
- See our latest post on Facebook and Instagram.
- See our latest post on FB and IG.
Buttons
- When referencing a button, match the capitalization of the actual button
- Visit CONTACT US on our website.
- Visit Contact Us on our website.
- Quotation marks
- If button-reference text uses block caps or headline-style capitalization, do not use quotation marks
- Click Next and then Submit.
- Click “Next” and then “Submit.”
- The GET INVOLVED button will get you started.
- The “GET INVOLVED” button will get you started.
- If button-reference text uses all lowercase or sentence-style capitalization, do use quotation marks
- Select “Proceed to checkout” to complete your purchase.
- Select Proceed to checkout to complete your purchase.
- Go to “show more” for extended options.
- Go to show more for extended options.
Citations
- Place citations immediately after the text they support
- Sixty billion land animals are slaughtered for food every year.[1] You read that right.
- Sixty billion land animals are slaughtered for food every year. You read that right.[1]
- Place citations immediately after and against the text they support (with no space).
- Phil Collins rocks.[2]
- Phil Collins rocks. [2]
- For multiple citations, place them one after another, each separated by a space but no punctuation
- This info took a lot of research.[3] [4] [5] [6]
- This info took a lot of research.[3][4][5][6]
- This info took a lot of research.[3], [4], [5], [6]
Dates
- For days of the month, use ordinal numbers
- My birthday is September 28th.
- My birthday is September 28.
- Spell out month names if possible; abbreviate only if necessary
- AV’s first ICD was on November 5th, 2017.
- AV’s first ICD was on Nov. 5th, 2017.
- Avoid using the slash format (since US and UK reverse the order); if a numbers-only format is required, use ISO, which is YYYY-MM-DD
- Cube of Truth, Nov. 3rd, 2018
- Cube of Truth, 2018-11-03
- Cube of Truth, 11/3/2018
- Cube of Truth, 3/11/2018
- Include the year with every date (unless the year is implied)
- Our day with the most tallies was on November 3rd, 2018.
- Our day with the most tallies was on November 3rd.
- Last year, ICD was on November 5th.
- Last year, ICD was on November 5th, 2017.
- Use BCE and CE, not BC and AD
- The Old Testament was written in XX BCE; the New Testament, in XX CE.
- The Old Testament was written in XX BC; the New Testament, in XX AD.
Internationality
- Avoid words that are generally only used in limited countries
- Use the restroom before the demo.
- Use the loo before the demo.
- Use the washroom before the demo.
- Avoid words that would have undesired or unclear meanings in other countries
- After the Cube, we came home drunk.
- After the Cube, we came home angry.
- After the Cube, we came home pissed.
- Include the country when mentioning a city
- AV was founded in Melbourne, Australia.
- AV was founded in Melbourne.
- Include at least the state (written out or abbreviated) when mentioning a US city
- Next in the tour is Seattle, Washington.
- Next in the tour is Seattle, Washington, USA.
- Next in the tour is Seattle, USA.
- Next in the tour is Seattle.
- When mentioning an AV chapter, write only “AV:” plus the city name
- AV: Melbourne kicked ass!
- AV: Melbourne, Australia kicked ass!
- Also see the Temperature section
Latin
- Avoid Latin constructions; use English equivalents instead
- I hate animal products—for example, meat, dairy, eggs…
- I hate animal products (for example, meat, dairy, eggs)…
- I hate animal products—e.g., meat, dairy, eggs…
- I hate animal products (e.g., meat, dairy, eggs)…
- I hate animal products, e.g., meat, dairy, eggs…
Legality
- Avoid trademarked terms
- The carnist needs a bandage for his hurt ego.
- The carnist needs a band-aid for his hurt ego.
- The carnist needs a Band-Aid for his hurt ego.
- The carnist needs a bandaid for his hurt ego.
Lists
- For list items, use sentence-style capitalization
- Pretend I'm a list item
- Pretend I'm a List Item
- pretend I'm a list item
Measurements with units
- Use numerals, not written-out numbers
- We held 20 kilograms each
- We held twenty kilograms each
- Use the International System of Units; if space allows, put the imperial equivalent in parentheses
- Our TVs are only 30 centimeters (1 foot) across
- Our TVs are only 30 centimeters across
- Spell out units when possible
- The Cube space was 3 meters by 3 meters
- The Cube space was 3 m by 3 m
Numbers
- Write out numbers 0–9
- Seattle had five volunteers.
- Seattle had 5 volunteers.
- Write numbers 10+ as numerals
- We’ve planned 21 Cubes.
- We’ve planned twenty-one Cubes.
- For numbers 100+, either write out or use numerals (depending on whichever seems most impactful for the exact context)
- 100 PIGS RESCUED; 17,000 MORE TO COME
- ONE HUNDRED PIGS RESCUED; SEVENTEEN THOUSAND MORE TO COME
- We’ve reached ten trillion followers.
- We’ve reached 10,000,000,000,000 followers.
- Numbers at the beginning of sentences should be written out
- Twelve months ago, AV first launched.
- 12 months ago, AV first launched.
- In a sequence of similar numbers, write all numbers as numerals
- This week, we got 3, 4, and 15 tallies.
- This week, we got three, four, and 15 tallies.
- This week, we got three, 4, and 15 tallies.
- This week, we got 3, four, and 15 tallies.
- This week, we got three, four, and fifteen tallies.
- For negative numbers, us a minus sign (−), not a standard keyboard hyphen (-)
- I give −8 cares.
- I give -8 cares.
Percents
- Use the percent symbol instead of spelling out “percent”
- Volunteer count increased by 50% this year.
- Volunteer count increased by 50 percent this year.
Plant-based
- Only use “plant-based” when referring to a diet of plants, not an ethical choice of living vegan
- For better health, try a plant-based diet; for better ethics, live vegan.
- For better health, live vegan; for better ethics, try a plant-based diet.
Pronouns
- Never use “it” to refer to an animal; instead, use “he,” “she,” or the singular “they”
- Your service animal never gave consent. They deserve better.
- Your service animal never gave consent. She deserves better.
- Your service animal never gave consent. He deserves better.
- Your service animal never gave consent. It deserves better.
Social-media terms
- The Facebook term “like” (used as a noun or a verb) should be go in quotation marks
- Please “like” this post to vote for a date.
- Please like this post to vote for a date.
- Please Like this post to vote for a date.
- Once this post reaches 2,000 “likes”...
- Once this post reaches 2,000 likes...
- Once this post reaches 2,000 Likes...
Tables
- For table titles, use headline-style capitalization
- This Is the Title of My Table
- This is the title of my table
- For column and row heading cells, use headline-style capitalization
- Animal Products Used for Food
- Animal products used for food
- For body cells, use sentence-style capitalization without terminal punctuation
- This is text in cell B4
- This is text in cell B4.
- This Is Text In Cell B4
Temperature
- Write temperatures in Celsius, with Fahrenheit immediately after in parentheses
- I couldn’t believe it went to −30℃ (−22℉).
- I couldn’t believe it went to −30℃.
- I couldn’t believe it went to −22℉.
- I couldn’t believe it went to −22℉ (−30℃).
- Abbreviate “degrees,” “Celsius,” and “Fahrenheit” instead of writing them out
- Cook the food to 40℃ (104℉).
- Cook the food to 40 degrees Celsius (104 degrees Fahrenheit).
- When abbreviating, use the special characters ℃ and ℉ instead of ° plus a letter
- It was 0℃ (32℉) outside.
- It was 0°C (32°F) outside.
- For negative temperatures, use a minus sign (−), not a standard keyboard hyphen (-)
- It didn’t get as high as −20℃ (−4℉).
- It didn’t get as high as -20℃ (-4℉).
Terms
- When calling out terms as foreign or vocabulary in nature, italicize the term
- The definition of free range is laughable.
- The definition of "free range" is laughable.
- The definition of free range is laughable.
- The definition of FREE RANGE is laughable.
- The definition of free range is laughable.
Times
- Put time-zone designations inside parentheses
- The Cube starts at 1 p.m. (PST).
- The Cube starts at 1 p.m. PST.
- The Cube starts at 1 p.m., PST.
Terminology
All words, terms, and phrases should be written exactly as depicted below (unless their location within a sentence requires otherwise).
- anti-speciesism — NOT antispeciesism
- animal rights (noun, adjective) — NOT animal-rights
- blog post — NOT Blog Post
- copy and paste (verb) — NOT copy-paste, copy/paste
- cow's milk — NOT cow milk, cows' milk
- fact sheet — NOT Fact Sheet
- home page — NOT homepage, Home Page, Home page
- non-human (noun, adjective) — NOT nonhuman
- non-vegan (noun, adjective) — NOT nonvegan
- plain-text (adjective) — NOT plaintext, plain text
- reply — NOT Reply
- social justice (adjective) — NOT social-justice
- summary — NOT Summary
- table — NOT Table
- whole-food plant-based diet — NOT...anything else