This is Not Tech Writing

Tech writing fails: print, web, and design products that should have stuck with Lorem Ipsum.

I agree that fiction writing and tech writing necessitate different skill sets.
However, I think it’s also important to remember that we tech writers are human. We are beset by similar psychological roadblocks as our “creative” brothers.
Shit writing is shit writing. 
Also, anyone who tells you tech writing isn’t creative is incorrect, and also an asshole. And let’s face it, most of us dabble in various side-projects in order to soothe the ravenous beast that dwells within—
I want to CREATE, motherfuckers.
-Julia out
nevver:

 Six Tips on Writing from John Steinbeck
Abandon the idea that you are ever going to finish. Lose track of the 400 pages and write just one page for each day, it helps. Then when it gets finished, you are always surprised.
Write freely and as rapidly as possible and throw the whole thing on paper. Never correct or rewrite until the whole thing is down. Rewrite in process is usually found to be an excuse for not going on. It also interferes with flow and rhythm which can only come from a kind of unconscious association with the material.
Forget your generalized audience. In the first place, the nameless, faceless audience will scare you to death and in the second place, unlike the theater, it doesn’t exist. In writing, your audience is one single reader. I have found that sometimes it helps to pick out one person—a real person you know, or an imagined person and write to that one.
If a scene or a section gets the better of you and you still think you want it—bypass it and go on. When you have finished the whole you can come back to it and then you may find that the reason it gave trouble is because it didn’t belong there.
Beware of a scene that becomes too dear to you, dearer than the rest. It will usually be found that it is out of drawing.
If you are using dialogue—say it aloud as you write it. Only then will it have the sound of speech.

I agree that fiction writing and tech writing necessitate different skill sets.

However, I think it’s also important to remember that we tech writers are human. We are beset by similar psychological roadblocks as our “creative” brothers.

Shit writing is shit writing.

Also, anyone who tells you tech writing isn’t creative is incorrect, and also an asshole. And let’s face it, most of us dabble in various side-projects in order to soothe the ravenous beast that dwells within—

I want to CREATE, motherfuckers.

-Julia out

nevver:

Six Tips on Writing from John Steinbeck

  1. Abandon the idea that you are ever going to finish. Lose track of the 400 pages and write just one page for each day, it helps. Then when it gets finished, you are always surprised.
  2. Write freely and as rapidly as possible and throw the whole thing on paper. Never correct or rewrite until the whole thing is down. Rewrite in process is usually found to be an excuse for not going on. It also interferes with flow and rhythm which can only come from a kind of unconscious association with the material.
  3. Forget your generalized audience. In the first place, the nameless, faceless audience will scare you to death and in the second place, unlike the theater, it doesn’t exist. In writing, your audience is one single reader. I have found that sometimes it helps to pick out one person—a real person you know, or an imagined person and write to that one.
  4. If a scene or a section gets the better of you and you still think you want it—bypass it and go on. When you have finished the whole you can come back to it and then you may find that the reason it gave trouble is because it didn’t belong there.
  5. Beware of a scene that becomes too dear to you, dearer than the rest. It will usually be found that it is out of drawing.
  6. If you are using dialogue—say it aloud as you write it. Only then will it have the sound of speech.

The Grammar Nazi Tumblr

I was alerted to their presense earlier and for some insane reason didn’t:

a) give them props

b) marry them immediately

-Julia out

techwriterninja:

I love it, for reasons.

They don’t have an “ask” form, so I just have to sing their praises to the Tumblrverse.

(Source: techwriterninja)

I remixed the original, which is here : http://stepsoversnails.tumblr.com/post/9075348835

I remixed the original, which is here : http://stepsoversnails.tumblr.com/post/9075348835

Writing is like prostitution: First you do it for the love of it, then you
do it for a few friends, and finally you do it for money.
F. Molnar

The Trouble with Definitions

(Conversation had while looking at Halloween pictures)

Julia: Wait. I don’t understand what this guy is supposed to be…

Mike: He’s the internet.

Julia:….

Mike: Because he’s a series of tubes.

Julia: HWHAT! THAT’S THE GREATEST COSTUME OF ALL TIME!

If you work in Technical Communication, you know that quickly, yet accurately, defining a complex idea is always a battle. The “internet” is rather infamous for this. Sit down with a pen and try to explain what the internet is in three sentences.

Yeah. Hard, right? Do you mention the physical aspects? HTML? The various ways it can be used as a communication tool? Do you talk about when it first “appeared”? And how do you determine that date? Do you say it’s used by computers? What about cellphones? Is my cellphone by default a computer because it accesses the internet?

The “series of tubes” reference is a rather well-known joke. It’s a good joke. It’s a great costume.

In related news, here’s the definition of the internet that I found at work, dated 2004:

 

Let’s go through this bad boy:

          Why italicise and underline the title? Do you double wrap your dick as well?

          Capitalization of “Internet”, “Web site”: Is it 1386? Are you Father of English literature Geoffrey Chaucer? No? Then un-caps that noise.

          “…is a communications tool….”: Why is “communications” pluralized? Was the internet invented by the field of Communications? Perhaps it is just a communication tool?

          “…composed of computers connected to each other in a world-wide network”: It would have been simpler to say “A world-wide network of connected computers.” Also, while using “composed” isn’t totally incorrect, it’s pretty dumb.

          “It is a vehicle by which information is made available to a mass public.”: What? How large a mass? How do you define the single unit of “public”? And everyone has the internet? Also, “made available” makes it seem like it is never manipulated. It’s just “there”. And while again, “vehicle by which” isn’t wrong in terms of definition, it’s clunky and insane. Does my internet come with brake pads? Must I be in motion to access my email?

        “…hosts its own Web site…”: So, in the binder marked “Internet Publishing Standards and Procedures”, it was necessary to point out that the organization has a website and the location of that website? No. No it was not.  

- Julia Out

Technical writers are trained to reveal almost nothing about themselves in
their writings. This makes them freaks in the world of writers….
— Kurt Vonnegut