Writer's guide

  • Revision slug: Project:Writer's_guide
  • Revision title: Writer's guide
  • Revision id: 70073
  • Created:
  • Creator: Dria
  • Is current revision? No
  • Comment

Revision Content

{{template.Devmo_editor_TOC()}}

Introduction

This is just the beginning of a writer's guide for the MDC. If you have questions about usage and style that aren't covered there, I recommend referring to the Economist style guide or, failing that, the Chicago Manual of Style.

We will be expanding the guide over time, so if you do have specific questions that aren't covered by the writer's guide, please send them to the MDC mailing list or project lead so we know what should be added.

Page name and heading capitalization

  • Page names and section headings should use sentence style capitalization (only capitalize the first word and any proper nouns) rather than headline style capitalization:
    • Correct: "A new method for creating JavaScript rollovers"
    • Incorrect: "A New Method for Creating JavaScript Rollovers"

Latin abbreviations

  • Common latin abbreviations (etc., i.e., e.g.) may be used in parenthetical expressions and in notes. Use periods in these abbreviations.
    • Correct:
    • Incorrect:
  • In regular text (i.e. text outside of notes or parentheses), use the English equivalent of the abbreviation.
    • Correct:
    • Incorrect:

Meanings and English equivalents of Latin abbreviations

Abbrev Latin English
cf. confer compare
e.g. exempli gratia for example
et al. et alii and others
etc. et cetera and so forth, and so on
i.e. id est that is
N.B. nota bene note well
P.S. post scriptum postscript

N.B. Be careful not to confuse "e.g." with "i.e."

Acronyms and abbreviations

Revision Source

<p>
{{template.Devmo_editor_TOC()}}
</p>
<h3 name="Introduction"> Introduction </h3>
<p>This is just the beginning of a writer's guide for the MDC.  If you have questions about usage and style that aren't covered there, I recommend referring to the <a class="external" href="http://www.economist.com/research/StyleGuide/">Economist style guide</a> or, failing that, the <a class="external" href="http://www.amazon.com/gp/product/0226104036/">Chicago Manual of Style</a>.
</p><p>We will be expanding the guide over time, so if you do have specific questions that aren't covered by the <a href="Project:en/Writer's_guide">writer's guide</a>, please send them to the <a href="Project:en/Community">MDC mailing list</a> or <a href="User:Dria">project lead</a> so we know what should be added.
</p>
<h3 name="Page_name_and_heading_capitalization"> Page name and heading capitalization </h3>
<ul><li> Page names and section headings should use sentence style capitalization (only capitalize the first word and any proper nouns) rather than headline style capitalization:
<ul><li> <font color="green"><b>Correct</b></font>: "A new method for creating JavaScript rollovers"
</li><li> <font color="red"><b>Incorrect</b></font>: "A New Method for Creating JavaScript Rollovers"
</li></ul>
</li></ul>
<h3 name="Latin_abbreviations"> Latin abbreviations </h3>
<ul><li> Common latin abbreviations (etc., i.e., e.g.) may be used in parenthetical expressions and in notes.  Use periods in these abbreviations.
<ul><li> <font color="green"><b>Correct</b></font>: 
</li><li> <font color="red"><b>Incorrect</b></font>: 
</li></ul>
</li><li> In regular text (i.e. text outside of notes or parentheses), use the English equivalent of the abbreviation.
<ul><li> <font color="green"><b>Correct</b></font>:
</li><li> <font color="red"><b>Incorrect</b></font>: 
</li></ul>
</li></ul>
<h4 name="Meanings_and_English_equivalents_of_Latin_abbreviations"> Meanings and English equivalents of Latin abbreviations </h4>
<table class="fullwidth-table">
<tbody><tr>
<th>Abbrev</th>
<th>Latin</th>
<th>English</th>
</tr>
<tr>
<td>cf.</td>
<td><i>confer</i></td>
<td>compare</td>
</tr>
<tr>
<td>e.g.</td>
<td><i>exempli gratia</i></td>
<td>for example</td>
</tr>
<tr>
<td>et al.</td>
<td><i>et alii</i></td>
<td>and others</td>
</tr>
<tr>
<td>etc.</td>
<td><i>et cetera</i></td>
<td>and so forth, and so on</td>
</tr>
<tr>
<td>i.e.</td>
<td><i>id est</i></td>
<td>that is</td>
</tr>
<tr>
<td>N.B.</td>
<td><i>nota bene</i></td>
<td>note well</td>
</tr>
<tr>
<td>P.S.</td>
<td><i>post scriptum</i></td>
<td>postscript</td>
</tr>
</tbody></table>
<p>N.B. Be careful not to confuse "e.g." with "i.e."
</p>
<h3 name="Acronyms_and_abbreviations"> Acronyms and abbreviations </h3>
Revert to this revision