Book Report: Draft № 4
John McPhee, a great writer, writes about writing instead of about rocks or oranges or what-have-you. It turns out that behind-the-scenes at "The New Yorker" is less interesting than rocks and orange...
Permalink
If you like puzzles and/or beer & are free this Tuesday evening, maybe you want to do Puzzled Pint. In a bold departure from making puzzles about the # typographic symbol, I drafted some puzzles ...
Permalink
Book Report: My Dateless Diary
It's a memoir/travelog: An author from India travels in the USA in the 1950s. Although at the time he liked America, with some hindsight, this book reminds us that "the good old days" were not so goo...
Permalink
Book Report: The Checklist Manifesto
We humans are inordinately proud that we're somewhat cleverer than lizards. The good news is that we can do some complex things. The bad news is that we think we're really great at handling that comp...
Permalink
Jotting Notes on Sara Thacher's ADG Talk
She designs experiences. She worked on the Games of Nonchalance, Futurecoast; nowadays she can't tell us about her exciting work in Disney Imagineering. Barthe's Death of the Author: just because yo...
Permalink
Link: Documentation, Support, and Customer Success
Anything worth documenting is worth documenting well. But not everything is worth documenting. And I think this guy would agree with me: Recently I’ve started to see documentation as a psychologic...
Permalink
Link: "The Best API Documentation"
A blogger blogs about goals for API Documentation. He starts with the important two questions: Who is the audience? What are they trying to do? …though he doesn't phrase it that way. ...
Permalink
Book Report: A Creator's Guide to Transmedia Storytelling
There are plenty of storytellers out there, but they tend to specialize. Meanwhile, these transmedia projects keep popping up: some story-pieces embedded in movies, comics, ARGs, radio plays… ...
Permalink
FAQs, Facts, Drowning in Questions
You're a small team of software developers. You make a service|API|tool|thingy used by many, many software developers. They have questions, so many questions. You're drowning in questions. How can yo...
Permalink
Book Report: Shady Characters
Thursday afternoon, talk at work turned to punctuation. Since work uses a lot of @s and #s, this should not surprise you. Someone hazily remembered that Shakespeare had invented “modern quotati...
Permalink
Book Report: Confluence, Tech Comm, Chocolate
I'm a technical writer. I understand that folks don't always appreciate technical documentation. Sometimes the docs are bad. Sometimes the docs are good…at bearing bad tidings. Tech writer Roz...
Permalink
Book Report: The Art of Explanation
I'm a tech writer. "Professional Ignoramus" would be a more accurate job title, albeit not so likely to land me fun jobs working with clever software developers. Still, it's what I do. Here's what ha...
Permalink
Link: Audience and Technical Writing
E Nashif took some time off from studying to riff about Audience in technical writing. Audience, composition classes, and technical writing Audience, technical writing, ownership, etc (part 2?) O...
Permalink
Link: Drawing versus Writing Pencils
If you doubted my sharp-pencils-aren't-so-great rant, check this out: Drawing versus Writing Pencils. Focus on the user; the ideal pencil sharpness follows the user's intent. ...
Permalink
not exemplary
I laughed at @sec_reactions so much that I decided to make a Tech Writing Reactions tumblr. But then I realized that would take effort, so instead I just captioned one Star Trek photo. ...
Permalink
Book Report: How to Sharpen Pencils
I'm a technical writer. I write instructions. I often team up with a "Subject Matter Expert," someone who's really good at doing something. I ask them what they do and they write it down. You might w...
Permalink
Scala, part of the new gig
Bumped into @kberg and @adamsah yestere'en. We talked about work. They said interesting things which I won't repeat because oh man what if one of them accidentally let slip some confidential informat...
Permalink
Presentation: Tech Writing for non-Tech Writers
I'm a rara avis at Twitter, the only full-time technical writer. As such, my life is that of a celebrity: I'm constantly being invited to events, everybody wants to be seen with me, etc etc. At least...
Permalink
@ikai pointed out an unintentionally funny article The Real Reason Silicon Valley Coders Write Bad Software. The reason? Because they aren't better English writers. This article made it into the Atla...
Permalink
Twitter is Hiring a Tech Writer
...or maybe more than one. I dunno, @JoinTheFlock is mysterious to me. I didn't even know the listing was up until someone told me. Am I under a non-solicit thingy with you? I.e., do you work at Goo...
Permalink
From the list of recent edits to Scala School, a tutorial for the Scala programming language, you might guess that puzzle nerds were trying to sneak in some easter eggs: You'd see a bunch of changes ...
Permalink
Link: Your free software website
I am a technical writer. Within technical writing, as with other kinds of writing, there are genres. Genres are defined by rules. If you want to write the web page for an open-source project, these a...
Permalink
Puzzle Hunts are Everywhere
Is [some of] your team hoping to head to Portland for The WarTron Game? If so, I'd like to tag along as an "embedded reporter". I.e., I'd play the game with y'all and write it up afterwards. Folks ar...
Permalink
Puzzle Hunts are Everywhere, and worth documenting if you ship them to Seattle or something
I'm catching up (caught up now) on Snoutcasts, and just listened to the BANG 28 Debrief. You might wonder: what information was in the BANG 28 puzzle playbook? Folks kept raving about it (and about t...
Permalink
As a professional technical writer, I am always on the look-out for documentation "success stories." Documentation, when done right, can improve lives. For example, this evening on the bus ride home...
Permalink
Book Report: The Art of Game Design
The Art of Game Design is pretty awesome. This book is about design. In theory, it's about game design. But if you're designing something for humans, this book contains plenty of wisdom. I think thi...
Permalink
Link: MobNotate
The next time someone wants me to mark up their manuscript, I might suggest they use MobNotate to gather feedback. ...
Permalink
Technical Writing Student Internships
Google is taking technical writing interns this summer. Yeah, everyone at Google's a genius and should never ever need anything explained to them. OMG especially not by some wet-behind-the-ears compu...
Permalink
If you recently guessed SCOUT VAILLANCOURT FOUNTAIN in the 2-Tone Game, try entering SCOUT again. I tried to clarify the wording a bit. If you didn't guess SCOUT VAILLANCOURT FOUNTAIN, then carry on...
Permalink
"What is a Content Management System?"
At the GC Summit, Debbie mentioned that the organizers of the excellent DASH treasure hunt game will start using a content management system to keep track of their puzzles. Someone in the audience a...
Permalink
