how i write
TRANSCRIPT
Thanks for coming this far!
I’m ok, you’re ok
There is nothing noble in being superior to your fellow man; true nobility is being superior to your former self.
- Ernest Hemingway
Contact meYou may have comments and questions by the end
Drop by my office, 1.38 in the CS building, for a chat (especially in weeks 2-5)
Office hours: Tuesdays 9.30-10.30 am; Wed 9.30-10.30 am
[email protected] to arrange a chat any other time.
ContentsAudience thoughts
Writing the Introduction, and rules concerning prose style
Interlude on the Fear of Writing & overcoming it
Writing the Abstract – a formula from Simon Peyton-Jones
Rhetorical devices
Other advice on Method, Results, Conclusion, and other writing hints all a bit crammed in!
Audience thoughts
The purpose of writing is to communicate your ideas to the largest possible audience
Comments:
• Write for you mum or a friend who is not a CS person
• Use few acronyms, avoid jargon
• Start with as general a beginning as you can muster!
Audience thoughts
Audience thoughtsYou might worry whether you will forget all the
audience who are CS experts, or patronise them. But don’t patronise anyone, including your Mum! Just write in
Classic Style[1], which means that you assume the reader is intelligent and interested, that the language is sufficient to communicate, that clarity of thought is the main authority you need, and that you should use words sparingly and in proportion to the importance of the ideas you want to convey.
Don’t write “filler” or tell all your background reading, thoughts, and plans! Add an example or figure if you must fill space.
References are at the end*Sorry for the Don’ts. There are a lot of Don’ts in writing well
Writing the IntroductionLet’s have a go:
I. IntroductionSearch is about searching for something.
Hmmm: General, but feels a bit tautological and trivial, doesn’t it?
Writing the IntroductionLet’s have a go:
I. IntroductionSearch is about finding something.
Better, but not much...
Writing the IntroductionLet’s have a go:
I. IntroductionSearch is about finding something efficiently from
within some well-defined set.
Now we are cooking: It looks like we have found a very general statement, and uncontroversial, but with just a smidgeon of detail to show we are rigorous, concerned with efficiency, and sane!
Writing the IntroductionLet’s have a go:
I. IntroductionSearch is about finding something efficiently from within
some well-defined set, for example a house for sale within 3 miles of the University of Birmingham.
Now we are cooking: Cooking even better, as we have now given an example to further add sophistication, but also clarify and make our uncontroversial idea concrete. eral state
Writing the IntroductionLet’s have a go:
I. IntroductionSearch is about finding something efficiently from within some well-
defined set, for example a house for sale within 3 miles of the University of Birmingham. No one in search can explain how some humans are so apparently efficient at it, however, for example how Mozart could just sit down and rattle off an opera of sublime quality.
Turning up the gas: Now we’ve added a controversial statement and one with some serious “balls”. Sentence two is all we’ve done, but we’ve already grabbed the attention of the reader, I reckon.
Perhaps we should worry about what comes next, but let’s not today....
The Fear of WritingOn the next slide, I am going to show you the
scariest thing some of you have ever seen. Are you ready?
Jonathan L. Shapiro (Manchester)
Credit* for this slide idea goes to:
*Always give credit where credit is due
Overcoming the fear1. Start
2. Then Push Through to the other side
3. Then plan, get organized, get comfortable, etc
4. Then improve your writing and keep improving it until you can improve it no more.
Let’s look at steps 1 and 2 from a professional ...
Overcoming the fear
Kristin Cashore, bravely showing us her “process” of getting a first draft going! This was from her novel, Bitterblue.
Overcoming the fear
More from Kristin Cahore
Overcoming the fear (next steps)
3. Plan, get organized, get comfortable, etc.
My comments:
Find out when you write best (what time of day)
Find out where you write best – be comfortable
What do you need on your writing desk?
Five minutes a day for a year = your first novel*
*And you don’t need to write a novel, just an 8-page paper!
Overcoming the fear (next steps)
4. Then improve your writing and keep improving it until you can improve it no more.
Writing the AbstractMore people will read the Abstract than any other
part of your paper*, therefore it is the most important part
Simon Peyton-Jones (Microsoft Research) gives a formula for writing it, which I always follow....
* Okay, arguably the Title might win, but then write a catchy title (of course).
Writing the AbstractUse four sentences (although you can double them up)
§1: State the problem§2: State the context, or why the problem is important
and unsolved§3: State your solution§4: State the conclusion of your work, i.e. how the world
beyond your paper has changed as a result of your work, or at least how it might change.
::The Simon Peyton-Jones method::
Writing the Abstract(an outstanding example)
Extraneous factors in judicial decisionsAbstract: Are judicial rulings based solely on laws and facts? Legal formalism
holds that judges apply legal reasons to the facts of a case in a rational, mechanical, and deliberative manner. In contrast, legal realists argue that the rational application of legal reasons does not sufficiently explain the decisions of judges and that psychological, political, and social factors influence judicial rulings. We test the common caricature of realism that justice is what the judge ate for breakfast in sequential parole decisions made by experienced judges. We record the judges two daily food breaks, which result in segmenting the deliberations of the day into three distinct decision sessions. We find that the percentage of favorable rulings drops gradually from 65% to nearly zero within each decision session and ∼returns abruptly to 65% after a break. Our findings suggest that judicial ∼rulings can be swayed by extraneous variables that should have no bearing on legal decisions.
Rhetorical devicesRhetoric is concerned with the art of persuasion in
writing or speech.
Classically, it is split into three main appeals (Aristotle):Ethos: the authority of the writerLogos: sound (logical) argument and evidencePathos: emotional content
There is debate whether scientists use rhetoric. Do they try to persuade, or do they write only to inform and present objective evidence?
Kuhn, Feyerabend and other philosophers have argued that science is social and subjective to at least some degree.
Rhetorical devicesEthos: The authority of the writer is best established
immediately by writing high-quality sentences in the Abstract and Introduction, as well as having famous co-authors!
Logos: Sound (logical) argument, and/or evidence is essential. Keep asking yourself whether your argument is sound ALL THE WAY THROUGH, or does it have some Swiss cheese moments?!
Pathos: Emotional content should be kept minimal, or kept well hidden. But little jokes, examples that the reader can relate to, or stuff about judges whose decisions are more lenient after lunch ALL help the reader enjoy your paper ;-)
Further advice: the Method section
Just don’t labour it.
It isn’t that important, as long as it is honest, replicable, and is basically logical and internally well-justified.
Further advice: the Results section
Just don’t labour it.
It isn’t that important, as long as it is honest, replicable, and is basically logical and internally well-justified.
You might need statistics! (see final lecture in this series)
Don’t put every result of every experiment there, for goodness sake. Be selective.
Further advice: the Conclusion section
Very important section
It is NOT only a summary
It is NOT only future work
It IS the place where you explain the consequences of your work (and the limits or weaknesses of it)
Further advice: writing rules
Write like Hemingway. This means use few adjectives, fewer adverbs, and with carefully chosen verbs.
Poor example:
The man ran quickly down the street and was very frightened at what he saw when he finally got there.
Good example:
The man ran down the street. Gasping, he could see the body as he approached. What he found would stay with him for the rest of his days.
Note: The latter is certainly rubbish compared to Hemingway but it is my simulation, and it is better than the first attempt, isn’t it?
Further advice: Great verbs for science writing
Suggest
Propose
Indicate
Test (e.g., a hypothesis)
Refute
Provide
See
Simplify
Clarify
Bolster (an argument or pos’n)
Survey
Consider
Investigate
Meet (an argument)
Firm up
Underpin
Describe
Rehearse (an argument)
Further advice: Great verbs for science writing
Underline
Emphasise
Reorganize
Speculate
Review
Satisfy
Conclude
Put forward
Further advice: adverbsThe road to hell is paved with adverbs.
- Stephen King
Further advice: from Bertrand Russell
Bertrand Russell's example of editing to achieve brevity and force:
“ “Human beings are completely exempt from undesirable behaviour-patterns only when certain prerequisites, not satisfied except in a small percentage of actual cases, have, through some fortuitous concourse of favourable circumstances, whether congenital or environmental, chanced to combine in producing an individual in whom many factors deviate from the norm in a socially advantageous manner''.
Let us see if we can translate this sentence into English. I suggest the following:
“All men are scoundrels, or at any rate almost all. The men who are not must have had unusual luck, both in their birth and in their upbringing."
This is shorter and more intelligible, and says just the same thing.”
(from How I Write, B. Russell)
Further advice: from Russell and Hemingway
Start sentences, and paragraphs even, with “And” and “But”. Ignore stupid rules that say you can’t.
Never write a sentence where the beginning of the sentence leads the reader into an expectation that is contradicted by the end of the sentence. You are leading the reader on a path (don’t ambush them!).
Hemingway famously uses sentences with lots of “and” connecting words, not “however” or “nevertheless” or other horrible words!
Final Further AdviceSleep
Walk
Let your thoughts have space; go outside
Breathe properly, eat properly
Be patient with yourself
Enjoy your reading, and all your leisure time
Wear comfortable shoes
Don’t do boring “pastime” time-wasting activities like surfing the internet or reading too much news half-interestedly
Good Luck!Contact me for questions
If you liked this, you may also like
www.cs.bham.ac.uk/~jdk/aphorisms.html
References (to be completed)
[1] Francis-Noël Thomas & Mark Turner, “Clear and Simple as the Truth: Writing Classic Prose”...
[2] Ernest Hemingway, “The sun also rises”...
[3] William Shakespeare, “Henry V”...
[4] Simon Peyton-Jones, “How to write a great research paper”...
[5] Bertrand Russell, “How I write”.