Adobe FrameMaker

Get new posts delivered straight to your inbox.

Subscriber count: 4,300

Stitcher radio

Adobe FrameMaker

When can I say "janky" in my on-screen text?

Jul 18, 2008 • general

In the on-screen text in WordPress, on the Write > Page screen, I ran across the following help text.

When you can use the word Janky in your documentation?

Just yesterday my colleague Ben was asking how I felt about the use of contractions in help. Contractions? We've moved far beyond contractions. We're now using terms like janky.

How I would love to publicly insult the applications I document! E.g., Hey, we know this feature is kludgey, but we couldn't find an easy fix. Hang on -- the next release will get better.

follow us in feedly


Get new posts delivered straight to your inbox.

Subscriber count: 4,300

About Tom Johnson

Tom Johnson

I'm a technical writer based in the California San Francisco Bay area. Topics I write about on this blog include the following technical communication topics: Swagger, agile, trends, learning, plain language, quick reference guides, tech comm careers, and certificate programs. I'm interested in information design, API documentation, visual communication, information architecture and findability, and more. If you're a professional or aspiring technical writer, be sure to subscribe to email updates using the form above. You can learn more about me here. You can also contact me with questions.