I'd Rather Be Writing » BYU-Idaho

Technical Writing Is More Than “Click This, Select That” [Podcast]

Tom Johnson — Fri, 22 Oct 2010 05:18:14 +0000

This is a presentation I gave at BYU Idaho last week to students interested in entering professional writing. For the accompanying slides, see this post. For the overall question I was trying to tackle, see Students Contemplate Whether a Technical Writing Career Will Be Fulfilling.

Blog Sponsors

Technical Communication Careers: Getting Started and Finding Your Niche (BYU Idaho Presentation)

Tom Johnson — Wed, 13 Oct 2010 08:40:53 +0000

Tomorrow I’m driving up to BYU Idaho to give a presentation titled “Technical Communication Careers: Getting Started and Finding Your Niche.” It’s part of their annual Pre-Professional Writing Conference for English and professional writing students. I like to go because I have an old colleague up there who teaches English (we spent 2 years in Egypt teaching at The American University in Cairo), and it’s always fun to visit with him.

Below are the “slides” for my presentation. I’m using WordPress rather than PowerPoint. You can actually click through the images just like you can with PowerPoint (once you are viewing the image details, click the image itself to move to the next one in the gallery). If you have any feedback about anything, let me know. I created these illustrations in Adobe Illustrator. I was actually going to insert them into PowerPoint, but I realized that when you view the PowerPoint show, it resizes the images and makes them a little blurry. Plus I’m weary of PowerPoint anyway and wanted to try something new.

Note: Several people have asked if they can use some of these images for their own slide presentations. Sure, feel free to do that. You can link back to my site with attribution if you want, but it’s not required.

Blog Sponsors

Students Contemplate Whether a Technical Writing Career Will Be Fulfilling

Tom Johnson — Thu, 30 Sep 2010 14:41:47 +0000

For the past couple of years in October, I’ve gone up to Brigham Young University Idaho to talk to students at their professional writing conference. I’m going up there again this year. In preparation, I asked my colleague who teaches there whether students still think of technical writing as a sellout/fallback career, or whether they’re more seriously preparing for an actual career in technical writing. My colleague responded:

They’ve chosen professional writing as a career because doing so is prudent (or at least more prudent than choosing creative writing or college teaching). They may wonder, however, whether they can really be happy in a career as a technical writer. The professional world is a bit of a mystery to them, and they wonder whether they’ll really end up content as professional writers. They sort of feel that they’ll never know this until they try it, but that after they try it, it’ll be too late to go back and do something else. There’s a sense of entering a career path sort of half blind. Anything you could do to answer whether they could really be happy in a career as a tech writer would help them out a lot.

I’m at a loss for how to respond to this student dilemma. How do you know whether technical writing is the right career path for you? I’m really hoping you can shed some light as to how I could help students resolve this dilemma.

A student contemplates whether a career in technical writing will lead to a fulfilled/content professional career

In previous collaborative posts, I created a Google doc to collect the responses, but in the last collaborative post, most people just added comments below the post itself. The latter method seems more practical. I appreciate any insights you may have.

Blog Sponsors

Theme Parks and External and Internal Input

Tom Johnson — Fri, 06 Nov 2009 05:41:05 +0000

This week I’ve been on vacation in Florida, visiting my family and touring the theme parks — Seaworld, Disneyworld, and (soon) Busch Gardens. I used to live in Florida and would go to Busch Gardens all the time. But this week is more extreme. Our first day at Seaworld, I realized my theme park endurance was poor. The next day at Disney was much better, even with just 6 hours of sleep the night before. The second time around Seaworld (of course one day wasn’t enough) was like stopping off for a brief jaunt at the mall, except when we temporarily lost our daughter, which sent us on a roller coaster of emotions.

While walking around theme parks, I’ve been thinking about a talk Nicole Mazzarella, author of This Heavy Silence, gave last month at the BYU-I writing conference. Talking to a group of would-be writers, Nicole explained the need to “live in the moment.” She talked about the need to disconnect from whatever media is taking you away from the moment you’re in — Twitter, Facebook, email, IM — and to focus on the moment you’re in. This ability to be in the moment is as critical to writing as other time-worn advice, such as reading or reflecting.

I wasn’t quite sure what to do with that advice. But now I’m starting to understand.

Theme parks floor you with mesmerizing shows, constant music, visual stimuli, greasy food, stomach-losing rides, character-filled stories, and an overall constant stream of external input. The more external input that comes in, the less internal input you need to generate. When I’m flooded with external input, I seem to lose touch with my own thoughts and direction. In this way, theme parks are like TV, a continual escape where no internal input of my own is needed. I just follow the map, hold onto my kids, and move from show to ride to food kiosk to exhibit to show to ride until the day finishes, and then I drive home and collapse from exhaustion.

When I’m not at a theme park, when I’m living my regular life, immersed in the moments of silence so typical of writing and a quiet family life, I often feel a tendency to turn on sports, the radio, Google Talk for email or IM, Twitter, and start any other form of external input I can find.

But that external input takes me away from the moment. It disrupts my attention on what I should be doing or thinking about. Perhaps there’s more to the moment that I’m missing when I fail to focus. This isn’t a single task versus multi-task discussion, or an argument about how each disruption requires 20 minutes of downtime to refocus. I’m saying that when I put myself in situations of extreme external input, like a theme park, the amount of internally generated input is minimized. With minimal internal input, my creativity sinks, and my muse goes mute.

But this is a balancing act, because external input is often the stimuli that generates internal reflection and analysis. I’m still putting together my thoughts on internal and external input. For now, I’m starting to be acutely aware of the difference. Can you help clarify what I’m trying to say?

Blog Sponsors

Podcast: Debunking the Boredom Myth of Technical Writing

Tom Johnson — Mon, 03 Nov 2008 13:42:59 +0000

Download MP3 (to download, right-click and select Save Target As)
Duration: 55 min.

Several weeks ago I wrote about my trip to Brigham Young University-Idaho and the presentation I gave there titled “Debunking the Boredom Myth of Technical Writing.” This podcast is a recording of my presentation.

My presentation was part of the professional writing conference that BYU-Idaho puts on annually for their writing and literature students. In the presentation, I talk about a prevalent myth that many students have — that technical writing is a boring career. To combat the myth, I explore the variety of content technical writers produce, including video, diagrams and illustrations, quick reference material, wikis, online help, information architecture, blogs, wikis, podcasts, and usability.

You can view my accompanying PowerPoint presentation here. Additionally, links to the three videos I played are below:

Becoming a Writer — Reflections on a Trip to Idaho

Tom Johnson — Mon, 13 Oct 2008 22:20:09 +0000

The Boredom Myth: Unlike what a tech comm professor taught me, tech writing is more than just formatting the layout of phone books.

Last week I drove up at Rexburg, Idaho to give a presentation on technical writing to the English majors at Brigham Young University Idaho (BYU-I) as part of their annual Pre-Professional Writing Conference. Most of the students in the group intend to pursue a literary career, such as writing books, editing manuscripts in publishing houses, or teaching literature in college or high school.

I was scheduled to present on technical writing, but my presentation felt more than that to me. I felt a mission to correct what had been falsely taught to me as a college student and which caused me to wander around for five years of my professional life trying to figure things out. Let me explain.

When I was a student at BYU Provo, I took an English survey course (typical of most English major curriculums). When the technical writing professor spoke to us (right after the cowboy literature professor, the feminist literature professor, and the postmodern deconstructionist professor), she explained that one task technical writers might do is format phone books. She then showed pictures of phone book layouts and mentioned font.

As I sat there, a young ideal-minded, writing-bound student, I took a personal vow to never become her. To never end up so boring, so undriven. Ending up in a little office, formatting phone books all day would be the equivalent of literary death. I eternally struck the possibility of technical writing from my career’s vocabulary. Never, never, never would I become a technical writer.

After I graduated from BYU with a degree in English, I didn’t know what to do, so I earned an MFA in literary nonfiction from Columbia in New York. All through my MFA, I felt anxiety about the career path I would follow. My wife gave birth to our first child at the time, and the cost of living in New York maxed out our income each month.

When I did graduate, I found a composition teaching job abroad at The American University in Cairo and spent the next two years in Egypt. After two years, I realized that my composition teaching career was going nowhere. I also realized I hated teaching — a fact not often considered by prospective literature students who simply plan on teaching without ever having taught.

Above all, I despised grading student papers, justifying over and over the B and C grades. At one point I dropped my grading pen and noted that reading student essays was not only laborious, it was also damaging to my own sense of writing. I wanted to write, not teach. So I left composition teaching and moved back to the U.S.

With a BA in English, an MFA in literary nonfiction, and two years of full-time teaching experience, I wasn’t marketable for any high-paying career. Through a friend of my sister, I landed a job as a copywriter for a Scientologist-heavy health and nutrition company in Clearwater, Florida, whose main product was a bottle of protein pills for triathletes. Earning 32k a year, without benefits, I wrote marketing copy for the company, exhausting my creative energy with press releases, web copy, product fliers, brochures, newsletter articles, email campaigns, and anything else I could write to promote and sell more BioBuild.

After six months, the $9,000 of savings I’d built up in Egypt steadily declined. One night I sat down to calculate my financial standings and realized I needed a higher paying job if I was to survive. At that point I remembered what a colleague in Egypt once told me, that I would be a perfect fit for technical writing. So I began my search for an entry-level job as a technical writer.

Thanks to some articulate copy I wrote about how protein works, a hiring manager at a financial company in Florida (who had a PhD in biology) saw potential in me, and together with a sample help file I wrote in RoboHelp, hired me onto their team. I was their first hire after four years of a freeze from the tech stock crash.

As a technical writer with little experience, I made only $40k a year, and so I soon took a second job teaching writing at ITT-Tech on the weekends. For the next year, I became a careful student of technical writing, mastering RoboHelp, Paint Shop Pro, and other tools; learning methods for procedural writing, memorizing the corporate style guide, and examining other corporate style guides; figuring out how to crack open a SME for information, how to gain access to the right development environments, how to organize chaotic jumbles of information, and finally how to package it all up into an attractive guide.

After working as a technical writer for a time, I found that it indeed was a good fit for me. Not only was I immersed in technology, I also had a knack for clarity and organization with technical material. I was also an expert at the tools, hacking Robohelp’s source files to create a branded skin, and producing large amounts of documentation in a relatively quick timeframe.

Eventually my salary rose enough that I could quit my second job. After about a year, I was promoted to a senior level, which included even more salary increases. I later transitioned to another company that paid better. But more than simply finding a sustainable salary, I felt I finally found my career — the answer to the elusive question about what to do with my writing skills. I’d found the path that I once sat up late at night wondering about while I was an MFA student, and while I was teaching in Egypt. My daily work didn’t involve formatting phone books, and it wasn’t boring at all — at least not as boring as I imagined it could be.

As a result of these experiences, my presentation to BYU Idaho students was more than just a survey of possible technical writing careers. I was dispelling the myth that the BYU tech. comm. professor taught years earlier. Life as a technical writer does not actually consist of dreadfully dull tasks all day. I now had a chance to point students in the right direction before they spent the next five years of their lives wandering in financial frustration, trying to support a family on the notion that they would teach or write a bestseller.

Grammar

To kick off the Pre-Professional conference, Marilyn Arnold, a distinguished writer from BYU-Provo, gave the opening keynote address. Arnold read a lengthy personal essay on what it means to become a writer. I was surprised to see her read her opening address, but her text was well-written, funny, and full of examples. The only problem was that she focused — for the first 20 minutes — entirely on the heightened awareness of grammar that grips writers’ minds. You begin to see every little comma error, every misuse of lay and lie, every misspelling, she said. And you’re tormented by these language errors.

Sure, I’m guilty of the same hyper-grammatical mindset at times. But a writer is much, much more than a grammarian. A writer actively thinks; he or she has a keen sense of analysis and perspective. A writer can communicate with clarity and flair in ways others can’t. A writer can structure content with story.

While correct grammar is important, if it’s your main perspective, you sell yourself short. In the world of technical communication, you mislead others into thinking you can only proofread text on the user interface, rather than improve the overall design. I wanted to raise my hand and say, Is that it? Is grammar expertise all you gain when you become a writer? She eventually did turn the corner into other larger topics, but all I remember about her talk is the emphasis on grammar.

Performance

I had a couple of other experiences that made me think about what it means to be a writer. While eating breakfast among the invited speakers, I sat next to a literature professor from BYU Provo who told me she refrained from blogging because “blogs were performative.”

Of course you hear accusations every now and then that blogging is a navel-gazing, egomaniacal activity. But that’s only true in some cases, for some people. Here the English professor had taken it to another level, comparing blogging to performance art, to people who sit down with the intent of merely inciting discussions on listservs, engaging in attention-getting techniques to direct the focus on to themselves without substance.

Isn’t all writing, I suggested, performative to some degree or another? The minute you write with an audience in mind, you begin to deviate from your normal course of behavior. You begin considering what others will think and how they’ll react. As a result you distort what you might write without that audience.

I tried to make my argument while expressing some understanding of her perspective. But in the end I think her performance contention was merely an excuse for not writing.

Before long, breakfast ended and we all started mingling with others. Personally, I’ve never met an egomaniacal blogger — just people who like to write.

Critical Thinking

My host, Josh Allen, introduced me to at least a dozen colleagues. I later learned that Josh was a lone Democrat in a sea of Republicans. Rexburg, Idaho, it turns out, is a town that is 93% Republican. It makes rooting for Obama, or worse, putting Obama-Biden signs in your front yard, a risky activity that draws an immense amount of attention to yourself.

For the first two years at BYU Idaho, Josh kept silent when political discussions arose. But as the elections approached, he broke out of his shell and volunteered to be the faculty advisor for the college’s Democratic club.

Josh did put Obama-Biden signs in his yard, and on three separate occasions, political vandals took down and shredded the signs. The acts of vandalism inspired him to write a detailed, thought-provoking letter to the local newspaper editor.

I think when politics comes up on campus, Josh sees it as an opportunity to help students think critically about the issues. He exposes logical gaps, points out problems with assumptions, and describes other poor thinking. Teaching students to think critically, so at least they won’t automatically believe or forward senseless political emails, is practically one of Josh’s missions in life.

A critical perspective is certainly at the heart of any writer’s mindset. To think for yourself, to question assumptions, to look at issues from fresh angles and risk voicing a different opinion — surely this is the first step in becoming a writer. This is the substance that the grammarian lacks, or that the performer is searching to possess. And yet, critical thinking alone is insufficient to become a writer. Becoming a writer takes more than merely a questioning mind and a mentality against herds.

Story

The most anticipated speaker at the conference was an Argentinian poet, short-story writer, and novelist named Ana Maria Schua, who’d flown all the way from Argentina and spoke with a heavy Spanish accent. The students packed into the auditorium to listen to Ana Maria Schua speak. She had an endearing laugh that punctuated her speech every once in a while — the kind of laugh that made you laugh when she laughed.

Schua recounted her own journey to becoming a writer. At sixteen, she compiled her first book of poems, but struggled to find a publisher. She won various literary contests, which boosted her confidence. She compiled a book of short stories, which she also struggled to publish (but eventually did).

To write novels, she used existing structures as “cake pans,” into which she inserted her own experiences. She combined different structures, characters, and plots to build Frankenstein-like texts. She had a gift for the language, she said, but had to learn the art of telling stories. Novels were a genre she had to study, but microfictions came naturally to her.

Schua offered plenty of insights into what it takes to become a writer:

The first step in becoming a writer is to immerse yourself in reading. But if you require that advice, you’ll never be a writer.
Every act of writing is a negotiation between what you plan to write and what comes from your fingers.
If inspiration is gone, replace it with perspiration. Writer’s block doesn’t exist in a copywriting agency.
Limitations help you write. Absolute freedom is puzzling.
You need to have a gift to be a writer.
Vanity is a necessary attribute for writing — you have to like what you write.
“Eyes see more than imagination” — Da Vinci. (Refers to the power of borrowing from reality rather than inventing from scratch.)
Not everything you write is good or worth keeping. Selection — the ability to delete — is important.
Bad male novelists write improbable adventure stories; bad female novelists can’t see outside themselves.

Throughout her career, Schua published around 40 books (many were children’s books, she noted). I found her talk motivating. I wanted to go home and immediately start writing stories and sketching out ideas.

Students asked questions for a good 30 minutes after her presentation, and others asked her to sign her books. She was an inspiring example of what each student could be when he or she became a writer. She exemplified the literary life.

My Presentation

I had so much anticipation and energy when I gave my presentation that I spoke for 60 minutes straight without engaging students with any questions. I purposely covered aspects of technical writing that students probably hadn’t considered: video, wikis, illustrations, single-source publishing, blogs, podcasts, screencasts, information architecture, usability, quick reference materials, and the general immersion in words.

I showed surveys on the question of whether technical writing was boring. 89% of students thought it was boring, compared to only 7% of professionals. I played excerpts of podcasts, gave a live demo of single sourcing, showed examples of usability in everyday objects, and showed three entertaining video tutorial clips.

My second session involved 45 minutes of question and answers, during which I carefully answered every student’s question with more articulation than usual. Fifteen more students attended the question and answer session than my 60 minute presentation.

In the end, did hordes of students turn their attention to a new, previously unplanned career in technical writing? Did they drop their desires to spend their careers writing novels or break into Random House as book editors?

Not really. A few students thanked me for my practical advice. One student said he was glad I mentioned that teaching isn’t for everyone. Another said my advice was more practical and useful than the information someone gave the previous year. A faculty member asked me about wikis for one of his class projects, and some others who didn’t attend my presentation nevertheless complimented on it, relaying they’d heard good things about it.

But really, the conference made me reflect on what it means to become a writer. We start out with grand literary ambitions in college. We want to author books that will become classics, or make others rethink the world through our writing. Could technical writing ever fulfill that creative drive to write? To put it more bluntly, if you became a technical writer, could you still feel inside that you had “become a writer”? Or as a technical writer, are you merely using your writing skills?

I think there is room for interpretation in the answer. Writer is a word that has gradations of meaning. In my world, I know I’m a writer, but I’m still longing to become the writer I want to be.

Online Anonymous Rating Sites: Empowering Individual Voices

Tom Johnson — Wed, 07 Nov 2007 05:40:07 +0000

In looking for an apartment, I found ApartmentRatings.com tremendously helpful. This site allows residents to anonymously rate and comment about their apartment complex.

After reading the comments residents wrote about Hunter’s Woods apartments in Murray, I decided that, although the square footage was about 300 more sq. ft than any surrounding apartment, the area’s crime (namely drug dealing) and the poor maintenance responses by the staff were enough to look elsewhere. The overall ratings appear at the top of the site:

And the resident’s responses appear below:

Ratings are also expanding into the academic realm: you can rate your professors. RateMyProfessors.com allows students to provide feedback in a public site. Imagine the power!

For example, my old friend Josh Allen, who teaches at BYU-Idaho, is now online, free to be rated on Google by his students. Luckily, his students like him, so the ratings work in his favor.

Similar to the apartment ratings, you can read the individual students’ feedback in all their detail.

Other rating sites exist too, such as Confabb, which allows you to rate the speakers at the conferences you attend.

These rating sites empower people to make better choices. Obviously they are subject to abuse (either from the competition, from the the slandered source, or from biased friends). But even in the possible exaggerations from the participants, the ratings raise awareness of issues that you might otherwise not carefully examine.

You also have to keep in mind that people rarely take the time to express their satisfaction, but the disgruntled will complain bitterly.

Apartments, professors, conferences …. what’s next?