Discussion about this post

User's avatar
Carrie H's avatar

Thank you for making this distinction! I've been wrestling with the difference between the kind of structured content I've been talking about, and the kind that tech comms folks talk about. The key is the semantic part -- base content and its structure on meaning and intent, not format.

Expand full comment
Shelley List's avatar

You're saying we should actually do our jobs and stop phoning it in?

When I took my current position, the so-called user guides were screen descriptions: "Check the 'no widget' box if you don't want a widget." This for a complex piece of software with many ways to work depending on how you set it up. It took a lot of time to clear all that up and I'm still adding process-oriented guides: how-to's, special setups for special functions, tips and hacks.

So now artificial intelligence can take credit for the fact that I bothered to do my job.

Expand full comment
4 more comments...

No posts