Skip to content

Commit

Permalink
Fixes Bug 1062441 - Add anchors
Browse files Browse the repository at this point in the history 
* Adds anchors linking parts of page
  • Loading branch information
@utkbansal @alexgibson
utkbansal authored and alexgibson committed Feb 2, 2015
1 parent a5dc49c commit 2c5e49c
Showing 1 changed file with 89 additions and 89 deletions.
178 changes: 89 additions & 89 deletions bedrock/styleguide/templates/styleguide/communications/copy-rules.html
View file
Expand Up @@ -28,191 +28,191 @@ <h2>Introduction</h2>
<h2>A–Z</h2>
</div>
<dl>
<dt>a11y</dt>
<dt id="a11y">a11y</dt>
<dd>our abbreviation for accessibility (11 letters between the A and Y), reserved for internal use or where space is a consideration, otherwise please avoid or explain on first use</dd>
<dt>acronyms</dt>
<dt id="acronyms">acronyms</dt>
<dd>uppercase with no periods, unless they are specifically part of a brand name or the result spells out a different word</dd>
<dt>add-ons</dt>
<dt id="add-ons">add-ons</dt>
<dd>see “Firefox Add-ons”</dd>
<dt>AMO</dt>
<dt id="amo">AMO</dt>
<dd>our internal name for addons.mozilla.org; do not use in any user-facing communications</dd>
<dt>capitalization</dt>
<dt id="capitalization">capitalization</dt>
<dd>unless there is an entry stating otherwise, please capitalize the following: brands and products (Mozilla, Firefox, Persona, Marketplace, etc.); features (Panorama, etc.); acronyms (URL, etc.). URLs themselves (mozilla.org, firefox.com, etc.) are lowercase</dd>
<dt>channels</dt>
<dt id="channels">channels</dt>
<dd>our term for the various builds of our products; please avoid in user-facing communications</dd>
<dt>customers</dt>
<dt id="customers">customers</dt>
<dd>do not use: we refer to “users” or “people”</dd>
<dt>double-click</dt>
<dt id="double-click">double-click</dt>
<dd>hyphenated in all forms and uses</dd>
<dt>email</dt>
<dt id="email">email</dt>
<dd>one word, lowercase, no hyphen</dd>
<dt>features</dt>
<dt id="features">features</dt>
<dd>individual product features are capitalized, unless there is an entry stating otherwise</dd>
<dt>Fennec</dt>
<dt id="fennec">Fennec</dt>
<dd>internal code name for our mobile efforts as a whole, does not refer to any specific product and should not be used in outbound messaging</dd>
<dt>Final Release</dt>
<dt id="final-release">Final Release</dt>
<dd>our internal name for the mainstream releases of Firefox and Thunderbird; do not use in user-facing communications</dd>
<dt>Firefox</dt>
<dt id="firefox">Firefox</dt>
<dd>make sure to clearly specify whether you are talking about the Firefox family of products or one of those products (i.e. the Firefox browser) specifically; always capitalized unless appearing as part of a URL</dd>
<dt>Firefox Accounts</dt>
<dt id="firefox-accounts">Firefox Accounts</dt>
<dd>accounts is capitalized when it follows Firefox, lowercase when on its own; it can be singular or plural as needed and is always localized</dd>
<dt>Firefox Add-ons</dt>
<dt id="firefox-add-ons">Firefox Add-ons</dt>
<dd>add-ons is capitalized when it follows Firefox, lowercase when on its own, though the O is always lowercase; it can be singular or plural as needed and is always localized</dd>
<dt>Firefox Beta</dt>
<dt id="firefox-beta">Firefox Beta</dt>
<dd>Firefox Beta on first mention, Beta on subsequent mentions, always capitalized</dd>
<dt>Firefox Beta for mobile</dt>
<dt id="firefox-beta-for-mobile">Firefox Beta for mobile</dt>
<dd>“Beta for mobile” is also acceptable, but never “mobile Beta;” mobile is always lowercase</dd>
<dt>Firefox browser</dt>
<dt id="firefox-browser">Firefox browser</dt>
<dd>use this to differentiate from the Firefox family of products or from another specific Firefox product (Firefox Marketplace, Firefox OS, etc.); browser is always lowercase</dd>
<dt>Firefox Developer Edition</dt>
<dt id="firefox-developer-edition">Firefox Developer Edition</dt>
<dd>Firefox Developer Edition on first mention, Developer Edition on subsequent mentions, both words always capitalized</dd>
<dt>Firefox for Android</dt>
<dt id="firefox-for-android">Firefox for Android</dt>
<dd>use this in most cases when referring to the mobile browser (see also “Firefox browser”); Android is always capitalized; never “Firefox Android,” “Firefox on Android” or any other variation</dd>
<dt>Firefox for desktop</dt>
<dt id="firefox-for-desktop">Firefox for desktop</dt>
<dd>use this to differentiate from the mobile browser (see also “Firefox browser”); desktop is always lowercase; never “desktop Firefox” or “Firefox desktop”</dd>
<dt>Firefox for mobile</dt>
<dt id="firefox-for-mobile">Firefox for mobile</dt>
<dd>mobile is always lowercase; never “mobile Firefox” or “Firefox mobile”</dd>
<dt>Firefox Marketplace</dt>
<dt id="firefox-marketplace">Firefox Marketplace</dt>
<dd>Firefox Marketplace on first mention, Marketplace is acceptable on subsequent mentions, always capitalized; never “Mozilla Marketplace”</dd>
<dt>Firefox Nightly</dt>
<dt id="firefox-nightly">Firefox Nightly</dt>
<dd>Firefox Nightly on first mention, Nightly on subsequent mentions, always capitalized</dd>
<dt>Firefox OS</dt>
<dt id="firefox-os">Firefox OS</dt>
<dd>the official name of the project formerly known as Boot to Gecko (or B2G); always use the complete name; do not use “the Firefox OS” unless it is being treated as an adjective (e.g. the Firefox OS experience, the Firefox OS home screen, etc.)</dd>
<dt>Firefox Themes</dt>
<dt id="firefox-themes">Firefox Themes</dt>
<dd>themes is capitalized when it follows Firefox, lowercase when on its own; it can be singular or plural as needed and is always localized; formerly “Firefox Personas”</dd>
<dt>free</dt>
<dt id="free">free</dt>
<dd>this one is tricky as it means both “without cost” and “without restrictions” in English, though there are separate words for these concepts in many other languages; please be very clear when using or avoid</dd>
<dt>fullscreen</dt>
<dt id="fullscreen">fullscreen</dt>
<dd>one word, lowercase, when referring to the view mode of the browser; use “entire screen,” “whole screen” or similar formulation in other cases</dd>
<dt>FxOS</dt>
<dt id="fxos">FxOS</dt>
<dd>for internal usage, this is the official abbreviation of “Firefox OS,” but it should not be used in any external communications</dd>
<dt>gear</dt>
<dt id="gear">gear</dt>
<dd>used to refer to any branded merchandise, be it Mozilla, Firefox or any of our other brands; please use instead of “swag” or “merchandise”</dd>
<dt>http://</dt>
<dt id="http">http://</dt>
<dd>this should never appear before a URL in communications unless there is a very good reason (though we can’t think of one off the tops of our heads)</dd>
<dt>i18n</dt>
<dt id="i18n">i18n</dt>
<dd>our abbreviation for internationalization (18 letters between the I and N), reserved for internal use or where space is a consideration, otherwise please avoid or explain on first use</dd>
<dt>Internet</dt>
<dt id="internet">Internet</dt>
<dd>always capitalized</dd>
<dt>Join Mozilla</dt>
<dt id="join-mozilla">Join Mozilla</dt>
<dd>refers specifically to the fundraising campaign and should not be used in other contexts; both words are capitalized and “Join” should never become “Joins,” “Joining” or any other form of the word</dd>
<dt>l10n</dt>
<dt id="l10n">l10n</dt>
<dd>our abbreviation for localization (10 letters between the L and N), reserved for internal use or where space is a consideration, otherwise please avoid or explain on first use</dd>
<dt>left-click</dt>
<dt id="left-click">left-click</dt>
<dd>hyphenated in all forms and uses</dd>
<dt>merch/merchandise</dt>
<dt id="merchandise">merch/merchandise</dt>
<dd>please use “gear” to refer to branded merchandise</dd>
<dt>mobile</dt>
<dt id="mobile">mobile</dt>
<dd>lowercase, even if it follows Firefox; see also “Firefox for mobile”</dd>
<dt>mobile device</dt>
<dt id="mobile-device">mobile device</dt>
<dd>in general, use this instead of “phone” or “tablet” unless you are purposely differentiating between the two</dd>
<dt>mobile phone</dt>
<dt id="mobile-phone">mobile phone</dt>
<dd>use only to differentiate from a tablet, otherwise use “mobile device”</dd>
<dt>mobile tablet</dt>
<dt id="mobile-tablet">mobile tablet</dt>
<dd>redundant, do not use</dd>
<dt>Moz</dt>
<dt id="moz">Moz</dt>
<dd>we do not generally abbreviate the Mozilla name, unless otherwise noted in this guide; please avoid</dd>
<dt>MozCamp/MozCamps</dt>
<dt id="mozcamp">MozCamp/MozCamps</dt>
<dd>regional gatherings of volunteer and paid staff that happen several times a year around the world (MozCamp Asia, MozCamp LatAm, etc.); note the capitalization</dd>
<dt>Mozilla</dt>
<dt id="mozilla">Mozilla</dt>
<dd>make sure Mozilla is well established early or prominently in any writing or communications (Tabzilla satisfies this requirement, for example), either as part of a product name (Mozilla Firefox, Mozilla Webmaker, etc.) or on its own, but do not use any compound constructions (like Mozilla Firefox Marketplace); even though the Mozilla wordmark is lowercase, Mozilla should be capitalized in all other uses, unless as part of a URL (mozilla.org)</dd>
<dt>Mozilla Labs</dt>
<dt id="mozilla-labs">Mozilla Labs</dt>
<dd>though the Mozilla Labs wordmark is lowercase, always capitalize both words in regular text; Mozilla Labs on first mention, Labs on subsequent mentions</dd>
<dt>Mozilla Reps</dt>
<dt id="mozilla-reps">Mozilla Reps</dt>
<dd>always two words, always capitalized</dd>
<dt>Mozilla Space/Spaces</dt>
<dt id="mozilla-space">Mozilla Space/Spaces</dt>
<dd>official terms for a specific group of Mozilla offices around the world, which include open space for the community; current locations or those in the works include San Francisco, Toronto, London, Berlin, Tokyo, Auckland, Beijing, Paris and Vancouver</dd>
<dt>Mozilla Webmaker</dt>
<dt id="mozilla-webmaker">Mozilla Webmaker</dt>
<dd>Mozilla Webmaker on first mention, Webmaker on subsequent mentions, always capitalized</dd>
<dt>Mozillians</dt>
<dt id="mozillians">Mozillians</dt>
<dd>refers to paid or volunteer staff of the Mozilla project; always uppercase unless part of a URL (mozillians.org)</dd>
<dt>MozSpace/MozSpaces</dt>
<dt id="mozspace">MozSpace/MozSpaces</dt>
<dd>informal terms for Mozilla Spaces reserved for internal use; do not use in any communications</dd>
<dt>non-profit</dt>
<dt id="non-profit">non-profit</dt>
<dd>though “nonprofit” is not incorrect, we prefer to use the hyphenated form</dd>
<dt> numbers</dt>
<dt id="numbers"> numbers</dt>
<dd>spell out as words from one to nine, use numerals 10 and up; spell out large numbers like thousand, million, etc. (see also “version numbers”)</dd>
<dt>open/open Web</dt>
<dt id="open-web">open/open Web</dt>
<dd>as the Web is open by its very nature, there is no need to make the distinction; not a forbidden term, but avoid where possible; when specifically and intentionally referring to the <a href=”http://en.wikipedia.org/wiki/Open_Web”>Open Web movement</a>, please capitalize</dd>
<dt>Pancake</dt>
<dt id="pancake">Pancake</dt>
<dd>uppercase when referring to the tablet browsing experiment, lowercase when referring to the delicious breakfast food</dd>
<dt>people</dt>
<dt id="people">people</dt>
<dd>though we mostly refer to “users,” this is also acceptable and either should be used instead of “customers”</dd>
<dt>Personas</dt>
<dt id="personas">Personas</dt>
<dd>use “Firefox Themes” instead; see that entry for usage details</dd>
<dt>phone</dt>
<dt id="phone">phone</dt>
<dd>see “mobile phone”</dd>
<dt>possessives</dt>
<dt id="possessives">possessives</dt>
<dd>though you may run into cases where it’s impossible, please avoid using possessives with our brands or product names where you can; see also “plurals”</dd>
<dt>plugin/plugins</dt>
<dt id="plugins">plugin/plugins</dt>
<dd>unless you're talking about physically plugging something in, this should be one word, lowercase, when referring to things like Flash and QuickTime</dd>
<dt>plurals</dt>
<dt id="plurals">plurals</dt>
<dd>as with possessives, it is preferable not to pluralize our brands or product names; try to reword if you can</dd>
<dt>product numbers</dt>
<dt id="product-numbers">product numbers</dt>
<dd>see “version numbers”</dd>
<dt>punctuation</dt>
<dt id="punctuation">punctuation</dt>
<dd>see punctuation section below</dd>
<dt>release numbers</dt>
<dt id="release-numbers">release numbers</dt>
<dd>see “version numbers”</dd>
<dt>ReMo</dt>
<dt id="remo">ReMo</dt>
<dd>our internal codename for Mozilla Reps; do not use in any user-facing communications</dd>
<dt>right-click</dt>
<dt id="right-click">right-click</dt>
<dd>hyphenated in all forms and uses</dd>
<dt>SUMO</dt>
<dt id="sumo">SUMO</dt>
<dd>our internal name for support.mozilla.org; do not use in any user-facing communications</dd>
<dt>swag</dt>
<dt id="swag">swag</dt>
<dd>please use “gear” to refer to branded merchandise</dd>
<dt>Sync</dt>
<dt id="sync">Sync</dt>
<dd>capitalized when talking about the feature in Firefox, lowercase when using it only as a descriptive term; avoid “Firefox Sync” where possible</dd>
<dt>tablet</dt>
<dt id="tablet">tablet</dt>
<dd>use primarily to differentiate from a phone, otherwise use “mobile device” where possible</dd>
<dt>Tabzilla</dt>
<dt id="tabzilla">Tabzilla</dt>
<dd>our internal name for the Mozilla universal tab that appears at the top of our sites; avoid using in user-facing communications or explain on first reference</dd>
<dt>themes</dt>
<dt id="themes">themes</dt>
<dd>see “Firefox Themes”</dd>
<dt>Thunderbird</dt>
<dt id="thunderbird">Thunderbird</dt>
<dd>capitalized unless appearing as part of a URL</dd>
<dt>Thunderbird Beta</dt>
<dt id="thunderbird-beta">Thunderbird Beta</dt>
<dd>Thunderbird Beta on first mention, Beta on subsequent mentions (but only if it’s absolutely which product you’re referring to), always capitalized</dd>
<dt>Thunderbird Daily</dt>
<dt id="thunderbird-daily">Thunderbird Daily</dt>
<dd>Thunderbird Daily on first mention, Daily on subsequent mentions, always capitalized</dd>
<dt>Thunderbird Earlybird</dt>
<dt id="thunderbird-earlybird">Thunderbird Earlybird</dt>
<dd>Thunderbird Earlybird on first mention, Earlybird on subsequent mentions, always capitalized</dd>
<dt>URL</dt>
<dd>all uppercase, no periods, but URLs themselves (mozilla.org, firefox.com, etc.) are lowercase</dd>
<dt>users</dt>
<dt id="users">users</dt>
<dd>use this or “people” instead of “customers”</dd>
<dt>version numbers</dt>
<dt id="version-numbers">version numbers</dt>
<dd>we no longer attach version numbers to releases of Firefox in any communications, though we do use them internally for tracking purposes</dd>
<dt>Web</dt>
<dt id="web">Web</dt>
<dd>always capitalized when on its own or part of a compound construction that doesn’t create a new word (Web page, Web feed, etc.); see individual entries for other uses</dd>
<dt>webcam</dt>
<dt id="webcam">webcam</dt>
<dd>one word, lowercase</dd>
<dt>webcast</dt>
<dt id="webcast">webcast</dt>
<dd>one word, lowercase</dd>
<dt>WebFWD</dt>
<dt id="webfwd">WebFWD</dt>
<dd>please note the capitalization, unless dealing with a URL (webfwd.org)</dd>
<dt>webmaster</dt>
<dt id="webmaster">webmaster</dt>
<dd>one word, lowercase</dd>
<dt>website</dt>
<dt id="website">website</dt>
<dd>all together now: one word, lowercase</dd>
<dt>www</dt>
<dt id="www">www</dt>
<dd>avoid using (like the plague!) before URLs; it is not 1999 anymore</dd>
</dl>
</section>

<section id="punctuation">
<h2 class="intro">Punctuation</h2>
<dl>
<dt>commas</dt>
<dt id="commas">commas</dt>
<dd>we do not use serial commas (also called Oxford commas) in Mozilla communications</dd>
<dt>dashes</dt>
<dt id="dashes">dashes</dt>
<dd>hyphens (-) are used to create a single idea out of two or more words and are always connected; en dashes (–) are used for ranges, like numbers and dates, and are also connected; em dashes (—) are used to set related, yet separate thoughts off from each other, either within a sentence or following it, and in either case they are not connected</dd>
<dt>exclamation points</dt>
<dt id="exclamation-points">exclamation points</dt>
<dd>it’s acceptable to use exclamation points, but don’t overdo it; they are not a replacement for creating genuine excitement in writing</dd>
<dt>quotation marks</dt>
<dt id="quotation-marks">quotation marks</dt>
<dd>punctuation generally goes inside quotation marks, including exclamation and question marks, unless the exclamation or question is part of the entire sentence, not just the portion contained in the quotation marks</dd>
<dt>slashes</dt>
<dt id="slashes">slashes</dt>
<dd>if it’s in a URL, it’s a forward slash, people, not a backslash</dd>
</dl>
</section>
Expand Down

0 comments on commit 2c5e49c

Please sign in to comment.