Step One in Component Content: Common Modules

Step One in Component Content: Common Modules

Debra W Kahn (@debrawk.bsky.social)

No one likes to reinvent the wheel. And in the era of AI, none of us like to create content when we can leverage something that’s already out there. (Copyrights respected, of course.)

Actually, irrespective of AI, an aversion to unnecessary writing effort has always been a thing, especially among those of us who develop product-related content. Why rewrite a product-line description or a disclaimer when you can leverage what others (or you) have already written?

When I had my Eureka moment about this, near the turn of the millennium, I tried to create a content reuse process within an existing product documentation system. Seemed like common sense at the time. So, I set out to convince my colleagues to join me on that plain.

Today, of course, we have many options to componentize content, from WordPress to sophisticated CCMS tools. But where do you start if you’re not ready to make a giant leap to an expensive tool?

I believe the basics of my original process still apply. So, I will share it with you here.

Read more →
Neurodivergence and Content Design: The Migraine Edition

Neurodivergence and Content Design: The Migraine Edition

Debra W Kahn (@debrawk.bsky.social)

Designing online content sensitive to user differences has been our responsibility for at least 20 years – in the U.S., since the advent of Section 508 requirements. During that time, our awareness of inclusivity has evolved to include (pun intended) neurodiversity, a term coined in the 1990s by Judy Singer.

Nick Walker, Ph.D., defines “neurodivergent” folks as having “a mind that functions in ways which diverge significantly from the dominant societal standards of ‘normal.’” (See her helpful blog post “Neurodiversity: Some Basic Terms & Definitions.”)

The mind functions differently. That definition encompasses folks with dyslexia, autism, dyscalculia, ADHD, anxiety, and a neurological injury. It also includes me, a person with migraine disorder. Or it should.

Read more →
Instructions Need a Dénouement, Too

Instructions Need a Dénouement, Too

Debra W Kahn (@debrawk.bsky.social)

If your job is to create instructions for a product user, plot it out, and don’t skip the dénouement!

Unfamiliar with the term “dénouement?” In literature, the term refers to the ultimate outcome or explanation of a plotline. Literally, in Middle French (its origin), it means to “untie” or “unravel.”

What does all this have to do with writing instructions? If your instructions are taking a user on a journey through a set of tasks (think Campbell’s hero’s journey here), then I urge you to “unravel” the expected outcome of their journey for them – and help them to know they are on the right path along the way. Here’s how.

Read more →
Your Website Content: Audit Tips

Your Website Content: Audit Tips

Debra W Kahn (@debrawk.bsky.social)

If your web content is your public face, especially if it’s your sales engine, you should be auditing it at least once a year. 

Read more →
Adapting Content for a New Audience – My Journey in 4 Steps

Adapting Content for a New Audience – My Journey in 4 Steps

Debra W Kahn (@debrawk.bsky.social)

Recasting existing content for use by a different audience or in a different context empowers you as a writer – as a marketer – and/or as a consultant. And it is a great way to reuse evergreen content.

I discovered this myself when I rewrote four existing blog posts – aimed at fellow bloggers – as a single blog post aimed at project managers.

Read more →