Slashdot Mirror


Teaching Engineers to Write?

$hecky asks: "I teach several sections of a first-year writing course at a small, private college where most of the students are, or plan to be, some flavor of engineer. Right now, I'm planning next year's courses and wondering what has (and hasn't) helped Slashdot readers become better writers. Also, I'm wondering which writing skills you, in your roles as workers and teachers, would most like to see emphasized in first year writing courses. Put another way, where do you see people who have completed first-year writing courses screwing up their writing, and which experiences, practices, and pressures you think have made you a better writer?" "First, let's head a couple wagons off at the pass. Let's avoid the vulgar confusion of good writing and good grammar. Horrifying grammar is a common problem, but its not a problem I can fix in a semester-long class. About a century of research tells us that native English speakers aren't rule-based parsers, so teaching grammatical rules (like when to use the subjunctive or where to put commas) doesn't improve compliance. The best strategy on those fronts is a habitual reading of clearly-formatted texts and scrupulous multi-stage review of everything you write, both of which are somewhat outside the scope of a semester-long class.

Second, let's say that the chief virtue of good writing is clarity. While some kinds of writing prize being strategically elliptical, and others prize brisk and clever metaphor, most of my students aren't writing grant applications, patents, or poems. So metaphor, however brisk or clever, is out of place if it obscures its subject.

Third, this course is a cultural studies type, rather than a workshop. This means that the course has a topic of inquiry about which all of the students read and write for a semester and that, while being reasonably complex, the topic should accommodate students who are going to become accountants, math teachers, and advertisers. It's common for engineering students to wash out into the business school, and there's a significant contingent of humanities students as well. Anything other than a general interest topic (like the 1960s, ideas about the American West, or fairy tales) isn't an option.

So think back to your writing. What has made you more comfortable with your writing, or eager to improve what you've written? What inspires you to read outside of a classroom or mandated context? Was has impressed on you the importance of revision, or at least of reviewing your writing at intervals? Which parts of which college (or high school) curricula have helped you write better? Finally, which aspects of your students' or co-workers' writing do you find most troublesome?"

32 of 656 comments (clear)

  1. Irony by Ninwa · · Score: 5, Funny

    wuldn't it be ironik if no1 respondid?

  2. A Grammar system helps by OrangeTide · · Score: 4, Interesting

    The 5 column system tends to work well for Engineers since it presents some of the trickest parts of English in a logical way.

    http://www.lbt-languages.de/english/lernhilfe/lern hilfe.html

    --
    “Common sense is not so common.” — Voltaire
    1. Re:A Grammar system helps by Lobo42 · · Score: 3, Informative

      "Main Entry: hopefully
      Function: adverb
      Date: circa 1639
      1 : in a hopeful manner
      2 : it is hoped : I hope : we hope
      usage In the early 1960s the second sense of hopefully, which had been in sporadic use since around 1932, underwent a surge of popular use. A surge of popular criticism followed in reaction, but the criticism took no account of the grammar of adverbs. Hopefully in its second sense is a member of a class of adverbs known as disjuncts. Disjuncts serve as a means by which the author or speaker can comment directly to the reader or hearer usually on the content of the sentence to which they are attached. Many other adverbs (as interestingly, frankly, clearly, luckily, unfortunately) are similarly used; most are so ordinary as to excite no comment or interest whatsoever. The second sense of hopefully is entirely standard."

      From Merriam-Webster, quoted at http://www.cs.rice.edu/~ian/Manifestoes/grammarNaz i.shtml

    2. Re:A Grammar system helps by NMerriam · · Score: 5, Insightful

      I would agree with this completely -- the best use of a semester would be to show students how to approach the organization of written information. This should actually be second nature to engineers, as they frequently are called upon to organize and categorize things, yet their writing tends to lack the clarity of purpose that a good writer brings through proper organization.

      One thing I notice is that people unaccustomed to writing formal papers tend to adopt a very stilted and affected style, thinking it sounds more "official", but it is usually just confusing. As students are writing, some of the most helpful things you can show them are the areas where they sound unnatural. While there's entirely too many people writing in an overly-conversational way online (essentially writing the words they would speak), one of the keys to compelling writing is to be natural and give it some personality.

      --
      Recursive: Adj. See Recursive.
    3. Re:A Grammar system helps by scatters · · Score: 3, Insightful

      So as a former writing instructor, you should know that correct capitilization helps the reader more readily parse the sentance structure, and should be used even when the writing style is 'informal'. Lack of capitalization is just plain laziness.

      E-mail, IM, and particularly SMS is killing proper writing techniques.

      --
      A One that isn't cold, is scarcely a One at all.
  3. What?! by hungrygrue · · Score: 4, Funny

    This is Slashdot, where grammar, punctuation, and subject verb agreement long ago came to die.

    1. Re:What?! by senatorpjt · · Score: 4, Insightful

      Slashdot is a great place to learn to write, because any time you make the slightest grammatical or spelling error, at least 10 people will bitch at you about it.

  4. From personal experience by pHatidic · · Score: 5, Insightful

    I think my biggest problem as a writer has been just learning to get over myself. Adding chiasmus and clever literary trope seems clever to me at the time, but doesn't really do anything for whoever is reading my stuff.

    Another weird habit I have is writing everything as if it were going to be read out loud. This makes many of my sentences unreasonably short. Which is good, when read it my voice. But most people on the web don't read in my voice.

    (you can see what I'm talking about if you check out the newer writing on my website)

    1. Re:From personal experience by Anonymous Coward · · Score: 5, Funny

      And yet, you use the word chiasmus...

  5. Re:Active voice, active voice, active voice by zymurgy_cat · · Score: 4, Funny

    Also, less is more. I repeated myself in the post. Writing sober also seems to help.

    --
    -- Fugacity: Confusing chemists since 1908
  6. When I was a wee lad ... by multimediavt · · Score: 3, Insightful

    The type of writing that garners the most interest from young minds is creative writing rather than the more mundane technical or analytical types. These are engineers. They need to be able to abstract and yet be "technically" correct.

    Writing assignments that start with a foundation, akin to how Sean Connery's character in Finding Forrester helped his apprentice stir his creative juices, can be really effective. I remember quite clearly an English teacher I had in eighth grade that would give us assignments like that. He would start us off with a paragraph setting a scene or introducing a character and we would have to take the story forward from there. Obviously, there are some additional parameters that you as the instructor can wrap around the assignment, but the concept is something that works well for a mixed audience of students.

    Just a suggestion.

    1. Re:When I was a wee lad ... by iamdrscience · · Score: 4, Funny
      akin to how Sean Connery's character in Finding Forrester helped his apprentice stir his creative juices
      When you students perform well, be sure to encourage them by heartily bellowing "You're the man now, dog!" as well.
  7. Suggestions... by Jjeff1 · · Score: 5, Insightful

    First, get every student a copy of "The Elements of Style". It's a very small book originally written around WWI. It points out the most frequent mistakes in writing. It's an excellent book, following the tips within will make anyone a better writer.

    Second, teach people to write to their audience. Far too often I see engineers write a recomendation to a customer that points out technical merits or problems, but doesn't frame those issues with reguard to the customer's business. A COO probably doesn't care about the problems with an ACL entry in a VPN setup. They do care if their employees can't work while on the road.

    Third, while you might not be able to help people with their grammar or spelling, make sure they understand that those things do matter and need to be fixed. One of my co-workers is Jeopardy smart, but his writing is awful. If you were to judge him by his writing you'd think he was a complete idiot. Proofreading is sometimes more important that the initial writing. Students who have severe grammar problems should read their work out loud to themselves. That will help a LOT.

    1. Re:Suggestions... by flogic42 · · Score: 3, Informative

      I wholeheartedly second this. The Elements of Style is superb. In writing, nothing is more important than getting your point across in as precise and concise a way as possible.

      --
      Check out my women's designer clothing store.
    2. Re:Suggestions... by belmolis · · Score: 3, Interesting

      No! No! A thousand times no! The Elements of Style is awful. It purveys ignorant advice that no good writer would follow. For an idea of how awful it is, see this discussion by linguist Geoff Pullum.

    3. Re:Suggestions... by rolfwind · · Score: 3, Interesting

      I read this book, and past the first few chapters, thought it was a boring and pendantic excursion into the proper grammar world. I said it before in this very thread, but I'll repeat it because it is such a good book:

      Get "On Writing Well" by William Zinsser.

      Here are the most worthwhile chapters:
      http://www.cla.wayne.edu/polisci/kdk/general/sourc es/zinsser.htm [wayne.edu]

      The rest of the book is okay, but these three chapters are simply inspired.

  8. Left Brain, Right Brain by RonBurk · · Score: 5, Interesting
    The #1 thing I would make sure I taught engineers is to separate writing from editing. The most common "I hate to write" problem I find in fellow engineers is that no one ever taught them to do the work in (at least) two phases.

    First, do the writing: get all your ideas down as fast as you can without worrying about structure, or complete sentences or anything except putting everything down that you can think of.

    Second, do the editing. Now look at your big pile of ideas and think about what the right order for things is, how to start and finish it, what to throw out, what things go best together, and eventually even sentence-level details like grammar.

    8 times out of 10 when I have an engineer staring at two sentences on an otherwise blank screen, it's because they think it has to spool out onto the page in linear, perfected form right from the start.

  9. Re:Active voice, active voice, active voice by bigdavex · · Score: 5, Informative

    In all my experience as an engineer, the most important thing is to use active voice. For those unaware of what this means, here's an example:

    Passive: The boy *is riding* his bike to the store.
    Active: The boy *rides* his bike to the store.

    Those are both active. I'm pretty sure you meant to write something like this:
    Passive: The bike is ridden by the boy to the store.
    --
    -Dave
  10. I'm so sorry, but I must. by SetupWeasel · · Score: 5, Funny

    Horrifying grammar is a common problem, but its not a problem I can fix in a semester-long class.

    it's

    1. Re:I'm so sorry, but I must. by BitwizeGHC · · Score: 3, Funny

      "I'm only gonna sing this one time. Ohhhh... if you want it to be a possessive, it's just I-T-S, but if it's supposed to be a contraction, then it's I-T-apostrophe-S... scalawag." --Strong Bad

      --
      N4st0r, trixx0r h0bb1tz0rz! Th3y st0l3 0ur pr3c10uzz!
  11. That depends by MsWillow · · Score: 5, Funny

    About what am I to write? For conveying technical information accurately and succinctly, I would use K&R's C book as a guide. For scorching hot lesbian erotica, I emulate Elizabeth Oliver's "Pagan Dreams." To date, both approaches work, but only on the appropriate topics.

    --

    Lemon curry?
  12. Re:Active voice, active voice, active voice by BitwizeGHC · · Score: 4, Insightful

    What you are illustrating is present tense vs. present participle.

    Here is an illustration of active vs. passive voice:
    Active: The boy rides his bike to the shore.
    Passive: The bike is ridden to the shore by the boy.

    You are correct in saying that active voice is the more direct and succinct of the two voices, and that technical writers should prefer it over passive voice. But it helps if your example illustrates the correct principle. :)

    (Here comes the grammar nazi moddage...)

    --
    N4st0r, trixx0r h0bb1tz0rz! Th3y st0l3 0ur pr3c10uzz!
  13. Invest the time by SeeMyNuts! · · Score: 3, Interesting


    My best teacher by far was my freshmen English professor. One thing he did was meet with us one-at-a-time for every paper we wrote. He'd make us read our papers aloud, and he'd point out ways to re-order paragraphs, remove unneeded words, etc. He had taught for something like 50 years, and he knew every mistake we would make and how to explain why it was a mistake.

    1. Re:Invest the time by Haszak · · Score: 5, Interesting

      I had a similar experience. The teacher that turned me on to writing was an instructor I had in colloge. He'd ask everyone to pick their best sentence from that week's assignment. He'd ask us to write it on the board, then he and the class would tear it apart and completely rewrite it. It really got us thinking about what and how we were writing. Do we need this word/phrase? What word/phrase would be stronger here? etc. And I'm still learning the lesson of writing to your audience. It's not "writing" to them, it's "understanding" them that's difficult. Especially for engineers writing about subjects they're familiar with and that their audience (unbeknownst to them) could never understand it in the way they do. I think journalism is a good teacher here. Put the who/what/where/when/why in the first few sentances. It doesn't matter who you are or what you're reading, there's a chance you're going to skim. Best to write for skimmers. I've started writing even small subsections with little bolded titles to catch those who are going to spend five seconds in that area. (It also helps people find what they're looking for.) And I even make seperate versions of the same explanation with titles like "one sentence", "one paragraph", "half page" to describe how detailed I'm getting. After all, especially in technology, you'll never know the abilities, understanding, or interest of those who pick up your documents.

      --
      find me at haszak.org
  14. Re:Active voice, active voice, active voice by richg74 · · Score: 4, Informative
    In all my experience as an engineer, the most important thing is to use active voice. For those unaware of what this means, here's an example:

    Passive: The boy *is riding* his bike to the store.
    Active: The boy *rides* his bike to the store.

    Oh dear. I agree that using the active voice, rather than the passive, is almost always desirable. But your example doesn't use the passive voice. "The boy is riding ..." uses the progressive form rather than the simple present tense, but it's still the active voice. The passive construction would be something like, "The bicycle is being ridden by the boy to the store." (This, incidentally, shows how the passive voice can be clumsy.)

    The passive voice is most objectionable [IMHO] when it is used, in effect, to dodge responsibility for one's statements: "Mistakes were made," or "It was decided that ..." It does, however, have good uses. "The injured man was taken away by ambulance" is an excellent use of the passive voice.

    See The Elements of Style by W. Strunk and E.B. White for excellent guidance on this and many other topics.

  15. Present writing as an engineering problem by MarkusQ · · Score: 5, Insightful

    Present writing as an engineering problem. This is an accurate, if somewhat unconventional, way to look at it. When you write, you have a goal (communicate a certain set of ideas), some constraints (target length, assumed audience, etc.) and some criteria for ranking proposed solutions (shorter is better, linking ideas in multiple ways gives a more robust treatment, etc.)

    This fits neatly into the mold of classic engineering problems. Presented this way, they should be able to (with only a little guidance) bring their full skill set to bear on the problem. For example:

    • Top down design Starting with an outline and working out the details is the normal way of tackling an engineering problem.
    • Checking your facts Engineers should be used to checking anything that is even remotely doubtful before committing to it. So should writers.
    • Failure mode analysis For each sentence ask yourself, could it be misread? How? What is the best way to fix it?
    • Dependency analysis Are the ideas presented in an order that assures that each point can be understood on the basis of the readers assumed knowledge and the information provided by preceding points?
    • Optimization Are there any unnecessary parts? Does the structure require the reader to remember to many details at once, before linking them?
    • Structured testing If you read what you have written assuming only the knowledge that the reader can be expected to have, does each part work the way you intended? If you read it aloud, does it sound the way you intended?

    One of the biggest problems with teaching people to write is getting them to read what they have written, think about it, and rewrite it until it does what they wanted it to. Here, at least, engineers should have a head start over most students, insofar as they are used to the fact that your first stab at a design is almost never viable.

    --MarkusQ

  16. Spelling, grammar by drsmithy · · Score: 4, Insightful
    About a century of research tells us that native English speakers aren't rule-based parsers, so teaching grammatical rules (like when to use the subjunctive or where to put commas) doesn't improve compliance.

    Look, there's no need to get fancy - in my experience you will make a massive improvement in most (young) people's writing today just by teaching them how to use apostrophes and the difference between words like 'there' and 'their'. Mixing up 'than' and 'then' also seems to be something Americans, in particular, do a *lot* (something to do with accent, maybe ?). Speaking of which, telling people "words" like 'alot' aren't really words would also be a handy thing to do.

    The state of English teaching today is atrocious, with many *teachers* not really knowing fundamental rules like when to use apostrophes, etc. Modern teaching philosophies like "as long as the message is communicated" and "it doesn't matter if you make mistakes, as long as your attempt is reasonable", combined with the steady downturn in reading (of "good" writing) and the increasing number of children (and many young adults) who are (/were) brought up with the TV as a babysitter are the prime culprits IMHO. The increasing pervasiveness of IMing and SMSing are only going to exacerbate an already bad situation. We've reached the point where even remotely correct English is unusual to see outside of carefully proofread professional documents and I, personally, am at the point now where I notice it more if someone spells "you're" _correctly_, rather than it's ubiquitous erroneous substitute, "your" (particularly on the web) .

    The best way for people to improve their writing is to read, read, read. Not web pages and blogs (which are likely riddled with errors - particularly if they're written by, or targeted at, younger people - and just create a feedback loop of bad habits) but professionally published books and journals. Steer clear of low-end/populist magazines and tabloid-style newspapers, as well, as they are likely employing youger writers who will be making the same mistakes I'm talking about above - even if they *have* a degree of some sort.

    The kind of attitudes you need to instil in your students are "close enough is *not* good enough", "just getting the message across os *not* sufficient" and "written language has rules, just like engineering, that should be followed to remove the possibility of ambiguity".

    I have no doubt that I have also made technical mistakes just writing this, however, my point is that the level of basic spelling and grammar is so poor these days, that you don't need to be teaching complicated grammatical constructs to improve people's writing, you just need to be teaching the basics.

  17. Ideas flow better when I write well to start with by KWTm · · Score: 5, Interesting

    Not to be contrarian, but I'd like to present a different viewpoint. I have never subscribed to this "just put your ideas down now; worry about the grammar later" school of thought. Such a process makes a chore of having to go back and correct the ideas to make them presentable, as if grammar and other finer points of writing were unnecessary burdens imposed by the teacher and other excessively picky individuals. For me, putting my ideas on paper (or on screen) in a presentable way from the very start makes my ideas flow better because I am channelling them into a form that is understandable by others and hence by myself. In short, it helps me think.

    Now, I admit that perhaps this way isn't for everybody. It just so happens that I've got a pretty good mastery of grammar, spelling, etc. --I won't claim that it's perfect, but it doesn't pose any extra burden for me to do it right. On the other hand, maybe it's because of this very demand for doing it right that has made it second nature to me. If the students don't have this habit ingrained yet, one semester won't be enough to change that; but I'd hate for anyone to aim for a "correct it later" attitude as the norm in writing.

    You could compare it to programming. What are your first steps when you sit down to write a program? Yes, yes, of course there are doodles, sketches and diagrams. But when you get down to coding, I hope that you don't just code any old program and then go back later to fix compilation errors. I hope that you'll make sure it's clean, well-structured code that makes it easy to improve (as opposed to "correct") later.

    --
    404555974007725459910684486621289147856453481154 in hex is "You sank my Battleship?"
    [GPG key in journal]
  18. Writing Workshop at Bell Labs, ~1980 by billstewart · · Score: 5, Insightful
    I worked at Bell Labs after college, and a critical piece of required training was a writing course. I don't remember who ran it, probably some outside teaching firm, but it was really really valuable to me. A couple of the critical lessons
    • Write like a newspaper reporter, not a grad student.
    • Your objective is clear communication to the reader, not beauty or eruditeness or narration of your discoveries and reasoning process. Don't waste their time, or at least don't waste it up front.
    • Hit the important conclusions in the first few sentences so your reader will read them. If you'd like to wrap up with them at the end of your memo, that's fine too, in case anybody's still reading by then, but conclusions come first.
    • If you're trying to express something complex, simplify your writing so it doesn't get in the way. For something simple, 10th grade language structures will do, but if it's really hairy stuff, back down to 8th grade or so.
      (Yes! Now the engineers get to play with grammatical analysis tools and run them on their documents, which was a really cool thing back in the just-after-punchcards days :-)
    • Think about what your audience knows and doesn't know, and what they want and don't want. Express things in terms of what they know and want, not what _you_ know.
    • If you want somebody to do something, tell them specifically. The passive voice indicates that things will or should be or were done, and may optionally refer to who they might be or have been done by - in business, it's perfectly ok to tell people that you want them to do stuff, and politely expressing the valuableness of the acheivement of doneness of stuff not only doesn't tell the person you want to do stuff to do it, it often leads to later arguments about responsibility, scope creep in contracts, or simply to stuff not getting done which causes projects to fail.
    • Yes, this probably means unlearning almost everything you were taught about writing in college. Sometimes it means unlearning what you learned back as far as junior high school.


    Some engineers are really good at grammar and spelling, and consider computer languages to be fundamentally the same processes of clear and beautiful thought as human languages. Others handle them as entirely different things - can't spell worth beenz and don't grammar thier English, even though they spend all day producing flawless syntax in artificial languages. Those of us in the former group don't really understand the latter, and find their behaviour annoying, but it's such a common pattern that it's obviously a different set of mental structures approaches to information processing or something, on the level of spoken-vs-written-vs-visual focus, as opposed to laziness and stupidity (:-) (Though the folks who don't find grammar and spelling natural should really use spell-checkers...) And I'm not ragging on non-native English speakers here - it's extremely common in native speakers, while the non-native speakers I've worked with often learned formal English grammar in school and don't use many of the more subtle verb forms of colloquial speech, though they do often have problems with spelling.

    But as the original article says, grammar and spelling are much different issues than organization of content. There's a real value in teaching engineers how to write.

    --

    Bill Stewart
    New Fast-Compression-only CPR http://preview.tinyurl.com/dy575ks
  19. Remember engineers are YOUR audience. by mc6809e · · Score: 3, Insightful

    Anything other than a general interest topic (like the 1960s, ideas about the American West, or fairy tales) isn't an option.

    These are TERRIBLE subjects for engineers. Do you really want someone that enjoys deep, scientific analysis to suffer trying to analyze the 1960s, or the American West, or fairy tales?

    And analyze he will! Or fail trying.

    Some engineers simply won't put up with all the fuzzy thinking that's permitted in the humanities. They'll try to become social scientists first before writing the first sentence.

    Remember, they're going to be engineers designing million dollar structures and systems. People MAY DIE if these engineers make a mistake. They need to know the science first. They need to understand their area thoroughly before proceeding.

    Now you come along and ask them to engineer a paper about an enormous subject like the 1960s. Just how do you expect to them to be able to do that?So, in their desperation, they give you a mediocre paper back or nothing at all.

    Remember your audience. You're not dealing with poets.

  20. Precision by Auxbuss · · Score: 3, Insightful

    Lots of good stuff has already been recommended, so I'll add what I haven't seen here, apart from joining the voices that recommend writing for your audience; never let that though leave your mind.

    Precision is key, whether practicing technical or creative writing. It is a truism that every word counts. Whether you are expounding about 'a thing', 'the thing', 'each thing', or 'every thing', you must be precise about which thingy you are on about.

    To be sure, precision is not an easy writing skill to learn; you need to be able to ruthlessly excise fluff from your scribblings, and reread your own words from the perspective of others.

    While I agree with the OP that grammar is not critical at the first stage, basic punctuation is essential - the well known 'eats shoots and leaves' example proves that point.

    Metaphor might be left aside in the early stages, but English is an idiomatic language and much of its colour comes from those idioms.

    From what you have written, you are teaching folk who will be writing from positions of professional authority. That being so, metaphor is unlikely to be an issue, but common faults such as tautology and cliches will be - their use diminishes the authority of writer in the reader's mind.

    Now to a specific point of personal pedantry: The clearest divide that I see between authoritative and also ran writing is in the use of prepositions.

    In your own case you said, "First, let's head a couple wagons off at the pass". In this case, the missing preposition after 'couple' is commonly seen on the internet - it's kinda slang brung over from speech - but would be edited immediately (both in the US and elsewhere). No-one would say, 'a pride lions' or 'a swarm bees'.

    That wasn't meant as an ad hominem attack, but it served to make my point. The list of abuse of/in/with propositions is long, but, used correctly, they add precision to a text.

    If I were in your shoes, I would want to make clear to my students that there is a broad range of topics to keep in mind when writing, but that mastery isn't necessary to communicate authoritatively. However, to ignore them will result in writing that never gains the air of authority and will thus be treated as such.

    One final suggestion: midmaps. For folk who find difficulty in moving their ideas from mind to paper, mindmaps are often a boon.

    --
    Marc
  21. Highschool Teaching Problems by Dr.+Evil · · Score: 3, Insightful

    I figured out many years after highschool that the reason why so few people understand how to write:

    • Highschools teach writing in English class.
    • English teachers teach English class
    • To qualify as an English teacher, you have to pass English courses
    • English courses teach creativity, literature, classics, poetry etc.
    • Essays, documentation, memos and reports have nothing to do with creativity, literature, classics, poetry, etc.

    I think it is quite possible that most of the English teachers in North America know less about technical writing or writing essays in the social sciences than the average engineering undergrad. Infact, English teachers are the least qualified people to teach you how to write.

    PhysEd teachers have a better chance of teaching you how to write!

    (The most annoying part of communicating with my coworkers is translating English written with Chineese grammar into English with English grammar.)