532 Followers
938 Following
723 Posts
Endlessly curious about docs, music, data, local politics, ethics in tech, a11y, inclusivity, and so much more. Can be spotted taking the bus to the club. Technical writer in SF. She/her.
bloghttps://thisisimportant.net/
githubhttps://github.com/smoreface

For the forseeable future, AI tools will continue to generate such incomplete and sometime hallucinated outputs that there will be a continuing need for a "human-in-the-loop" to not only use several LLMs to review each other's output but to fact-check the final output. Using one LLM alone results in mediocre quality. Using two LLMs results in (sometimes very) good quality. Use three LLMs with human verification for great/outstanding results.

"1,131 people across the documentation industry responded to the 2026 State of Docs survey — more than 2.5x the number of respondents last year. But the size of the sample matters less than what it represents: a genuine cross-section of the people who create, manage, evaluate, and depend on documentation.

Documentation’s role in purchase decisions is stable and strong, and the case that docs drive business value is well established. The shift this year is in what documentation is being asked to do, and who — and what — is consuming it.

AI has crossed the mainstream threshold for documentation, both in how docs get written and how they get consumed. Users are arriving through AI-powered search tools, coding assistants, and MCP servers. Documentation is becoming the data layer that feeds AI products, onboarding wizards, and developer tools. The teams investing in this shift are treating documentation as context infrastructure, not just a collection of pages.

But adoption has outrun governance, and the gap matters. Most teams are using AI without guidelines in place, and documentation carries a higher accuracy bar than most content. After all, one wrong instruction can break a user’s implementation and erode trust in the product.
(...)
Writers are spending less time drafting and more time fact-checking, validating, and building the context systems that make AI output worth refining."

https://www.stateofdocs.com/2026/introduction-and-demographics

#TechnicalWriting #TechnicalCommunication #SoftwareDocumentation #DocsAsProduct #AI #GenerativeAI

The State of Docs Report 2026 – Introduction and Demographics

The State of Documentation Report by GitBook

The less someone understands about a job, the more they think it can be replaced by AI

Six seats left for Cloudbreak, kicking off Feb 16. In just 6 hours you learn to deploy, secure & admin your very own sovereign EU-based cloud server, complete with Zoom & Google Docs alternatives suitable for fam, small orgs & communities.

No comp-sci or engineering background needed. This is a fully-supported and coached course offering.

https://courses.nikau.io/cloudbreak/

Working with LLMs is a skill that is often based on what you enjoyed about your work. There are people who love the outcome and people who love the process.

If you most enjoy the process of writing, coding, etc then you’ll hate working with LLMs but if you most enjoy having a finished product you created then you see them as a tool to get you there faster.

@scott Aha, turns out it was a calculation error 😭

I was doing:

| stats count by track_name, track_length

Instead of

| stats values(track_length) as track_length, count by track_name

Which meant that somehow (for example) a song I listened to 5 times was counted as 275 listens.

Turns out the real estimate is closer to 31,339 minutes, or more like 17 minutes per day of listening 🤔

That also feels low much much more realistic! Guess I should have reexamined that logic a few years ago...

@scott Ooooh good math check! Thinking about it that way, there's gotta be some other data errors lurking. I’m definitely not listening to that much!

It could be that most of the software that tracks listens/scrobbles record a full listen after listening to a song for at least 30 seconds... so there's likely some song frequency inflation at that level.

I will need to graph some song frequencies per day to see if there are any other anomalies (like October 26 :o )

@draNgNon So rude!!! It is a *different word* google docs!
If you want to read 11K words on music data, what listening means to me in 2025, and why Spotify Wrapped was especially bad in 2025, boy have I got the blog post for YOU
https://thisisimportant.net/posts/my-2025-in-music/
My 2025 in music: A review

Reviewing Spotify Wrapped and SoundCloud Playback compared with my Last.fm data, plus reflections on music listening and data-driven music evaluations with some perspective from Liz Pelly's book Mood Machine.

@kAlvaro too true
@draNgNon I have smart quotes turned off by default in google docs! I typed this out myself! I have no idea how this happened.