High quality documentation is one of the most important pieces of content marketing an organization has, and I know I'm not the only one to hold this view. In a world over saturated in marketing material, well written and complete support documentation helps your organization feel trustworthy, shows how you sweat the small stuff and what sort of after market support people can expect.
The AI revolution is laying bare so many biases. LLM bad behavior and ChatGPT hallucinations revealing the chat room cruelties in its learning data. Research and lawsuits keep piling up around how AI job screening tools discriminate illegally, be it age, gender or ethnicity.
Back in 2018 I gave a presentation at Content Connections, titled Governance in Content: Draconian Overlord or Supportive Coach. This was back in an era when most folks didn't really think about AI.
I just finished an interview with Diana Payton for Technical Writing Uncensored and I'm buzzing with the joy of a good conversation. One of the concepts we explored was communities of practice. You form a community of practice around an activity with a shared passion for getting better at doing that thing. What happens is much more than just refining that craft. People who are drawn to a…
I’ve written, and abandoned, four different blog posts in the last few weeks! Each blog post fighting with itself as it was actually two or three blog posts.
IQ predicts how well you'll do in your school years and how much salary you can make over the course of a career because it says what job you can get... but once you're in those professions everybody else is about as smart as you are, and that is where emotional intelligence kicks in. - Daniel Goleman
Infodumping is when you provide a whole lot of information all at once. It's a term that's been used for some decades when critiquing literature and has been adopted by autistic communities to refer to our tendencies to excitedly enthuse on a topic.
I had a great conversation with Kate Mueller on the Not Boring Technical Writer podcast. The actual interview was a lot longer as we got quite carried away, so kudos to the editors for squeezing it down to size.
This essay started as a love letter to mindfully turning up. I wanted to write about the power that comes from turning up a little bit at a time consistently. As I attended to the work of blogging regularly it evolved to be a love letter to processes, structures, systems and their interconnections. This essay gives you a tour of philosophies and metaphors that may feel disconnected at first, but…