Mantex

Tutorials, Study Guides & More

  • HOME
  • REVIEWS
  • TUTORIALS
  • HOW-TO
  • CONTACT
>> Home / Archives for Writing skills

Instruction terms in essay questions

August 23, 2009 by Roy Johnson

sample from HTML program and PDF book

1. Instruction terms are words commonly used in essay questions. They instruct or direct you in the approach you should take towards the proposition of the question.

2. The exact meaning of these terms will vary depending upon the subject being studied. The following give some idea of what they normally mean for essays and examination questions.

3. Think carefully about the meaning of these terms in relation to the remainder of the question. Even though you might feel confident, do not become blasé or inattentive. Sometimes even experienced students forget the important difference between Compare and Contrast.

4. Try to understand exactly what an instruction is asking you to do – but be reasonable. Don’t look for problems where they might not exist. If in doubt, ask your tutor.


GLOSSARY

account for
Explain the reasons for, giving an indication of all relevant circumstances. Not to be confused with ‘Give an account of’ which asks only for a detailed description.

analyse
Study in depth, identifying and describing in detail the main characteristics.

argue
Put forward a proposition, then illustrate it, discuss its significance, and defend it against possible counter-charges.

assess
Examine closely, with a view to ‘weighing up’ a particular situation. Consider in a balanced way the strengths and weaknesses or points for and against a proposition. In conclusion, state your judgement clearly.

comment
State clearly and in moderate fashion your opinions on the material in question. Support your views with reference to suitable evidence or explanations.

compare
Look for similarities and differences between two or more things.

contrast
Deliberately single out and emphasise the differences and dissimilarities between two or more things.

criticise
Give your judgement about a statement or a body of work; explore its implications, discussing all the evidence which is available. Be specific in your examination.

define
Set down the precise meaning of something. Be prepared to state the limits of the definition. Take note of multiple meanings if they exist.

describe
Give a detailed and comprehensive account of something.

discuss
Investigate and examine by careful argument. Explore the implications and the advantages or disadvantages. Debate the case and possibly consider any alternatives. This is probably the most common instruction term. It is inviting you to say something interesting in response to the topic in question. You can choose your own approach.

evaluate
Make an appraisal of the worth of something in the light of its truth or utility. Emphasise the views of authorities as well as your personal estimation.

explain
Make plain. Account for. Clarify, interpret, and spell out the material you present, giving reasons for important features or developments.

how far …
Similar to questions which begin ‘To what extent…‘. You are expected to make your case or present your argument, whilst showing an awareness that alternate or even contradictory explanations may exist. Careful assessment and weighing of evidence are called for.

identify
Pick out what you regard as the key features of something, perhaps making clear the criteria you use in doing so.

illustrate
Make clear and explicit by the discussion of concrete examples.

justify
Show adequate grounds for decisions or conclusions. Answer or refute the main objections likely to be made against them.

outline
Give the main features or the general principles of a subject, omitting minor details and emphasising structure or arrangement.

relate
Show how things are connected, and how they possibly affect, cause, or resemble each other.

review
Make a survey of, examining the subject critically.

state
Present the main points in brief, clear form.

summarise
Give a concise account of the main points of a matter, omitting details and examples.

to what extent … Similar to questions which begin ‘How far …‘. This term is used in questions asking you to show your own judgement. It’s unlikely that there will be a black or white answer. You are expected to argue your case, offering evidence to support your view(s). It also gives you the opportunity to discuss both weaknesses and strengths for a case.

trace
Follow the development or history of a topic from some point of origin.

© Roy Johnson 2003

Buy Writing Essays — eBook in PDF format
Buy Writing Essays 3.0 — eBook in HTML format


More on writing essays
More on How-To
More on writing skills


Filed Under: Writing Essays Tagged With: Academic writing, Essays, Instruction terms, Reports, Study skills, Term papers, Writing skills

Internet Writer’s Guide

June 15, 2009 by Roy Johnson

advice  plus extensive online resources for authors

How can the Internet help authors today? Isn’t writing still just a matter of putting pen to paper? There are so many new developments in electronic publishing, free web space, media mergers, and online bookshops: won’t these take our attention away from being creative? Well yes, they might. But they also open up exciting new possibilities. That’s why Jane Dorner has written The Internet: A Writer’s Guide – as a road map through the maze.

Internet Writer's GuideShe starts from the most logical point – how to get connected, what equipment you need, and how to operate the essentials. In the discussion of email she begins to consider the special needs of writers – how to send attachments; how to submit work to publishers; even how to conduct email interviews.

On the Web, she explains the techniques of efficient searching, how sites are used for publishing, and what to do when it all goes wrong.

She touches on writing groups which exist in the form of mailing lists, websites, newsletters, chat groups, and conferences. The strength of this approach is that given a little trial and error, most writers will be able to locate the sort of forum which suits them best.

There’s an interesting chapter on electronic publishing and what are now becoming known as e-book readers. This is very timely, as the market potential for this type of distribution has just opened up again with the success of products such as the 3″ X 5″ PalmPilot – the latest version of which can download Web pages and e-books off the Net, but still fit in your shirt pocket.

She then explores both the new opportunities for writers created by the Internet and the practicalities of publishing on your own web site. I was glad to see that she didn’t waste too much time with coding and page layout, all of which can be picked up easily elsewhere. She concentrates instead on issues of copyright, payments, encryption, plagiarism, and censorship. These topics will be far more live issues for the majority of writers tempted by the possibilities of online publication.

But by far the best part of the book – the ‘killer app’ so far as most writers will be concerned – is the final chapter listing online resources. She gives annotated lists of all the sources a writer could possibly wish for – from libraries to bookshops, dictionaries to writing circles, newspapers to writing style guides, electronic publishers to free Internet service providers. Just working your way through the list with your browser open would be an education in itself. The list has been enlarged for the second edition – and made available at the book’s website.

What I like about this guide is that it combines a lightness of touch with a thoroughness of approach. It gets straight to the point, uses a minimum of technical jargon, and covers a wide range of topics pertinent to aspiring authors. If you are a writer, and you’re ready to explore a rich source of suggestions for what to do next with the Net, then buy this book. You will not regret it.

© Roy Johnson 2002

The Internet: A Writer's Guide   Buy the book at Amazon UK

The Internet: A Writer's Guide   Buy the book at Amazon US


Jane Dorner, The Internet : A Writer’s Guide, London: A & C Black, second edition 2001, pp.200, ISBN: 0713661267


More on creative writing
More on writing skills
More on publishing


Filed Under: Creative Writing, Writing Skills, Writing Skills Tagged With: Creative writing, Electronic Writing, Internet, Web writing, Writing Guide, Writing skills

Introductions in essays

August 23, 2009 by Roy Johnson

sample from HTML program and PDF book

1. The introductions to essays should address directly the question or topic(s) you have been asked to discuss. Introductions which are clear and direct usually signal the start of essays which will be addressing the relevant issues.

2. You should aim for a bright and crisp opening statement which will be interesting and seize the reader’s attention. The statement should also be directly relevant to the question topic.

3. Do not merely restate the question, and try to avoid repeating the same terms in which it is posed. You may however wish to translate the question into your own words, paraphrasing it as a demonstration that you understand what it calls for.

4. Unless the question specifically calls for it, avoid long-winded ‘definitions’ in which the key terms of the question are explored for all their possible meanings. Your understanding of what the question means should usually be clear from your introductory remarks.

5. The introduction should not normally occupy more than five to ten percent of the total length of the essay. Two hundred words on the first page should normally be enough. More than this might be taking too long to get to the point.

6. If in doubt, go straight to your answer. Some tutors argue that having no introduction at all is better than producing one which is rambling, cloudy, or vague. If all your arguments are directly relevant to the question, your approach to the question will quickly become apparent.

7. Even if you think the question is especially difficult or that it embraces complex issues, you should avoid saying so as part of the introduction. This can create the impression that you are making excuses in advance of your answer.

8. Questions are set to pose problems: your task is to answer them. You might however wish to name or outline any difficulties – so long as you go on to tackle them.

9. Some people use an appropriate quotation as a means of starting the introduction. (This strategy can also be used to round off conclusions).

10. If you use this approach, you should follow the quotation with some interesting observations of your own. Do not give the impression that you are using somebody else’s work as a substitute for your own.

11. The following offers an introductory paragraph in response to a first year undergraduate philosophy question: ‘Are there universals?’

Plato was the first philosopher to deal comprehensively with the concept of universals, and he did so in such a compelling manner that his ideas still have an influential force today. His general method is to set himself questions (through the mouthpiece of Socrates). He begins The Republic by asking ‘What is Justice?’ and goes on in pursuing this question to ask ‘What is the Good?’. This method, it will be seen, somewhat predetermines the nature of his answers.

12. Many people find introductions difficult to write, particularly if this is the first part of the essay assignment they attempt. Don’t feel surprised by this. The reason is likely to be that –

  • You are not sure what you are going to say
  • You may not be sure what it is you are introducing
  • You can’t summarise an argument which doesn’t yet exist

13. The solution to this problem may be to leave the introduction until the essay has been finished – in its first draft. It will be much easier to compose introductory remarks after the first attempt has been produced. You will then have a grasp of your overall argument and maybe some idea of its structure.

14. In some subjects [principally the sciences] you might be required to declare in an introduction the approach your essay will take. You might even give some account of the structure or the sequence of information. If this is the case, the composition of an introduction should create no problems.

© Roy Johnson 2003

Buy Writing Essays — eBook in PDF format
Buy Writing Essays 3.0 — eBook in HTML format


More on writing essays
More on How-To
More on writing skills


Filed Under: Writing Essays Tagged With: Academic writing, Essays, Introductions, Reports, Study skills, Term papers, Writing skills

Jargon in essays

August 23, 2009 by Roy Johnson

sample from HTML program and PDF book

1. Jargon is ‘the technical language of a profession or group’. The implication of this definition is that their language may not be understood by people outside the group.

2. For example, when solicitors use terms such as ‘probate’, ‘conveyance’, and ‘leasehold’, they are using the jargon of their profession, which is usually only understood by other solicitors. Similar examples could be given for doctors, engineers, and even bookbinders.

3. There is nothing wrong when jargon is used amongst members of the same group. It often functions as shorthand, which eliminates the need for lengthy explanations. However, when you are communicating with people outside a group, its use should be minimised.

4. The term jargon in its most negative sense describes the use of technical or obscure terms when addressing a general audience. For instance, a letter from the Inland Revenue to an ordinary member of the public which contains the following sentence is an example of bad manners (and poor communication):

The basis of assessment for Schedule D Case I and II, other than commencement and cessation, is what is termed a previous year basis.

Some steps have been taken to eliminate this occurrence in public documents, but there is still a long way to go.

5. Academic discussion can have its own jargon too, depending upon the subject in question. Terms such as ‘hegemony’ (political philosophy) ‘discourse analysis’ (linguistics) and ‘objective correlative’ (literary studies) would not be recognisable by an everyday reader, though they might be understood by someone studying the same subject.

6. Whatever the jargon of your own discipline, it should be used with precision, accuracy, and above all restraint. Only use the specialised terms of your subject if you are quite sure of their meaning.

7. Never use jargon to show off or ‘impress’ your reader. It is likely to create the opposite effect. Similarly, do not take half-understood jargon from one discipline and import it into another.

8. Take the trouble to learn the meanings of these specialised terms within the context of your subject. A word might have a particular meaning when used within a subject discipline which it does not have in general usage.

9. Do not use a jargon term where perfectly ordinary terms will be just as effective. There is not much virtue in using terms such as ‘aerated beverages’ instead of ‘fizzy drinks’. These simply cause disruptions in tone and create a weak style.

10. Here is an even more pretentious example, spotted recently.

‘Moisturising cleansing bar’ [in other words – ‘soap’]

© Roy Johnson 2003

Buy Writing Essays — eBook in PDF format
Buy Writing Essays 3.0 — eBook in HTML format


More on writing essays
More on How-To
More on writing skills


Filed Under: Writing Essays Tagged With: Academic writing, Essays, Jargon, Language, Reports, Study skills, Term papers, Writing skills

Journalism – A Short Introduction

June 26, 2009 by Roy Johnson

Reporting for press, broadcast media, and the Net

Ian Hargreaves has worked in newspaper journalism, magazines, television and radio. He was director of news and current affairs at the BBC, deputy editor of the Financial Times, and editor of the Independent and the New Statesman. This breadth and depth of experience gives him a very well informed overview of contemporary journalism in print and broadcast forms.

Journalism - A Short IntroductionHe starts by sketching in a brief history of free speech and the press – Milton, Thomas Paine, J.S. Mill – then argues that newspapers had only just finished establishing themselves as the prime vehicles for circulating news in the early years of the last century when they were immediately challenged by new technological inventions. First the radio, then television, and most recently the Internet. This is an exposition conducted at a fairly high socio-political level.

He compares recent journalism in Russia and the USA for instance – both cases where freedom of expression is being compromised, even if for very different reasons. One possible solution he sees is a return to what he calls ‘civic journalism’ – of the kind discussed by Dan Gillmor in his recent book We the Media. Digital communication in the form of email, bulletin boards, blogs, RSS feeds, and web sites puts the power of communication and free speech back into the hands of individuals. We no longer need to own printing presses to circulate information.

He is certainly smack up to date – tracking the politicking and manoeuvring that goes on between governments, regulatory bodies, and media tycoons such as Rupert Murdoch, Ted Turner and their like. He also includes the Hutton report in the context of reporting during a war, which always puts ‘standards’ and the ethics of truth-telling to a severe test.

There’s an interesting chapter on tabloid journalism in which he easily exposes the excesses of The Sun and The National Enquirer – but he also argues that the concentration on ‘celebrity’ has had an injurious knock-on effect on serious media.

There’s also a chapter on press ownership where he argues that despite the Murdochs, Blacks, and Maxwells, the real power in press ownership is passing into the hands of business conglomerates. This is likely to be depressing news for those who believe in a ‘free press’. He also offers some gritty examples from his first hand experience of the relations between owners, editors, and journalists.

There’s a historical view of public relations and spin-doctoring which is more interesting than you might think – though the overall impression it gave me was that all journalists ought to keep in mind the mantra of Harold Evans who suggested that all journalists interviewing politicians ought to ask themselves “Why is this bastard lying to me?” He also includes an interesting chapter on the ethics of journalism – with a healthy critique of the toothless UK Press Complaints Committee.

He ends, logically enough, with the influence of the Internet, which has spawned all sorts of challenges to conventional media. He uses the example of Matt Drudge’s exposure of the Clinton-Lewinsky scandal as a touchstone case, reminding us that Drudge was just an individual citizen, not a paid journalist. Digital information technology is changing so quickly, it’s difficult to know what will last or what will happen next – but he outlines all the important issues.

I found this a much more interesting and stimulating book than its modest title led me to expect. If you want to know what’s happening in journalism right now, it will bring you right up to date.

© Roy Johnson 2005

Journaalism   Buy the book at Amazon UK

Journalism   Buy the book at Amazon US


Ian Hargreaves, Journalism: a very short introduction, Oxford: Oxford University Press, 2005, ISBN: 0192806564


More on journalism
More on creative writing
More on writing skills
More on publishing



Filed Under: Journalism Tagged With: Journalism, Journalism - A Short Introduction, Media, Publication, Writing skills

Key terms in essay questions

August 23, 2009 by Roy Johnson

sample from HTML program and PDF book

1. Key terms are those parts of a question which either state or reveal its subject.

2. Key terms should be distinguished from instruction terms, which tell you how to approach the question, and how to deal with the subject.

Question
‘Discuss the significance of railways in the Industrial Revolution’

3. Both the terms ‘railways’ and ‘Industrial Revolution’ are key terms here. These are the subject of the question. You are being asked to concentrate on one topic (‘railways’) in relation to a specified historical period (‘the Industrial Revolution’).

4. The term ‘discuss’ on the other hand is an instruction term. This tells you how to approach the question.

5. Don’t expect key terms to jump off the page at you – or to be
unproblematic. Sometimes you will need to think carefully about the possible implications of the subject. They might also be expressed in very ordinary language.

Question
‘To what extent was Clement Atlee a successful politician?’

6. It is the term ‘To what extent’ which acts as an instruction: you are free to construct your own response. The key term is ‘successful politician’, which isn’t as obvious as it might first appear. Does ‘successful’ mean winning general elections, or being the author of policies which are adopted? You would need to give careful thought to these issues.

6. In order to make these distinctions (particularly when they are not obvious) you should be prepared to analyse questions very carefully.

© Roy Johnson 2003

Buy Writing Essays — eBook in PDF format
Buy Writing Essays 3.0 — eBook in HTML format


More on writing essays
More on How-To
More on writing skills


Filed Under: Writing Essays Tagged With: Academic writing, Essays, Key terms, Reports, Study skills, Term papers, Writing skills

Line references in essays

August 24, 2009 by Roy Johnson

sample from HTML program and PDF book

1. Some texts – such as long poems, plays, works of philosophy, or the Bible – require line references. You should identify the source of your first quotation with a numbered endnote. Then add a line number, thus:

NOTES
1. Tony Harrison, Selected Poems, Penguin, 1984, p.181, l.26.

2. If all your subsequent references will be to this text, you may
add a brief note:

All subsequent line and page references are to this edition.

Following this first full reference, you may afterwards give only a line number after the quotation in your text.

3. There is no need to give line references when quoting from a short text (say, up to twenty lines). Just give the source as an endnote to your first quotation.

4. When giving references to quotations from texts such as plays, the convention is to give the information in the sequence as follows:

Act – Scene – Line number

Act II,   Sc iv,   l.129

5. Notice that the act number is usually given as a Roman numeral in capitals (II), the scene number in lower case (iv), and the line reference in Arabic numerals (129). This type of notation is normally abbreviated to II.iv.129

6. Remember that you should produce your own argument first, and then add supporting quotations afterwards. Unless the essay question asks you to do so, you should not normally quote first and then offer a commentary on the extract.

© Roy Johnson 2003

Buy Writing Essays — eBook in PDF format
Buy Writing Essays 3.0 — eBook in HTML format


More on writing essays
More on How-To
More on writing skills


Filed Under: Writing Essays Tagged With: Academic writing, Essays, Line references, Reports, Study skills, Term papers, Writing skills

Managing Information for Research

July 13, 2009 by Roy Johnson

practical strategies for data management and research

Most people feel challenged when faced with the prospect of a research project. And why not? After all, it’s not something we do every day. The biggest problem (usually) is knowing how to cope with both the shape and the volume of information. Elizabeth Orna’s advice in Managing Information for Research is that we should concentrate on managing the process of research. She deals with the essential questions which are asked by anybody undertaking a project. What am I looking for? Why am I looking for it? How shall I set about the task? Where shall I start looking? And she answers these questions by showing practical examples and demonstrating how to both define and limit the task. Her evidence is drawn from a long and distinguished career, working in education and government.

Managing Information for ResearchWhat she is offering here are “ways of thinking about information, and practical techniques of applying the thinking that are characteristic of the disciplines known variously as ‘information science’, ‘librarianship’, ‘information management’, or ‘information studies’.” This is not how to grub around for your data, but what to do with it when you’ve got it.

She discusses for instance the simple practicalities of organising information – on cards; on A4 pages; and in indexes. [This section is crying out for extended hypertext consideration in the next edition.] She also gives an excellent example (culled from a negative experience on an MA course) of why it is important to keep a full documentary record of a research project – complete with a list of the documents required to do it. This is first-rate advice, generated from first-hand educational experience.

There’s also a section on time management, complete with guidance on estimating how long it will take to complete tasks – and what to do when you can’t realistically meet your deadlines. The purpose and readership of a project should be kept in mind so that it’s designed to meet the requirements of an intended audience – and there’s a useful checklist of questions you can apply to any work you produce.

She covers a number of possible ways of presenting your results – which leads into a consideration of what is now called ‘information architecture’. That is, thinking clearly about the way in which data is displayed in order to be useful, easily understood, and effective. This points towards the sort of work being done by Edward Tufte and the University of Reading, both of which sources I was glad to see listed in the excellent bibliographies of further reading which follow each chapter.

The latter parts of the book deal with the importance of effective page layout and good typographical design in the presentation of data. Graham Stevens points readers towards that most important feature in the principles of good design – over-riding the default settings of your word-processor. He covers the details of font choice, line length, margins, grids, word spacing, heading hierarchies, and close editing in its relation to the effective visual display of information.

The publishers have had the good sense to let him completely re-design this hugely enlarged second edition of the book. The result is tremendous improvement on the first. It’s now a production which follows the very same principles it lays down for the efficient presentation of information. It’s also an excellent piece of work which will help anyone who is prepared to learn about the most effective manner of organising and presenting information.

© Roy Johnson 2009

Information for Research   Buy the book at Amazon UK

Information for Research   Buy the book at Amazon US


Elizabeth Orna with Graham Stevens, Managing Information for Research, Buckinghamshire: Open University Press, second edition 2009, pp.271, ISBN: 0335221424


More on information design
More on design
More on media
More on study skills
More on writing skills


Filed Under: Information Design, Study skills Tagged With: Data management, Information design, Managing information, Managing Information for Research, Research, Writing skills

MHRA Style Guide

July 9, 2009 by Roy Johnson

pocket academic writing style guide for humanities

The key to this style guide is in its subtitle: ‘Notes for Authors, Editors, and Writers of Theses’. It has been produced by the Modern Humanities Research Association as a manual of advice and procedures for people preparing texts for publication. The MHRA Style Guide assembles a set of conventions to help users through the minutiae of the scholarly editing and presentation of texts.

MHRA Style Guide If you are a student, a researcher, or a writer, the net result is a brief and very usable guide. One of its principal advantages over other guides is its brevity: it only includes the essentials, and everything is easy to find. And yet it covers everything you would normally require for academic writing or formal publication – from spelling, abbreviations, and punctuation through to the thorny issue of bibliographic referencing, which is what often drives students into fits of nail-biting frenzy.

It’s all very succinct, and yet manages to pack in the presentation of foreign languages, citations from articles, journals, and newspapers, and even a nod towards the Author-Date (or Harvard) system of referencing.

The latest edition has been expanded to cover preparing texts for electronic publication and there are sections on indexing and writing a thesis or a dissertation. There’s a glossary, sections on book reviews and correcting proofs, and a good index.

I first came across this book when it was chosen by the Open University as a set text for some of its postgraduate courses. Getting students to follow the conventions is still hard work, but it’s a lot easier than it used to be.

What I like most about the book is that it gives you the impression that you’re just about to publish an important piece of work. Since it’s also amazingly cheap, it’s worth buying as a confidence-booster alone.

© Roy Johnson 2008

MHRA Style Guide   Buy the book at Amazon UK

MHRA Style Guide   Buy the book at Amazon US


MHRA Style Guide: Notes for Authors, Editors, and Writers of Theses, London: Modern Humanities Research Association, new second edition 2008, pp.95, ISBN: 0947623620


More on writing skills
More on language
More on grammar


Filed Under: Study skills, Writing Skills Tagged With: MHRA Style Guide, Reference, Writing guides, Writing skills

Microsoft Manual of Style

February 1, 2012 by Roy Johnson

guidelines for clear technical writing

Microsoft Manual of Style was produced in-house at Microsoft as the style guide for its army of writers who produce the help files and documentation for its products. Except that it’s been re-written for the public, and it’s completely non-prescriptive. They don’t say “This is the way it should be done”. They say “Here’s how we do it at Microsoft. You may find this approach useful”. It starts with a chapter describing the principles on which its house style is built – and these could profitably be adopted by any other organisation or business. Or any individual for that matter.

Microsoft Manual of Style They are not at all particular to Microsoft, but aimed at producing seamlessly efficient communication. The principles include consistency of language, an empathetic attitude towards readers, precision, plain language, simplicity of sentence construction, a nod towards avoiding gender bias, and maintaining grammatical parallelism (which is very useful if you are writing instructions).

These issues are all illustrated by good and bad examples that show clearly the distinction to be made between for instance two apparently identical instructions::

Use this procedure to make any changes to your password.

Follow these steps to change your password.

The second has seven words instead of ten, less fuzz, and more clarity.

There’s a separate section on writing efficiently for the web. You should use the power of headings, sub-headings, bulleted lists, and well-chosen hyperlinks to maximise readability. There’s a specially valuable tip here. In each paragraph, put the conclusion first (what’s called the ‘inverted pyramid’ style) so that readers know if they wish to read on. People scan web pages rather than read them.

It’s not all about instructions and programs. The guidance assumes you might be using videos, blogs, and community-provided content such as wikis. It also keeps in mind that you might be writing for an international audience – but it points out that the guidelines for accommodating this are the same as for writing clearly and persuasively for English-speaking readers anyway. The maximum length of sentences should be twenty-five words.

For those people who will be writing about technology there’s a whole chapter on user interfaces – screens, menus, dialogue boxes, and toolbars – and how to write instructions that are clear and unambiguous. This is bang up to date, because to interact with contemporary devices you now need to include gesture (pich, swipe, zoom) as well as input via speech instructions and keyboard shortcuts.

More technical advice follows – on writing procedures (how to navigate through folders) how to describe cloud computing accurately, how to show code in support documentation, and fine details such as how to use filename extensions and when to use capitalization and bold.

There’s quite a lot on how to display numbers and when to use words (seven databases but a 24-hour day) how to show dates (February 12, 2012 – which is very non-standard) plus how to write captions and compile bibliographies.

On grammar and punctuation they understandably go for simplicity, clarity, and brevity. All the basic common sense rules are illustrated – but are then followed by some not-so-obvious but fascinating illustrations of indexing and list-ordering, including the order in which numerical entries will be listed. For instance 12-hour clock comes before 2-D charts.

There’s a huge list of acronyms with advice on when and when not to spell them out, and then the last half of the book is an alphabetical list of technical terms and commonly used words and phrases with illustrated explanations of good styling. They range from am/pm, through less and fewer, to ZIP codes and how to spell the plural of zero.

There are two indexes – one at the front and another at the back of the book – so it’s easy to find any detail you need to check. The latest fourth edition does its best to keep up to date with the ever expanding language of technology – app, cloud, and sync as well as terabyte (TB), petabyte (PB), and on up to yottabyte (YB). And it’s interesting to note that E-mail and Web site have now become email and website as these terms have now become part of everyday language.

Microsoft Manual of Style   Buy the book at Amazon UK

Microsoft Manual of Style   Buy the book at Amazon US

&copy Roy Johnson 2012


Microsoft Corporation, Microsoft Manual of Style, Microsoft Press: Redmond (WA), fourth edition, 2012, pp.438, ISBN: 0735648719


Style guide links

Red button Writing guides compared

Red button Writing skills – an annotated bibliography

Red button Editing and Revising Text


More on journalism
More on creative writing
More on writing skills
More on publishing


Filed Under: Journalism, Language use, Publishing, Writing Skills, Writing Skills Tagged With: Business documentation, Style guides, Technology, Writing Guide, Writing skills

  • « Previous Page
  • 1
  • …
  • 11
  • 12
  • 13
  • 14
  • 15
  • …
  • 26
  • Next Page »

Get in touch

info@mantex.co.uk

Content © Mantex 2016
  • About Us
  • Advertising
  • Clients
  • Contact
  • FAQ
  • Links
  • Services
  • Reviews
  • Sitemap
  • T & C’s
  • Testimonials
  • Privacy

Copyright © 2025 · Mantex

Copyright © 2025 · News Pro Theme on Genesis Framework · WordPress · Log in