Gas station without pumps

2015 February 21

Long sentence

Filed under: Uncategorized — gasstationwithoutpumps @ 16:07
Tags: ,

Joseph Mitchell created a marvelous long sentence (found in A City of Many Pasts in The New Yorker):

And I should also say that when I say the past I mean a number of pasts, a hodgepodge of pasts, a spider’s web of pasts, a jungle of pasts: my own past; my father’s past; my mother’s past; the pasts of my brothers and sisters; the past of a small farming town geographically misnamed Fairmont down in the cypress swamps and black gum bottoms and wild magnolia bays of southeastern North Carolina, a town in which I grew up and from which I fled as soon as I could but which I go back to as often as I can and have for years and for which even at this late date I am now and then all of a sudden and for no conscious reason at all heart-wrenchingly homesick; the pasts of several furnished-room houses and side-street hotels in New York City in which I lived during the early years of the Depression, when I was first discovering the city, and that disappeared one by one without a trace a long time ago but that evidently made a deep impression on me, for every once in a while the parlor or the lobby of one of them or my old room in one of them turns up eerily recognizable in a dream; the pasts of a number of speakeasies, diners, greasy spoons, and drugstore lunch counters scattered all over the city that I knew very well in the same period and that also have disappeared and that also turn up in dreams; the pasts of a score or so of strange men and women—bohemians, visionaries, obsessives, impostors, fanatics, lost souls, gypsy kings and gypsy queens, and out-and-out freak-show freaks—whom I got to know and kept in touch with for years while working as a newspaper reporter and whom I thought of back then as being uniquely strange, only-one-of-a-kind-in-the-whole-world strange, but whom, since almost everybody has come to seem strange to me, including myself, I now think of, without taking a thing away from them, as being strange all right, no doubt about that, but also as being stereotypes—as being stereotypically strange, so to speak, or perhaps prototypically strange would be more exact or archetypically strange or even ur-strange or maybe old-fashioned pre-Freudian-insight strange would be about right, three good examples of whom are (1) a bearded lady who was billed as Lady Olga and who spent summers out on the road in circus sideshows and winters in a basement sideshow on Forty-second Street called Hubert’s Museum, and who used to be introduced to audiences by sideshow professors as having been born in a castle in Potsdam, Germany, and being the half sister of a French duke but who I learned to my astonishment when I first talked with her actually came from a farm in a county in North Carolina six counties west of the county I come from and who loved this farm and started longing to go back to it almost from the moment she left it at the age of twenty-one to work in a circus but who made her relatives uncomfortable when she went back for a visit (“ ‘How long are you going to stay’ was always the first question they asked me,” she once said) and who finally quit going back and from then on thought of herself as an exile and spoke of herself as an exile (“Some people are exiled by the government,” she would say, “and some are exiled by the po-lice or the F.B.I. or the head of some old labor union or the Mafia or the Black Hand or the K.K.K., but I was exiled by my own flesh and blood”), and who became a legend in the sideshow world because of her imaginatively sarcastic and sometimes imaginatively obscene and sometimes imaginatively brutal remarks about people in sideshow audiences delivered deadpan and sotto voce to her fellow-freaks grouped around her on the platform, and (2) a street preacher named James Jefferson Davis Hall, who also came up here from the South and who lived in what he called sackcloth-and-ashes poverty in a tenement off Ninth Avenue in the Forties and who believed that God had given him the ability to read between the lines in the Bible and who also believed that while doing so he had discovered that the end of the world was soon to take place and who also believed that he had been guided by God to make this discovery and who furthermore believed that God had chosen him to go forth and let the people of the world know what he had discovered or else supposing he kept this dreadful knowledge to himself God would turn his back on him and in time to come he would be judged as having committed the unforgivable sin and would burn in Hell forever and who consequently trudged up and down the principal streets and avenues of the city for a generation desperately crying out his message until he wore himself out and who is dead and gone now and long dead and gone but whose message remembered in the middle of the night (“It’s coming! Oh, it’s coming!” he would cry out. “The end of the world is coming! Oh, yes! Any day now! Any night now! Any hour now! Any minute now! Any second now!”) doesn’t seem as improbable as it used to, and (3) an old Serbian gypsy woman named Mary Miller—she called herself Madame Miller—whom I got to know with the help of an old-enemy-become-old-friend of hers, a retired detective in the Pickpocket and Confidence Squad, and whom I visited a number of times over a period of ten years in a succession of her ofisas, or fortune-telling parlors, and who was fascinating to me because she was always smiling and gentle and serene, an unusually sweet-natured old woman, a good mother, a good grandmother, a good great-grandmother, but who nevertheless had a reputation among detectives in con-game squads in police departments in big cities all over the country for the uncanny perceptiveness with which she could pick out women of a narrowly specific kind—middle-aged, depressed, unstable, and suggestible, and with access to a bank account, almost always a good-sized savings bank account—from the general run of those who came to her to have their fortunes told and for the mercilessness with which she could gradually get hold of their money by performing a cruel old gypsy swindle on them, the hokkano baro, or the big trick; and, finally, not to mention a good many other pasts, the past of New York City insofar as it is connected directly or indirectly with my own past, and particularly the past of the part of New York City that is known as lower Manhattan, the part that runs from the Battery to the Brooklyn Bridge and that encompasses the Fulton Fish Market and its environs, and which is part of the city that I look upon, if you will forgive me for sounding so high-flown, as my spiritual home.

Although this sort of long sentence may be amusing as a tour de force in literary writing, marvelous mainly for its ability to remain grammatical, despite the length, I hope never to see such a long sentence in technical writing.

2015 February 11

Still more senior thesis pet peeves

Filed under: Uncategorized — gasstationwithoutpumps @ 21:33
Tags: , , , , ,

I previously posted some Senior thesis pet peeves and More senior thesis pet peeves. Here is another list, triggered by a couple of groups of second drafts (in no particular order, though some are repeats of earlier ones—the students hadn’t gotten the message):

  • Passive voice is not to be used. When passive voice is used, the reader has a hard time figuring out who actually did anything. A thesis is written toestablish that someone is competent to do research and write about it. If the entire thesis is written in passive voice, with no first-person singular, the implication is that all the work was done by person or persons unknown.If you did the work, claim it! If you didn’t do the work, tell me who did!
  • “however”≠”but”: “However” is a sentence adjective, but it is not a conjunction. “However” is best used in the middle of a sentence—it can, however, be moved to the beginning, if necessary for readability. However, there is some danger when it is at the beginning of a sentence of merging the sentence with the previous one, and treating it like a conjunction. If you make that mistake, replace “however” and the following comma with “but”.
  • A number of students are using dangling modifiers: starting sentences with modifiers that would apply to the subject of the sentence, then changing their mind and putting a different subject in the main part of the sentence.  (I won’t embarrass students by quoting their work here—there are a number of examples at http://examples.yourdictionary.com/examples-of-dangling-modifiers.html.)
  • Lists need to consist of parallel items.  The items need to be grammatically parallel as well as semantically parallel. If one is a noun phrase, then all need to be noun phrases.  If one is a verb clause, they all need to be verb clauses.  The semantic parallelism is a little subtler—don’t mix properties of an object with instructions for using the object, for example.  The bulleted lists of visual aids for talks are a particularly important place to apply the rules of parallelism.
  • I recommended that students start each chapter on a new page. Not only is this conventional book and thesis formatting, but starting each chapter on a new page makes it easier for the reader to distinguish between chapter breaks, section breaks, and subsection breaks.  Anything that makes it easier for a reader to stay oriented in a large document is useful. (I also recommended numbering sections and subsections with the chapter.section.subsection style used in most computer-science documents.
  • Figures and tables should be sequentially numbered, and the name of the figure is the word “Figure” followed by an unbreakable space, followed by the number. Because this is the name of the figure, it is capitalized like other proper nouns: Figure 1, Table 3, … . All figures should be referred to in the text, and the figures should appear near where the first reference to them is (unless there are a group of figures relegated to an appendix, with their existence mentioned in the main body, but not discussed there). If you need to insert a new figure, you need to renumber everything after that point—so make all your figure numbering be handled by automatic cross references by the program, as manual renumbering is highly error-prone. If you have a name like Figure 2b, it means a subfigure of Figure 2, not a figure you added late between the old Figures 2 and 3.  (Incidentally, I hate how WordPress throws away unbreakable spaces when converting back and forth between “Visual” and “Text” editing.  No matter how carefully I put them in, WordPress manages to mess them up and turn them back into ordinary spaces.)
  • “parse”≠”scan”: Every year I get a number of students who have picked up the word “parse” from a computer science class, and misunderstood it to be a synonym for “scan”. That’s not what it means. To parse something is to determine its structure—to break it into parts and analyze the relationship among the parts (generally in terms of some grammar). The verb “parse” is transitive—it takes an object, not a prepositional phrase, that holds the thing being analyzed.
  • Students are still having trouble with countable and uncountable nouns. For some students, this is understandable, as their native languages do not make the countable/uncountable distinction that English does.  I pointed students to the Oxford Student Dictionary of American English, edited by Hornby, which is now out of print, as being a dictionary that actually tells you whether a noun is countable or not.  The Oxford Advanced American Dictionary for learners of English is not as nicely formatted, but also has the [C] and [U] markings and is still in print.I used two examples of nouns that changed meaning depending on whether they were countable:  “grub” and “time”.  “Grub” is food, but “a grub” is the larval form of an insect, which may or may not be food. “Time”, when uncountable, is a duration, but “times”, when countable, are separate events.

    Even native speakers of English sometimes mess up the countable/uncountable distinction (though usually not with articles). The contexts where native speakers mess up are “amount of”/”number of”, “less”/”fewer”, and “much”/”many”—in all of which the first form should be used with uncountable nouns and the second with plural forms of countable nouns.

2015 January 26

More senior thesis pet peeves

Filed under: Uncategorized — gasstationwithoutpumps @ 22:17
Tags: , , , , ,

I previously posted some Senior thesis pet peeves. Here is another list, triggered by another group of first drafts (in no particular order):

  • An abstract is not an introduction. Technically, an abstract isn’t really a part of a document, but a separate piece of writing that summarizes everything important in the document. Usually the abstract is written last, after everything in the thesis has been written, so that the most important stuff can be determined. Most readers will never read anything of a document but the abstract.
  • Every paragraph (in technical writing) should start with a topic sentence, and the remaining sentences in the paragraph should support and expand that topic sentence. If you drift away from the topic, start a new paragraph! The lack of coherent paragraphs is probably the most common writing problem I see in senior theses.
  • I don’t mark every error I see in student writing. It is the student’s responsibility to learn to recognize problems that I point out and to hunt down other instances themselves. Students need to learn to do their own copy editing (or copy edit each other’s work)—I’m not interested in grading my own copy editing on subsequent drafts of the thesis.
  • Every draft of every document that is turned in for a class or to a boss should have a title, author, and date as part of the documents.  Including this meta-information should be a habitual action of every engineer and every engineering student—I shouldn’t be seeing last-minute hand-scrawled names and titles on senior thesis drafts.
  • Page numbers!  Every technical document over a page long should have page numbers. If you don’t know how to get automatic page numbers with your document processor, either stop using it or learn how!
  • Earlier this quarter I said that I did not care what reference and citation style you used, as long as it was one of the many standard ones. I’ve decided to change my mind on that—I do care somewhat what style you use for the reference list. Use a reference style that contains as much information as possible: full author names, full journal name, dates, locations of conferences, URLs, DOIs, … .  You may format it in any consistent manner, but provide all the information.
  • Use kernel density estimates instead of histograms when showing empirical probability distributions. My previous post explains the reasons.
  • Avoid using red-green distinctions in graphics. About 6% of the male population is red-green colorblind. There are color-blindness simulators on the web (such as http://www.color-blindness.com/coblis-color-blindness-simulator/) that you can use to check whether your color images will work.  Modern gene-expression heat maps use red for overexpression, blue for underexpression, and fade to white in the middle.  This scheme has the advantage of having the strong signals in saturated colors and the weak ones in white or pastels, blending into the white background.
  • Comma usage continues to be a problem for many students. I discussed three common comma situations in English:
    • Comma splices. Two sentences cannot be stuck together with just a comma—one needs a conjunction to join them. If a conjunction is not desired, an em-dash can be used (as in the previous sentence). Sometimes a semicolon can be used, but never a bare comma.
    • Serial comma. There are two different conventions in English about the use of commas before the conjunction in a list of three or more items. In American English, the comma is always required, but in British English the comma is often omitted. I strongly favor the American convention (also known as the serial comma or the Oxford comma), and I will insist on it for the senior theses—even for those students raised in the British punctuation tradition.
    • When using “which” to introduce a relative clause, the clause should be non-restrictive. That is, omitting the clause beginning with “which” should not change the meaning of the noun phrase that is being modified by the relative clause. Non-restrictive relative clauses should be separated from the noun phrase they modify with a comma. If you have “which” without a comma starting a relative clause, then check to see whether you need a comma, or whether you need to change “which” to “that”, because the clause is really restrictive. Note: “which” is gradually taking over the role of “that” in spoken English, but this language change is still not accepted in formal writing, which is more conservative than speech.
  • The noun “however” is a sentence adjective, but it is not a conjunction. You can’t join two sentences with “however”. You can, however, use it to modify a separate sentence that contrasts with the previous one.
  • Colons are not list-introducers. Colons are used to separate a noun phrase from its restatement, and the restatement is often a list. The mistaken notion that colons are list-introducers comes from the following construction: the use of “the following” before a list. The colon is there because the list is a restatement of “the following”, not because it is a list. Note that two sentence back, I used a colon where the restatement was not a list. Similarly, I don’t use a colon when the list is
    • the object of a verb,
    • the object of a prepositional phrase,
    • or any other grammatical construct that is not a restatement or amplification of what came before the colon.
  • Most students in the class use “i.e.” and “e.g.” without knowing the Latin phrases that they are abbreviations for. I suggested that they not use the abbreviations if they wouldn’t use the Latin, but use the plain English phrases that they would normally use: “that is” and “for example”. If they must use the Latin abbreviations, they should at least punctuate them correctly—commas are needed to separate the “i.e.” and “e.g.” from what follows, just as a comma would be used with “that is” or “for example”.
  • Some students use the colloquial phrase “X is where …”, when what they mean is “X is …”. The “where” creeps in in some dialects of English to serve as a way of holding the floor while you think how to finish the sentence—it doesn’t really belong in formal technical writing.
  • “First”, “second”, and “last” are already adverbs.  They don’t need (and can’t really take) an “-ly” suffix. It grates on me the way same way that “nextly” does. “Next” has exactly the same dual status as an adjective and an adverb, but for some reason does not often suffer the indignity of being draped with a superfluous “-ly”.
  • I recommend that students not use the verb “comprise”, as few use it correctly. You can say that “x, y, and z compose A”, “A is composed of x, y, and z”, or “A comprises x, y, and z”. The construction “is comprised of” is strongly frowned on by most grammarists—avoid it completely, and avoid “comprise”, unless its usage comes naturally to you.  “Compose” and “is composed of” are less likely to get you in trouble.
  • “Thus” does not mean “therefore”—”thus” means “in this manner”. Note that “thus” is an adverb, so there is no “thusly”.
  • “Amount” is used for uncountable nouns (like “information”), while “number” is used for countable nouns (like “cells”). There are many distinctions in English that depend on whether a noun is countable or not (the use of articles, the use of plural, “many” vs. “much”), but “number” vs. “amount” seems to be the one that causes senior thesis writers the most difficulty.

2015 January 18

Senior thesis pet peeves

Filed under: Uncategorized — gasstationwithoutpumps @ 19:47
Tags: , , , ,

Every week in my senior thesis writing class, I go over some of the things I saw in student writing that I think need to be fixed.  I’ve decided to try to collect some of the notes here, though I doubt that I’ll ever get a full set, since a lot of the talk is extemporaneous or prompted by questions.  They are not in any particular order.

  • One of the first things I tell students about the structure of a thesis, is that it must start with a clear statement of the research question or design goal of the thesis. (This is traditionally called the “thesis statement,” but I don’t use that term.)  Without explicit demands to put the statement in the first paragraph, and (if possible) the first sentence, students tend to write pages of background material before getting to the point of their thesis. In journalism, this mistake is called “burying the lede”, and it is just as serious a problem in a thesis or thesis proposal as it is in a newspaper article.

    Even after getting this instruction, a lot of students want to write about the overall goals of the lab they are working in, rather than giving the specific goal of their thesis. It sometimes takes two or three iterations before students get a clear, correct statement of the research question or engineering design goal that they are addressing in their thesis.

  • One pervasive problem (often encouraged by the students’ research mentors) is to write the entire thesis in the passive voice. Writing journal articles in passive voice is fairly common, and some people have gotten the mistaken notion that passive is somehow more formal and correct than active voice. But passive is wholly inappropriate for a thesis.The point of a thesis is to establish the research skills of the person writing the thesis. So most of the thesis should be written in first-person singular: I developed a new protocol … ; I transfected the cells … ; I analyzed the data … ; I hypothesize that …  Plural is strongly discouraged—”we” should only be used where other people are explicitly called out by name. Passive voice, which amounts to an assertion that the actor is unknown or unimportant should be avoided.

    I don’t want to prohibit passive voice, though, as there is an important use for it in technical writing, even in theses. That use is inverting sentences, to put the object before the subject: “X did Y” ➜ “Y was done by X”. This reordering can be very useful for improving flow, which relies on putting the old information at the beginning of a sentence and the new information at the end of the sentence.

  • Students often borrow figures from lab mates or from published papers to put in their theses, particularly in the background section. I’d like students to create their own figures as much as possible, but there are plenty of times when copying a figure is the right thing to do. What students usually miss, however, is the need to put an explicit figure credit at the end of the figure caption—something of the form “Figure copied from Smith and Ng [Smith and Ng, 1999]”. A simple citation is not enough, just as a citation is not sufficient defense against plagiarism for copied text, unless there are explicit markings indicating a direct quotation.  When a figure is redrawn or modified, the figure credit should have the form “Figure adapted from …”, rather than “Figure copied from …”, but the explicit credit is still needed.

    One reason I object to copied figures is that students usually do a very bad job of it, copying a low-resolution image off the internet, often with screen-capture tools, so that the image in their thesis is blurry or jagged. Going to the original articles and extracting the PDF images would eliminate at least a little of the awfulness of the copies.

  • Speaking of citations, students often ask what citation format they need to use for their theses. There aren’t any standards for senior theses at our campus, but there are for PhD theses, so I suggest using that style. The PhD thesis citation style on our campus calls for parenthesized author and year format: (Smith and Ng, 1999). That style, though rather long-winded, has the advantage of not requiring the reader to keep flipping to the reference list to see what the citation refers to (a huge advantage in the days of microfilm, but slightly less important now).

    The citation list itself can be in any standard format—I prefer to have the list sorted alphabetically be author and using the full author names, article titles, full journal names, and URLs and DOIs when available. Many journals use a much terser style to save space, but having the full information is useful to scholars, as it provides some redundancy to help correct for typos in the citation.

  • I have to tell a number of students about the concepts of paragraphs and making the first sentence of each paragraph be a topic sentence. Many of the students otherwise start stream-of-consciousness dumps of ideas that go on for pages with no internal structure. Stream of consciousness may have worked for James Joyce (I wouldn’t know, as I could never read more than a page or two of his stuff), but it doesn’t work for scientific writing. Every sentence of a paragraph should be supporting or amplifying the topic sentence.
  • Students often have trouble with vague antecedents for their pronouns—particularly when they use “this” as a pronoun. I strongly suggest that they check every “this” and “that” in their writing, and if it is used as a pronoun, replace it with a noun phrase: “this technique”, “this method”, “this protein”, … Where they can’t find the appropriate noun to use, their readers certainly won’t be able to figure out the intended antecedent. Incidentally, this usage of “this” is referred to as a demonstrative adjective, though it might be more useful to refer to it as an article (like “the” or “an”), since that is the position in the noun phrase that it occupies.
  • A lot of what I tell students has to do with typography and copy editing, rather than with writing per se. For example, I tell them about the 4 types of dashes:
    hyphen –
    a very short mark used inside compound words, to turn a noun phrase into a modifier of another noun, or to mark the end of a line where the word continues onto the next line.
    en-dash –
    a somewhat wider mark (about the width of a lower-case “n”) that is used to represent ranges, such as 1–10 or Jan–Jul.
    em-dash —
    a much wider mark, used for sentence-level punctuation—somewhat like a semicolon or parentheses
    a minus sign –
    used only in mathematics, the minus sign is usually the same size as the en-dash, but has different spacing rules. The text marks (hyphen, en-dash, and em-dash) have no space around them (though some typographers will put thin spaces around em-dashes), but the minus sign has the same spacing rules as the plus sign (with different rules depending whether it represents a unary or binary operator). Basically, if you are not an expert in math typography, you should use LaTeX to typeset your math and trust it to do a better job than you can.

    While I’m on the subject of hyphens, I usually tell students that when they use a noun phrase to modify another noun, they should hyphenate the whole modifying noun phrase. For example, the process of synthesizing amino acids is called amino-acid synthesis, and the pathway that does it is the amino-acid-synthesis pathway.

  • A lot of biology acronyms and gene names are case-sensitive and start with lower-case letters (like tRNA, siRNA, dsDNA, p53, … ). Sentences should not be started with uncapitalizable symbols. If you need to start a sentence with “p53”, try “Tumor suppressor p53” instead. Sometimes just adding an article helps: “tRNA genes” ➜ “The tRNA genes”.
  • Biology papers have two major uses for italics: for new jargon terms in the context where they are first defined and for genus-species names (like Escherichia coli or C. elegans). The genus-species typesetting rules are a bit complicated —genus is capitalized, but species is not; genus can be abbreviated to a single letter with a period, if unambiguous; subspecies or strain names are not italicized. Italicizing words when they are first defined is a simpler concept, one which can be applied to almost any academic writing.
  • There a few words that I object to also. Perhaps the most common problem is the ugly neologism “utilize”, which is used far too often by students, when what they mean is “use”. (The older meaning of “utilize”—to make useful—has disappeared.

2015 January 4

New tech writing course

Filed under: Uncategorized — gasstationwithoutpumps @ 15:07
Tags: , , , , ,

In my request for comments, xykademiqz mentioned that she’d like to hear about the tech writing course I’m planning.

Planning this course has been a bit of weird exercise for me, because it is the first time that I’m designing a course that I won’t teach. Normally, I design courses that I teach, which occasionally get transferred to some other teacher.  Here, I’m trying to modify a course I designed and taught for a long time, adapting it to a new audience. But I’ve not taught the original course since Winter 2003 (11 years ago!), and I don’t plan to teach this one, as I already have a more-than-full teaching load.  I’ve paid my dues teaching tech writing, having taught it sixteen times (1987–2003).

The course I originally created was for computer engineering majors, but this one is for bioengineers, specifically those in the biomolecular engineering concentration.

The rest of this post is the “Undergraduate Supplemental Sheet—Information to accompany Request for Course Approval” that is required at UCSC for approval of any new course. I have sent the form off to the Committee on Educational Policy, the committee of the Academic Senate that reviews new courses. I’m hoping to get approval for our department to offer this course in Spring 2015, so there isn’t much time for revision if they decide that they don’t like something. I’ve left a number of design questions in the document, although this is not usually done for CEP course approvals, to emphasize that this course is a work in progress, and to give them some idea of the adjustments that are likely to be needed in the first couple of years. The course design has been discussed by a group of five faculty, two or whom are likely to teach the course, and one of whom is likely to be a guest lecturer for it.  I welcome further discussion—particularly suggestions for more specific exercises (for the graphics and the library puzzle, for example).


 

Sponsoring Agency: Biomolecular Engineering Course #: 185
Catalog Title: Technical Writing for Biomolecular Engineers
Catalog copy:

Writing by biomolecular engineers, not to general audiences, but to engineers, engineering managers, and technical writers. Exercises include job application and resume, library puzzle, graphics, lab protocols, document specification, progress report, survey article or research proposal, poster, and oral presentation.

Enrollment limited to bioengineering majors, or by permission of instructor.

Prerequisite(s): satisfaction of Entry Level Writing and Composition requirements; and Biology 101L (biochemistry lab).
BIOL 101L may be taken concurrently.

Enrollment limited to 20.

1. Are you proposing a revision to an existing course?  If so give the name, number, and GE designations (if applicable) currently held.

No

2. In concrete, substantive terms explain how the course will proceed. List the major topics to be covered, preferably by week.

The course will consist primarily of writing and feedback on that writing, with some lectures and readings on common problems. There will be a substantive writing assignment due every week, and the week-by-week outline below lists the assignment that the student will complete that week—some will need to have been started much sooner, so that students may be working on multiple assignments simultaneously.

The list below is the initial design of the course, but we expect that the assignments in the course will evolve, depending on how well they work to develop students’ facility and scientific and engineering writing

Week 1: Job application letter, resume, and letter of recommendation.
The purpose of this assignment is to focus student attention on audience assessment, in a practical format that they see the point of.

Week 2: Library research.

Students will have a library information session, in which they learn how to locate lab protocols, material safety data sheets, and databases of important molecular biology reagents. There will be a library search quiz, with specific questions relevant to biomolecular engineers that use databases learned about in the library information session.  Students will have to write up their search strategies, and not just the results of their searches.

Correct citations in a consistent style will be essential, though students will not be held to any particular style, as the field has an enormous diversity of preferred styles. Use of citation tools (such as Zotero or BibTeX) will be strongly encouraged.

The library puzzle questions will feed into the later assignments: data for the graphics assignment, lab protocols that can be blended together for the lab protocol assignment, and so forth.

Design questions to explore in the first couple of years: can we come up with suitable questions, similar in difficulty to those in
http://users.soe.ucsc.edu/~karplus/185/w03/reader/9_Library_Puzzle.html each year?  How much can questions be re-used from year to year?  Can lab managers and librarians be enlisted to help update the questions frequently?

Weeks 3&4: Design of scientific graphics

Students will prepare at least three different graphics, including a scatter diagram, a line or box plot with error bars, and a block or cartoon diagram of a process. Figures for this assignment must be generated by the student, not copied from the web or other sources. Students will be allowed to use almost any graphics tool (gnuplot, R, MATLAB, matplotlib, Python, Inkscape, …) except Excel, which is often the only tool students have previously used, and which produces unacceptable graphics with the default settings.

Concepts taught will include some of the main concepts in Tufte’s Visual Display of Quantitative Information, though that book will not be required for the course (too expensive for the small amount the students will use). Important concepts include avoiding chart junk (especially fake 3D), proper scale and range of axes (including when to use log scales), “up is good”, people only understand straight lines, and making the graphics tell the story.

Also included will be the notion of floating figures with figure numbers and paragraph-long captions, as many students do not seem to have learned this standard style for scientific and engineering reports before their senior thesis.

Design questions for the first few years: What public data sets should we use? (Census data? RNA expression data?) Students need to be able to find the data as part of the library puzzle.  How should the material be broken up between the two weeks—two separate assignments or draft and final version?  For the first run, it would probably be easier to have separate assignments.

Week 5: Writing a lab protocol.

Many biomolecular engineers will end up with jobs as lab technicians, where they will have to read and write lab protocols. This assignment is intended to get them familiar with the format and conventions.

Design question: What lab protocol can students be asked to write? It must be simple enough that an undergrad can write it, but not just a copying task from some source of protocols.

Staffing questions: Will the instructors that we hire for BME 185 be able to read and comment on lab protocols appropriately (pointing out missing steps or incorrect units, for example)? Will we need a guest lecture explaining the protocol that the students will then write up?

Discussions among writing faculty and biomolecular wet-lab researchers have lead to a few ideas for the protocol to try for the first offering.  It looks likely that a guest lecture from a wet-lab researcher will be needed from someone familiar with the protocol to be written.

Week 6: Final project proposal

The students will write a proposal for the paper they will write as the final project for the course.  Note that this is not a research proposal, but a writing proposal, in which they will describe the topic, the intended audience, and the format of the project.

The project should be a survey article, prior-work section of a senior thesis, or other project that involves substantial library research.  Students should include at least five citations for work that they will be consulting in writing the project.

Key concepts for proposal writing include getting the precise definition of the research question or design goal into the first paragraph.  For this assignment the design goal is the paper to be written, and the specifications for that paper.

Week 7:    Oral presentation

Students do a 5-10-minute individual (not group) oral presentation with visual aids (PowerPoint, Keynote, HTML, or
PDF format).  Students will be taught the design of visual aids for scientific talks (which have a little more content than some other types of visual aids) as well as standard public speaking techniques for eye contact, gestures, expressive voice, pace of talk, and controlling nervousness.

It may be a good idea to have half a class period dedicated to voice projection, including going out into the woods to practice speaking loudly.  The course will not cover techniques for working with microphones, as that is a more specialized skill that would require extra equipment in the classroom.

Design questions to address in the first few years:

The oral presentations will have to be spread out over several class periods, and they represent a major constraint on the class size. At 10 minutes, the oral presentations for a 20-student class would consume an entire week of class time. How much class time can be spent on presentations?  Will 5-minute presentations suffice?

Video recording the presentations and having individual feedback on the presentations would be valuable, but the logistics of arranging for the video recording and scheduling feedback sessions may be too difficult to sustain.  Just rendering videos into a usable format can take 10 times as long as the recording.  Is there any campus-level support for doing this?

Week 8:    E-mail Progress Report and draft

Students write a 100-200-word e-mail memo explaining the status of their final project and attach a draft of their paper for detailed feedback.  This assignment practices professional e-mail style, the content of progress reports, and ensures that they do not put off starting their final report.

Class time will include discussion of professional e-mail and social media (such as blogs), and the differences from the informal social media they may be used to.

Week 9:    Poster presentation

Students design, print, and present a poster, preferably on a research topic they are pursuing in another course.  This will usually be related to their final project, but it may be a different project.

Students will be taught the visual flow of posters, the trade-off between detailed information and readability of a poster, font sizes, color choices, and the need for posters to be comprehensible as stand-alone documents.

Because of the time required to print a poster, students will probably be presenting their posters in week 10, or even during the scheduled final exam time.

Week 10:    Final project report will be due at the time of the final exam slot.

3. System-wide Senate Regulation 760 specifies that 1 academic credit corresponds to 3 hours of work per week for the student in a 10-week quarter.  Please briefly explain how the course will lead to the appropriate amount of work with reference to e.g., lectures, sections, reading and writing assignments, examination preparation, field trips, providing specific estimate of the number of hours devoted to each.
[Please note that if significant changes are proposed to the format of the course after its initial approval, you will need to submit new course approval paperwork to answer this question in light of the new course format.]

There will be 3.5 lecture hours a week, about 1.5 hours of reading, and 10 hours of writing and editing, for a total of 15 hours a week.

4. Include a complete reading list or its equivalent in other media.

The main text book will be Huckin and Olsen’s Technical Writing and Communication for Nonnative Speakers of English (ISBN 978-0070308251, which is out of print but is available used for under $30, see http://www.gettextbooks.com/isbn_9780070308251.html) with particular attention to Part 5 (Readability).  Within Part 5, Chapters 21 (Readability: General Principles), 22 (Writing Paragraphs), 24 (Maintaining Focus), and 25 (Creating Flow between Sentences) are particularly valuable.

Individual students may be referred to chapters in Part 6 (Review of Grammar, Style and Vocabulary Building) as needed.  Chapters 29 (Indefinite Articles) and 30 (The Definite Article) are particularly valuable for non-native speakers whose native language does not use articles (Russian, for example, and many Asian languages).

Design question:  will sufficient copies of the book remain available at a reasonable price?  Is there any other text that provides the quality of parts 5 and 6 of Huckin and Olsen for readability and non-native grammar?

5. State the basis on which evaluation of individual students’ achievements in this course will be made by the instructor (e.g., class participation, examinations, papers, projects). Enumerate the minimum required learning outcomes for a student to pass this course. (Example: ability to do comparative analysis of a Western and a non-Western text.) Provide information on how these components are weighted.

Students will be evaluated on their writing and on their oral and poster presentations.  Each of the assignments will have roughly equal weight, with perhaps a little more weight on assignments towards the end of the quarter than ones toward the beginning (so that students whose writing improves during the quarter are suitably rewarded).

6. Final examinations are required of all undergraduate courses unless CEP approves an alternate method of comprehensive evaluation (e.g., a term paper). Note: final papers in lieu of final examinations must be due during final examination week, and not before. If the course does not have a final examination, indicate the alternative method of comprehensive evaluation.

There is no final examination, as the skills of interest in this class are those displayed when students have adequate time, not those testable in a 3-hour time slot.  The final report for the quarter, which is a culmination of several intermediate assignments, will be due at the final exam time.  Although the report itself only carries between 10% and 20% of the total grade, previous assignments that lead to the report make the total weight of the project closer to 50% of the grade.

The poster presentation session may be held during the final exam time slot, though it is clearly not a final exam.

7. Please describe the learning objectives that you would ascribe to this course: What do you expect the student to be able to do or understand that would not have been expected of them before taking the class? How do these outcomes support the larger goals of the program(s) in which the course is embedded? (Example: the learning outcome of ability to do comparative analysis of a Western and non-Western text support the Literature objective of cross-cultural inquiry.)

After finishing this course, students should be able to write comprehensible technical reports on biomolecular engineering topics, produce research posters, and prepare and give oral presentations with visual aids on technical topics.

8. List other UCSC courses covering similar material (if any) and how the proposed course differs from these existing courses.

The course is very similar to Computer Engineering 185, Technical Writing for Computer Engineers, after which it is modeled.  The main differences are in the background of the students and in the topics the students are expected to write about.  The biomolecular engineering class assumes more biology background and less programming background.  The “lab protocol” assignment, for example, is highly typical of the sort of writing biomolecular engineers may do in industry, but is not at all similar to what computer engineers write (user documentation and in-program documentation).

A major reason for creating this course is that CMPE 185 has reached capacity, and more variants of it are needed for different engineering majors.  This course is an attempt to provide that variant for biomolecular engineers, as they are the students currently required to take CMPE 185 who fit the course least well.

9. List expected resource requirements including course support and specialized facilities or equipment for divisional review. (This information must also be reported to the scheduling office each quarter the course is offered.)

No special facilities are needed for this course, but it needs a high instructor-to-student ratio, in order to provide the extensive feedback necessary for a writing class with large weekly assignments.  No more than 20 students per instructor or TA is feasible.

Poster printing (through Baskin Engineering Lab Services) will be needed, and the department is willing to pay for poster printing at the current rates (but not rush fees, which will be the student responsibility).

10. If applicable, justify any pre-requisites, co-requisites, or enrollment restrictions proposed for this course.  For pre-requisites or co-requisites sponsored by other departments/programs, please provide evidence of consultation.

Students must have already completed the C1 and C2 writing courses, so that the instructor can focus on discipline-specific writing requirements and not have to spend much time on the basics of writing.

Students must have completed enough biology or biotech courses to be able to read and write technical reports on biomolecular engineering. In order to write lab protocols, students need to have followed molecular biology protocols themselves, which they encounter in BIOL 101L (or the discontinued older equivalents BIOL 100K or BME 150L).

BIOL 101L is already a required course for the biomolecular engineering concentration of the bioengineering BS degree, so including it as a prerequisite does not increase the demand for the course.

One possible problem is that the prerequisite chain to BIOL 101L is already very long, and adding the whole prerequisite chain before BME 185 and having BME 123T require CMPE 185 or BME 185 as prereq may constrain when students can take BME 185 too tightly. Offering BME 185 multiple times a year (Fall, Winter, Summer, for example) would alleviate this problem, if we can afford that many sections.  Some students who have molecular biology lab experience before transferring to UCSC or from individual research may be able to take BME 185 without BME 101L.

11. Proposals for new or revised Disciplinary Communication courses will be considered within the context of the approved DC plan for the relevant major(s).  If applicable, please complete and submit: the Disciplinary Communication Statement Form—new proposals (Word or PDF) or Disciplinary Communication—revisions to approved plans (Word or
PDF)

The current DC requirement for bioengineering centers on CMPE 185, Technical Writing for Computer Engineers, with more communication practice in the capstone requirement.

This new course is intended to be a compatible substitute for CMPE 185 for bioengineers, specifically tailored for the biomolecular concentration (for whom the current CMPE 185 is not as good a fit).

The revision to the current plan is trivial:  everywhere that CMPE 185 is mentioned, the new plan will say “CMPE 185 or BME 185”.

12. If you are requesting a GE designation for the proposed course, please justify your request by answering the questions listed in the attached guidelines. Please make reference to specific elements in the course or syllabus when answering these questions.

No designation other than DC is sought.

« Previous PageNext Page »

%d bloggers like this: