New Hart's Rules: Handbook of Style for Writers and Editors by Robert Ritter (Oxford University Press) is a useful reference for questions on punctuation and other aspects of presenting text.
Although all technical writers should ensure that they understand the rules for using apostrophes correctly, this is not a stylistic decision. The rules are clear and unequivocal, and the Apostrophe Protection Society explains them on its website.
Online discussions have shown that some writers feel strongly about this point. In traditional typesetting, the space between sentences was 1.5 times the space between words. Although two spaces were used to approximate this in typed documents, RSA (a qualification body for typing) does not specify this practice. Choice of font and publishing tool can affect the spacing between sentences. Many computer fonts provide the correct spacing after a full stop but some are known to have errors in their kerning tables. Double spaces confuse some justification algorithms, will be ignored when working in HTML and may be converted to single spaces by some publishing tools.
Most technical writers seem to prefer one space between sentences. This preference is supported by many sources, including The Chicago Manual of Style and the style guides of Microsoft, IBM, Sun and Apple. However, readers with dyslexia are said to find a larger space between sentences helpful. If using a single space results in sentences running together, there are three ways to increase the space between sentences:
Conjunctions like and and but are sometimes preceded by a comma. This is most commonly seen in lists of items. For example, I bought eggs, bacon, sausages, and bread. If the items are short and clear, as they are in this example, omitting the comma does not change the meaning. However, if the items in the list include the word and, the meaning can sometimes be ambiguous. For example, I would like to thank my parents, Joe and Mary. This might mean that the writer's parents are called Joe and Mary or it might refer to four separate people. Inserting a comma makes the second meaning clear: I would like to thank my parents, Joe, and Mary. For more complex content where there is a significant risk of confusion, many writers would change the word order and perhaps even use two sentences or a bulleted list to ensure clarity.
As the Oxford University Press retains the serial comma, the usage is also known as the Oxford comma. The Concise Oxford Companion to the English Language states:
(3) Commas are used to separate items in a list or sequence, as in cases already given. Usage varies as to the inclusion of a comma before and in the last item (bring a chair, a bottle of wine, and a good book). This practice is controversial and is known as the serial comma or Oxford comma, because it is part of the house style of Oxford University Press. It is often superfluous, and there are occasions when the sense requires it to be omitted, but on many occasions it serves to avoid ambiguity: These colours are available: red, green, yellow, and black and white as opposed to red, green, yellow and black and white.
"COMMA" Concise Oxford Companion to the English Language. Ed. Tom McArthur. Oxford University Press, 1998. Oxford Reference Online. Oxford University Press. Syndicated edition for Institute of Scientific and Technical Communicators. 2 July 2007
It is uncommon to use full stops in initialisations, so it's ISTC rather than I.S.T.C. This forms part of a trend in British English towards minimal punctuation, which has seen the disappearance of commas from the ends of lines in blocked-out addresses, full stops from the ends of headings, and apostrophes from terms such as the 1970s and PCs. Full stops are also disappearing from abbreviations, such as Mr, although they are still seen. There is a trend to use only one capital letter in acronyms (initialisations pronounced as words), such as Nato.
Most technical writers favour a clean and modern look, provided that it does not make the text harder to read or understand. Punctuation marks should be retained for organising clauses and sentences, although some technical writers avoid semi-colons.
The punctuation used in bulleted (which is spelled with one t like targeted) or numbered lists is a matter of choice. A common practice is to distinguish points that are complete sentences and points that complete the lead-in sentence. For the former, each point takes a concluding punctuation mark. For the latter, depending on house style, the last point may take a concluding punctuation mark (preceding points may take commas or semi-colons but this is becoming less common).
Kitchen appliances save time spent on domestic chores in many ways:
Common kitchen appliances include:
Points that are complete sentences start with an upper case letter. Points that follow on from the lead-in sentence may start with an upper or lower case letter but the convention chosen should be applied consistently.
Most British periodicals do not use a space between quantities and units, whereas most international standards require a space. Many writers prefer a thin space so that the quantity and unit are grouped and a non-breaking space avoids quantities becoming separated from their units (thin spaces are usually also non-breaking). Temperatures and computer storage values are sometimes excluded from the requirement for a space. Percentages are usually excluded and, strictly speaking, are not units.
The following table summarises some guidance from the British Standards Institution.
|Unit of measurement||Guidance||Source|
|Unit symbols||Are printed in roman (upright) type (irrespective of the type used in the rest of the text)||BS 5555:1993 (ISO 1000:1992) subclause 6.1|
|Remain unaltered in the plural|
|Have no final full stop except for normal punctuation (for example, at the end of a sentence)|
|Are written in lower case letters, except for the first letter being upper case when the name of the unit is derived from a proper name.|
|Spacing||The symbol is placed after the complete numerical value in the expression for a quantity, leaving a space between the numerical value and the unit symbol.||BS 5555:1993 (ISO 1000:1992) subclause 6.1|
|For the units degree, minute and second for plane angle, there shall be no space between the numerical value and the unit symbol.||BS 5555:1993/ ISO 1000:1992 Annex A 1-1|
|The symbol of the unit shall be placed after the numerical value in the expression for a quantity, leaving a space between the numerical value and the unit symbol.||BS 5775-0:1993 (ISO 31-0:1992) subclause 3.4|
|… the symbol °C for degree Celsius shall be preceded by a space when expressing a Celsius temperature.|
|The only exceptions to this rule are for the units degree, minute and second for plane angle, in which case there shall be no space between the numerical value and the unit symbol.|
|Temperature||The units of thermodynamic and Celsius temperature interval or difference are identical.||BS 5775-4:1993 (ISO 31-4:1992)|
|… such intervals or differences should be expressed in kelvins (K) or in degrees Celsius (°C).|
|Other names and symbols, such as 'degré', 'deg', 'degree centigrade' or 'degree', are deprecated.|
|… the symbol °C for the degree Celsius should be preceded by a space.|
The Bureau International des Poids et Mesures (BIPM) publishes the "SI brochure", now in its eighth edition. In addition, the National Physical Laboratory (NPL) publishes guidance on units of measurement and the American National Institute of Standards and Technology (NIST) publishes a "Guide to SI Units" (but the latter reflects American English and so metre is not spelled in accordance with international practice).
When abbreviating inches, in is clearer than ". The full word is more common in text (for example, a 42-inch screen) for this and other non-SI units.
Capital letters have some specific roles. New Hart's Rules states:
Capital letters in English are used to punctuate sentences, to distinguish proper nouns from other words, for emphasis, and in headings and work titles. It is impossible to lay down absolute rules for all aspects of capitalisation;
Writers should be consistent within a document or a set of documents. They should ensure their approach enhances rather than impedes readability and comprehension. Most style guides prefer other typographical means of emphasising words.
The use of capital letters in headings has declined. Headings often take only a single initial capital (sometimes called sentence case). However, where headings take initial capitals on all major words (sometimes called title case or headline style):
Perhaps the most controversial use of capitals is in creating proper nouns. As we have seen, this is correct but it should only be applied to true proper nouns. Some technical documents are peppered with inappropriate initial capitals. Proper nouns identify specific instances of generic nouns. For example, the generic noun window does not take an initial capital but the name of a specific example does: the Change Name window. It can be argued that window becomes part of the proper noun in a named example (and should therefore take an initial capital) but the usage shown seems more common.
The initialisation of proper nouns sometimes declines as they become incorporated into the language and treated as generic nouns. For example, World Wide Web is a proper noun but many people now write website for the generic noun. As an aside, on a related term, the Internet is a proper noun but an intranet is a generic noun (except when used for a particular company's intranet, in which case an initial capital might be used).
Three lengths of 'rule' characters exist:
The terms en-rule and em-rule derive from the width of the n and m characters but the difference in length between the characters (-, –, —) depends on the typeface.
A similar character is the mathematical minus sign used to show negative numbers. Although writers often use a hyphen in its place, it is a distinct character (usually between the en-rule and em-rule in length, –).
When compound words are formed, they tend to start as separate words which are then hyphenated and sometimes later turned into a single word. The speed at which single words are formed differs between regional variants of English. Hyphens are used less today than they once were (for example, web site or website but rarely web-site). The easiest way to be consistent is to choose one dictionary as your reference and then follow its preferences on hyphenation. However, as new terms evolve more quickly than established ones, it may be difficult to determine best practice for words with the same prefix. For example, Oxford lists email, showing e-mail as an alternative, but retains the hyphen in e-business and e-commerce. Some words may be more difficult to read without a hyphen (Oxford retains the hyphen in co-worker). Preferred variants are likely to change when new editions of dictionaries are published.
Some house styles avoid the en-rule to link ranges, using the word to instead. The concern is that the en-rule might be mistaken for a minus sign.
In some contexts, to implies up to but not including. Some writers use through to avoid this but others view that as an American convention. Ensure that the convention you choose is understood by your readers. You can add the word inclusive to clarify.
Conventionally, low numbers are written in words and higher numbers in numerals. Thresholds vary but words are often used for zero to ten in technical content, numbers below 100 in non-technical content, and one to twelve in music. Numbers at the start of sentences are usually written in words, while numbers with units are written in numerals. Where text contains many numbers, different conventions may be adopted for different roles (for example, 50 one-inch screws or ten 2 cm screws). Whatever convention you adopt, it's better to be consistent when citing ranges (for example, avoid five–15).
Some writers prefer to use numerals for all numbers. This makes it easier to scan text for numbers, which stand out more as numerals. However, this may not always be the effect you seek in a descriptive text.
Jakob Nielsen has suggested that all numbers should be written in numerals on-screen but ISTC members disputed whether delivery medium should be the deciding factor.
There are two aspects to the use of quotation marks:
Pocket Fowler's Modern English Usage states:
"quotation marks" Pocket Fowler's Modern English Usage. Ed. Robert Allen. Oxford University Press, 1999. Oxford Reference Online. Oxford University Press. Syndicated edition for Institute of Scientific and Technical Communicators. 11 June 2007
Note: Italics are often used in place of quotation marks to emphasise terms, such as gigabyte above.
There are two symbols related to trademarks: ® indicates that ownership has been registered and ™ indicates that ownership is claimed. Trademark owners use these symbols to protect their trademarks. Other parties using trademarks should identify their ownership, usually in the front matter of a document and, except in textbooks, on first use in the text. It is unnecessary to repeat the symbol on every use and doing so impairs readability.
Some companies make a global claim that trademarks are registered, and must be indicated as such, when they are only registered in certain territories. Writers should check this with their legal department.
This article was originally posted on the website of the Institute of Scientific and Technical Communicators. Credits and copyright completely belong to ISTC.
Evaluation is what you need!
If you do not have enough information to complete an essay or dissertation, send us the basic guidelines and we will do the rest.