BUGS in Writing, Revised Edition: A Guide to Debugging Your Prose (2nd Edition) [Paperback]

Lyn Dupre (Author)

Book Description

ISBN-10: 020137921X | ISBN-13: 978-0201379211 | Publication Date: February 19, 1998 | Edition: 2

BUGS in Writing, written with verve and wit, may be the first book on writing that people read for sheer fun. Designed for easy browsing, it comprises 150 independent and easily digestible segments. BUGS was developed for anyone who writes and who works with computers, including computer and other scientists, students, professors, business people, programmers, and technical writers.

Editorial Reviews

From Library Journal

Dupre's clear advice, presented with a sense of fun, may benefit anyone who writes. However, it is geared to technical and academic writers who usually understand their material but are not so skilled at passing along that understanding. Many of her examples show ways to use computer terminology wisely, but this is more, and better, than the much-touted Wired Style (LJ 10/1/96), offering not just definitions but broad advice. This would be a great supplementary text for any course in technical writing. For all academic collections.
Copyright 1998 Reed Business Information, Inc.

From the Publisher

BUGS in Writing, may be the first book on writing that people read for sheer fun. Developed for anyone who writes and who works with computers, including computer and other scientists, students, professors, business people, programmers and technical writers. Rather than subjecting yourself to the pain and tedium of wading through a reference book on English grammar, pick up BUGS; you will soon find yourself browsing amusing and interesting material. While you are enjoying yourself, you will be tuning your ear: You will soon find that you are writing lucid prose that communicates your ideas. "If technical writing isn't your principal activity, but you find yourself doing a lot of it, you should read this book."- IEEE Micro "The Quality of scientific and technical writing would increase considerably if this book were required reading for all authors."- The Mathematica Journal "You can borrow my dictionary or steal my thesaurus. Just stay away from my copy of BUGS."- Patrick Henry Winston, MIT "This book will help me/you/we a lot/immensely."- Martin Griss, Laboratory Scientist, Hewlett Packard Laboratories

See all Editorial Reviews

Product Details

• Paperback: 704 pages
• Publisher: Addison-Wesley Professional; 2 edition (February 19, 1998)
• Language: English
• ISBN-10: 020137921X
• ISBN-13: 978-0201379211
• Product Dimensions: 9.1 x 7.3 x 1.3 inches
• Shipping Weight: 2.3 pounds (View shipping rates and policies)
• Average Customer Review: 3.8 out of 5 stars  See all reviews (20 customer reviews)
• Amazon Best Sellers Rank: #335,667 in Books (See Top 100 in Books)

More About the Author

Discover books, learn about writers, read author blogs, and more.

Customer Reviews

Most Helpful Customer Reviews

97 of 115 people found the following review helpful:

1.0 out of 5 stars Buy a better book, January 10, 2003

By 

Barbara Nostrand "Barbara Nostrand" (Syracuse, NY USA) - See all my reviews
(REAL NAME)   

This review is from: BUGS in Writing, Revised Edition: A Guide to Debugging Your Prose (2nd Edition) (Paperback)

This is an annoying book. The author of this book claims that she wrote it for "computer people" whom she goes on to define as just about anyone who has visited the computer aisle in a bookstore. I was briefly employed as a technical writer while in graduate school and have found writing a constant part of technical employment in industry. I am currently a computer science professor who firmly believes that students need to learn how to write. Consequently, I incorporate writing into many of my courses. However, I can not recommend BUGS in Writing by Lyn Dupre.

Although the author cites the Manual of Style published by the University of Chicago Press, she failed to take to heart a number of its recommendations. In particular, her use of footnotes is excessive and often distracting. The overall design of the book appears very self-indulgent with its copious use of personal photographs unrelated to the text. The author is committed to "gender free" text to the point of altering the accepted names for famous computer science problems such as the Traveling Salesman Problem to suit her personal agenda and insists that others do likewise. She allows other petty issues to spoil her work. For example, she writes: "A dissertation is a document that you write as part of the fulfillment of requirements for a degree¡Ä A thesis is an assertion that you have presumably validated or proved ¡Ä" This is contrary to accepted practice at many and probably most academic institutions. While Martin Luther may have nailed his 95 thesis to a church door, some schools call even the paper presented for a doctorate a "thesis" while others reserve the term for a work presented for a master¡Çs degree. Current practice is to begin scholarly works with an "abstract" and not a "thesis".

Another of Dupres personal crusades is expressed in a foray against "split infinitives". She writes as if split infinitives are a recent abberation. In The Elements of Style, Strunk and White note that: "There is precedent from the fourteenth century down for interposing an adverb between to and the infinitive it governs." They also note that the "split infinitive" has a role when the author wishes to stress the adverb as in "To boldly go where no man has gone before." Strunk and White go on to note: "Some infinitives seem to improve on being split." Dupres¡Ç partisanship in the slit infinitive "wars" is much less disturbing than her one-sided account of the split infinitive.

Her diatribe against use of "data" as a singular in computer science is also excessive. Data is the plural of datum in Latin. The problem with treating data as a plural taking "are" in computer science is the distinction in English between enumerable and non-enumerable nouns. While there are uses of the word data where it is clearly plural, this is not the case in much of computer science literature where it is used in a non-enumerable sense. In English, the tradition is to treat non-enumerable nouns as singular. An odd recent development is pluralization of "email" as "emails" while "mail" continues to be treated as non- enumerable. Finally, data is often used as an adjective in computer science. English traditionally uses singular nouns for this purpose such as "horse barn" or "cow pasture" in preference to "horses barn" or "cattle pasture". Similarly, a famous English university is commonly called Oxford and not Oxenford. Insisting upon treating data as a plural would have much more serious consequences than portrayed by Dupres and other opponents of data as a non-enumerable. Under her system, we would properly write of "datum structures" rather than "data structures". In short, English majors should not meddle with semantics of individual words until they learn the field of discourse employing those words.

Although the author claims to have written a book for "computer people" she seems to be unaware of typesetting using LaTeX or the electronic style sheets provided by technical publishers. She also appears ignorant of coupling typesetting equations with output produced by either Maple or Mathematica. Although her book does contain a brief section on theorems and similar material, this section is too short and lacks sufficient detail to aid the reader. Despite her attention to typography, she does not make a clear recommendation on how to emphasize technical words in a work with lots of italicized text.

Some of the author's advice is well taken. She justly condemns use of passive voice in scientific writing. Her insistence on maintaining noun constancy is also well worth reading. Problems with noun consistency is exacerbated if you anticipate translation into Japanese where variation in nouns is less tolerated than it is in English. Unfortunately, even some of her good advice betrays a lack of understanding of computer science. While Dupre correctly argues for using monospace fonts for typesetting code, she appears ignorant of the reasons for preferring this convention. In one piece of advice she uses writing about stacks and queues as an example, but in her example labeled "good" she delivers confused prose which betrays ignorance of the subject. This spoils an otherwise good section.

In a world with many excellent books about writing, I can not recommend buying Dupre's book. If you are specifically interested in writing for computer science, then you should buy and read a copy of Writing for Computer Science by Justin Zobel. If you wish to write mathematics, you should buy and read a copy of How to Write Mathematics by Steenrod. The Art of Readable Writing by Rudolf Flesch continues to deliver excellent advice on writing in a much more compact package than Bugs in Writing. I also recommend Manual of Style by the University of Chicago Press, The Elements of Style by Strunk and White, and A Handlist of Rhetorical Terms by Lanham. As for BUGS in Writing, I can only speculate that Ms. Dupre made the error of editing her own book.

13 of 15 people found the following review helpful:

2.0 out of 5 stars Not good for reference, or for non-cat people, February 3, 2003

By 

J. M. Swisher "technical writer" (Austin, TX USA) - See all my reviews
(REAL NAME)   

Amazon Verified Purchase

This review is from: BUGS in Writing, Revised Edition: A Guide to Debugging Your Prose (2nd Edition) (Paperback)

As a technical writer, I am on the lookout for books I can recommend to engineers and others with whom I work who want to improve their writing. This book's explicit orientation toward "computer people" and the concept of "debugging" prose make it seem like a good candidate. However, the author's self-indulgence in cuteness in this book renders it inappropriate for me to recommend in a professional context.

If you don't mind all the cat pictures and personal references, it is a good book to browse for tips on improving your writing. Dupre states that her goal is to help the reader develop an "ear" for good writing. As you develop an ear, you will gain a sense of which of her rules to take to heart, and which to take with a grain of salt. It is *not* organized or indexed such that you can easily find a topic again. Do not expect to use it as a reference book when you have finished browsing.

31 of 40 people found the following review helpful:

3.0 out of 5 stars Write better and kill trees too!, September 17, 1998

By 

Will Sprunk (San Jose, CA) - See all my reviews

This review is from: BUGS in Writing, Revised Edition: A Guide to Debugging Your Prose (2nd Edition) (Paperback)

This book is wonderful; this book rots. One thing for sure -- it's different!

HITS:

1) Informal, nonstuffy feel.

2) Covers a lot of material.

3) Has lots of examples.

4) Does a good job of showing the dynamic and subjective nature of English writing.

5) It is one of the very few style and grammar books that I've read that lends itself to being read like a book of short stories: sit on the john and make yourself a better writer. Now, THAT'S innovative.

MISSES:

1) MUCH physically bigger than it needs to be; thus, it is hard to use as a quick reference. The typeface is too big, but most importantly it is full of completely useless tangential photos. There are between 100 and 200 photos that, while cute, have no place it this book. Some reviewers seem to like this. I find it unprofessional. Would you enjoy paying extra money for a book to look at a stranger's family album? Think of the natural resources wasted on this silliness. If the author wants to write a picture book of her cats, that's fine, but she should market it to people whom get some benefit from it; I submit those people are an extreme minority in the readership of this book.

2) Does not use direct counter examples. So, instead of seeing an example bad sentence corrected, you see a different sentence done right. The author defends this as helping to develop "ear." I usually find it more annoying than helpful.

3) Does not cite sources of her opinions, and therefore it is very hard to take anything this book says as the final word. To be fair, she does warn that it is often just her opinion and not rock-solid fact. Differentiating them is the problem. This shortcomming results in you having to look items up in another book to make sure before you commit something to paper. Need an example? She states that ending a sentence with a preposition is drop-dead wrong. It is not; it is very debatable. I found several more scholarly books that state that is simply not true anymore, if it ever was. One book made an excellent case that this belief is a prejudice stemming from Latin grammar.

4) It's hard to find items in the book. The "Index of Principles" is okay but should probably be called something else and placed in the front of the book. There is no regular index.

5) The cover is butt ugly.

6) The book cover suggests that the book should be filed under General Computing. Now that's insulting. What's this about; do you have to trick technical types into writing better? "Gosh, I was looking for a Java book, and I stumbled on this Bugs book. Now I write much better."

Should you buy this book? I have no idea. Do you like cats?