Dr Karl Stolley

Assistant Professor of Technical Communication, Illinois Institute of Technology

Skip to Navigation

Near the end of an epically long line to get on the train to Lansing.

Today at 3:40PM via Twitter.

Archive for 2009

Of Code and Cooking

I’ve gotten a lot of really kind feedback to a post I wrote for the TechRhet listserv. It was in response to a story Jim Kalmbach told of helping a student move beyond Dreamweaver to achieve something unique with her design. Jim mentioned me, saying

Now I know that out there somewhere Karl Stolley is smiling to himself thinking “If you only used notepad to begin with, she would have known the answer,” and in my head, I am responding equally as snippily saying “If I had used notepad, she would have dropped the class long before she could ask the question.”

So of course I had to respond to Jim. And here is my response:

I very much enjoyed your story, and thanks for thinking of me, Jim. I’d like to be a bit more hospitable and generous in my response than I was in your head, so let me give that a try:

(First off, I’d have dropped, too, if Notepad were the tech–Dreamweaver’s code view, or FOSS tools like Notepad++ (http://notepad-plus.sourceforge.net/) for Windows or Text Wrangler (http://www.barebones.com/products/TextWrangler/) for Mac are better options, simply because they highlight the syntax of XHTML, CSS, and
so on–but also because Notepad chokes on utf-8. But that’s sort of beside the point.)

What I do think is that Bill Hart-Davidson’s work on objects & views vis-a-vis the Web is instructive here. As both writers and readers, we’ve been conditioned to work with a singular view of digital writing–Word has basically one view of a document (OK, and a print view, but it’s basically the same diff as “Normal”); the same can be said of Flash, Premiere, and a whole host of programs.

In other words, in most cases, the author’s composing environment and the reader’s viewing environment are essentially the same. In most cases.

What makes the Web unique, though, is that there are so many different views: different browsers on different operating systems, mobile devices, adaptive technologies–not the mention the ability of some sites, like Facebook and Delicious, to read and re-render particular views of sites through their various share/bookmark functions. Add in available system fonts, internet connection speeds, screen size, resolution, and the number of variations on a view of a Web page quickly spirals beyond any one program’s ability to represent even a fraction of the possible views.

Dreamweaver, particularly in its WYSIWYG mode, encourages authoring in a particular view, one that is basically (but not completely) like a full-on graphical desktop browser. One that is basically like Word or most other digital writing environments. Thus Dreamweaver’s popularity.

And of course, for a lot of people, Dreamweaver’s graphical view is more than adequate to put together a basic web page….just as the dizzying variety of brownie and cake mixes in your local supermarket is more than enough for most people to make baked goods to feed their families and friends.

But the cake mix, like Dreaweaver’s WYSIWYG, is just one view–a limited view–of the cake object. Add oil and an egg, mix, and bake in the oven, basically. Throw some frosting on, if you’d like.

It’s a cake, yes, but aside from knowing how/that one has to measure and add oil and egg, one’s cake literacy is limited by that view. Frosting adds a layer of customization to the cake, but frosting decorates as much as it obscures.

I’m going somewhere with this. I’ve recently been fascinated by a cookbook called Ratio: The Simple Codes Behind the Craft of Everyday Cooking (Michael Ruhlman, Simon & Schuster, 2009). And his cookbook is unlike others that share shelf space at your local bookstore, in that it Ratio is not recipe-oriented, but ingredient- and process-oriented.

For example, rather than just tossing out a cake recipe, Ruhlman shows the ratios of different cakes’ ingredients, e.g.,

Pound Cake:
1 part butter : 1 part sugar : 1 part egg : 1 flour
Sponge Cake:
1 part egg : 1 part sugar : 1 part flour : 1 part butter
Angel Food:
3 parts egg white : 3 parts sugar : 1 part flour

Change up the types of eggs, the kinds of sugar, the type of fat or flour all you’d like. Add additional things to make chocolate, lemon, cinnamon cakes: the underlying ratios hold up. They guide.

What’s also interesting to note is how these ratios relate to one another: sponge and pound cake have the same ratios, but it is a matter of the order of mixing that results in pound rather than sponge; angel food eliminates egg yolks and fat, but has a much higher egg-sugar to flour ratio.

As an exercise, ask students sometime to describe the difference between a Word document, a PDF, and a web page. They often mention software, but are basically unable to express–rhetorically–why one might choose one format over another. (Which is why, I think, we see websites that are a pastiche of Word, PDF, and HTML files.) They are usually as incapable of describing these differences, in other words,
as most recipe-following bakers are at describing the difference between biscuit dough and pie-crust dough.

But what is more interesting and, I promise, to the point of this whole email is that, working from these ratios, a whole universe opens up in terms of baking and cooking, one that is not bound by the recipe (let alone the cake mix), but rather by the underlying *view* of cooking and baking as described by the ratios.

It’s a rhetorical form of cooking: contextualized to diet, personal preference, not to mention the ingredients one might have on hand in ways that recipes or boxed mixes are not.

But–and this is a significant ‘but’–we all have to start from somewhere. I cut my web-design teeth on WYSIWYGs, and it was only after their limitations in representing views of an object (particularly PHP- and MySQL- driven pages, e.g., what you’d confront working with WordPress templates) became too much to try and work around that I gradually, and with more mistakes than you can imagine,
moved into straight-up code-level development.

And that’s perhaps a way in to talk about your experience with your student last night: you *can* use Dreamweaver to make Web pages. Obviously. (Just as you can rely on a Pillsbury brownie mix to make brownies. Obviously.)

The question is not, a la the Code Wars we have on this list from time to time, whether Dreamweaver is better or worse than code, or capable or incapable of supporting the creation of web pages.

Instead, for me the question becomes, what are the literacies that are or aren’t being exposed, interrogated, and developed when one view is favored, or even exclusively used, over another? (Students in my classes write their source by hand, it’s true–but also with a browser or two handy to constantly verify the browser view as they work.)

Put another way, what are the rhetorical, versus the merely technical, benefits of these moments when it’s not a simple matter of Dreamweaver v. Code, but Realizing a Rhetorical Aim v. NOT Realizing a Rhetorical Aim?

2 comments.

The #missouri #compromise

Like Jan Fernheimer and Kathie Gossett, I’m encouraging (though not requiring) students to use Twitter as part of an approach to involvement with beyond-the-classroom discourse communities.

So I was crowing last week, on Twitter of course, that rather than have a course-specific hashtag for my grad seminars, we would use hashtags already in use on Twitter already: #techcomm for the Key Concepts in Technical Communication course and #km for the Knowledge Management one.

And I’m still moving forward with that plan, largely to take advantage of the broader discussions of both areas on Twitter. But then I realized that a course-specific hashtag would be useful for course-related or course-specific posts, while the other hashtag would be important for things related to the broader tech comm and knowledge management Tweetstream on Twitter.

Not to mention that neither my students nor I want to pollute the Tweetstreams for #km and #techcomm with things that only have relevance to our mundane business in the course.

So there it is, care of the OR boolean operator on the Twitter search feed: Key Concepts will aggregate #techcomm and (…actually OR…) #com521, and Knowledge Management will aggregate #km and #com542.

Write the first comment.

Save Your Tweets from Computers and Writing 2009

A number of people have expressed interest in having a collection of everything that was Tweeted at Computers and Writing 2009 with the #cw09 hashtag. However, because there were more than 1500 Tweets from the conference (!), it is not possible for any one person to archive all of the Tweets.

If we are going to have such an archive, it will take a community effort. And fast–we have less than a day or two to do this.

First, here’s what you should do (I’ll explain why next): go to your favorite, feed-enabled Web browser and enter this URL, replacing USERNAME with your Twitter username and PAGE with a number starting with 1 and increasing it by one until you no longer have any results left:

http://search.twitter.com/search.atom?q=%23cw09&rpp=100&from=USERNAME&page=PAGE

Each time you run this query, right-click and choose View Page Source; in a good browser, you will see the raw XML (and not the styled HTML page that browsers like Safari and Firefox generate for RSS). Your ATOM/RSS will look something like this (my most recent 100 #cw09 tweets).

Copy that entire chunk of source by right-clicking and choosing Select All, and paste it into a good text editor: either WordPad on Windows (*not* Notepad) or TextEdit on Mac. (In TextEdit, choose Format > Make Plain Text if it’s trying to save as RTF.)

Save the file as like username-cw09-page-1.rss.txt for the first page, username-cw09-page-2.rss.txt for the second page, and so on. Because of the way XML works, do not paste all of your results into a single file; keep a separate file for each time you up the page number in the URL.

We’ll have to figure out as a community where to share and post these files, and how to (eventually) get them into a searchable, sharable database as an SQL file. But for now, just be sure to grab your Tweets, save them, and keep them safe.

The reason this is necessary is that Twitter will only return 1500 results for a given search (like #cw09), and it will only return results that are less than roughly a week old. So that’s why we have to do this individually, and do it fast. After sometime on Thursday of this week, the Tweets from during the conference will rapidly begin to disappear from the searchable Tweet stream.

4 comments.

Testing the iPhone WordPress app after upgrading to 2.8

Write the first comment.

Reading the Tweetstream

I was fascinated by the #CNNfail Tweetstream Sunday night. The “Tweetstream” is nothing more than the realtime updates to a search for a particular word or phrase on Twitter at search.twitter.com. but when I posted about it to Facebook from Twitter via Selective Twitter Updates, some of my non-tweeting friends reported being unable to decipher what one of them described as Twitter’s “jargon.”

Well, the Tweetstream is not really plagued by what I would call jargon. Rather, Twitter users have developed their own shorthand for communicating within Twitter’s hallmark 140-character post limit. (And it is important to note that the conventions I’m listing here have emerged from the community’s broader rhetorical practice, and not as features designed by Twitter the website/service itself.)

Here’s a tweet, or actually a retweet, of mine roughly as it would have appeared in the #CNNfail Tweetstream:

karlstolley RT @timleberecht: How #CNN fail(ed) – screenshots from news sites worldwide http://bit.ly/bqgHN #iranelection #cnnfail #fb

  • So, the first item that appears is the username of the person who’s doing the tweeting; no big mystery there.
  • Next up is RT, or “retweet,” which is a sort of citation mechanism in Twitter that, among other things, cause tweets to be passed on beyond one’s own immediate group of followers.
  • @username, which is the syntax for both referring to and directing messages publicly to another Twitter user, based on her username. In the Tweet above, I’m retweeting a tweet written by @timlebrecht, whose Tweet was just one that I spotted in the Tweetstream.
  • Tim also uses a hashtag, #CNN, in the body of his post; hashtags are another Twitter convention and can be used on words in the message (as #CNN is) or at the end (or even the beginning) of a post, as #iranelection and #cnnfail are. I also added the #fb hashtag so that this particular Tweet would update my Facebook status, as is the convention with the Selective Twitter Updates app.
  • http://bit.ly/bqgHN, which is the URL that Tim was pointing to; bit.ly is a URL shortening service, like is.gd and tinyurl.com, which keep the URLs short (but which also have problems of their own in terms of long-term viability/accuracy).

Which is all just to say that RT, @username, and #hashtags are nothing more than metadata about the actual content of the post. True, they are visually noisy to newcomers, but such is the nature of new forms of digital expression.

But obviously, even with this explanatory list in mind, there is no shortage of noise on the Tweetstream. My own experience reading it, especially on a stream that was moving as fast as #CNNfail was Sunday night, is that the colorization brought on by hyperlinked hashtags and usernames helps me visually sort through to what I want to read: too many usernames, as in a string of retweets, or too many hashtags lumped at the beginning or end of a tweet, and I’m not likely to read carefully. I’ll look for the black text of tweets that will likely be more informational and, with luck, something that hasn’t been tweeted already.

Write the first comment.