Fever. :(

I love you, Zig language's devs.

@simonwillison.net Curious to know your take on DeepWiki, Code Wiki, and similar stuff. passo.uno/ai-wikis-doc...

Augmentation means opening doors faster, not crashing through them.

Want to read drama? See Wikipedia editors debate how to deal with LLM written articles. en.wikipedia.org/wiki/Wikiped...

I want to think this is a phase, that stakeholders will realize what's wrong with this. We'll need to persuade them, and advocate, and explain why we've drawn lines — because we need to draw lines.

Code wikis are documentation theater as a service. passo.uno/ai-wikis-doc...

“The bar for what counts as documentation gets lower every time we pretend these outputs are good enough.” Yep. There’s the key: the pressure to use AI to generate docs depends on pretending that the outputs are good enough.

Code wikis are documentation theater as a service. passo.uno/ai-wikis-doc...

I'm experiencing a strange kind of anxiety since I use LLMs, which appears when I'm out of ideas on how to use it. It's like having a superpower and not knowing who needs to be saved. Or having a car but no roads.

I see this as a clever code summarization tool. They're careful not to call this "docs" but "wiki", which is a way of saying "this is a repo byproduct you can talk to". developers.googleblog.com/en/introduci...

Added a more entertaining 404 error to my blog.

📹 We've published videos and photos of Write the Docs Berlin, and this is your last chance to get a conference t-shirt. Thanks to all participants of the conference, in-person and online! Read more in our recap:

Nope, our SSH keys aren't broken all of a sudden. It's a GitHub hiccup: www.githubstatus.com/incidents/1j...

Added a more entertaining 404 error to my blog.

Added social buttons to my blog, at last.

Yeah, no, ain't gonna put JS or Python stickers on my Mac.

Found the perfect MacBook Air sticker.

I love the fact that AI companies are burning billions of dollars and yet can only afford to pay an editor for six months.

⚡️ ✏️ To see Dennis Dawson's (@dennisdawson.bsky.social) visual approach to documentation, check out his lightning talk on why sketchnoting engages both sides of your brain, as well as his sketchnotes from past Write the Docs conferences. Links in the comments!

.NET 10 is available 🎉 This is a Long Term Support version packed again with quite some good features and performance improvements, congrats to the team! Download it now from dotnet.microsoft.com/en-us/downlo...

Summarization and sorting out git disasters —that's like 80% of the value I'm extracting from LLMs when not coding.

Docs-as-code writers wonder how to contain the seemingly inescapable wave that could bury their backlogs in AI slop. The answer could lie in taking a stance. This means crafting an AI policy for docs. passo.uno/ai-docs-poli...

Docs-as-code writers wonder how to contain the seemingly inescapable wave that could bury their backlogs in AI slop. The answer could lie in taking a stance. This means crafting an AI policy for docs. passo.uno/ai-docs-poli...

It happened. Every time I write "and so on" I read it in Slavoj Zizek's voice.

My goodness. I just watched the first episode of Pluribus. So terrifying, in the best way. Like the best episodes from The Twilight Zone. I don't know if it'll hold for an entire season, but... Wow.

My blog has had an Easter egg for years. :) passo.uno/pc/

Great documentation makes readers feel smart. In S3:E22, Dennis Dawson (@dennisdawson.bsky.social) talks about scaffolding concepts, using Hemingway-style clarity, and writing documentation that flows easily into readers' brains so they feel smart instead of lost.

Got nostalgic and create an Italian teletext viewer for the terminal, in Rust, with Claude's help. github.com/theletterf/t...

Now I'm having this crazy idea of creating a custom CLI agent forking one of the mainstream CLIs, feeding our contribution docs via RAG, adding a solid base prompt... Feels almost like the good old days of warez, lamerz, and videogame ripoffs.

Kindness is underrated.

The video of my Write the Docs talk is up! Hope you'll find it useful. :-) passo.uno/failing-well...

The video of my Write the Docs talk is up! Hope you'll find it useful. :-) passo.uno/failing-well...

Just got one of the Early Alert Warnings on my phone due to heavy rains. Useful, but it reminded me of the Cold War. I hate this sound. youtube.com/shorts/oVzrt...

Today I've realized that one of my biggest issues is that I assume most folks are able to introspect at all times and understand why they're reacting in a certain way, while, in reality, they are just reacting the same way someone would react to bad weather, by mindlessly opening an umbrella.

Wearing my favorite t-shirt.

1/ The creator of Material for MkDocs has released a new static site generator and accompanying themes, @zensical.org : squidfunk.github.io/mkdocs-mater... Loads of info in the post about what, why, and timelines.

Let's be honest. Sometimes people overestimate the effect of docs. "The ship is on fire and I couldn't steer it by reading the docs — @#€!!!"

The absolute pleasure of meeting Persian people and see their smile when you tell them you studied Persian language.

Italian panettone in Spain. This is what Sid Meier's Civilization would call a Cultural Victory.

I've done it. The good news is that it's fast and inexpensive. The bad news is that with small training sets it's like throwing a bucket of colorant into the ocean and hoping it'll change hue.

Fine-tuning a small LLM model using my blog writings as training data, on RunPod, spending a few bucks. Let's see what comes out of this...

I liked Berlin. I could live there. It's a comfortable, cosmopolitan post-apocalyptic city.

The Elastic Docs Utilities extension for VS Code and other compatible editors is now online in the MS Marketplace and in Open VSX. Enjoy! marketplace.visualstudio.com/items?itemNa... open-vsx.org/extension/El...

Said this to a colleague. Then re-read myself and realized I'm Data from Star Trek. "For some reason, folks behave differently once they've seen you in 3D (which puzzled me to no end, but I've learned to consider it useful)."

I love this Write the Docs sticker. :)

Some were missing my old blog theme, so I added an option to the nav to switch between Desktop and Console modes. :)

The slides from my @writethedocs.bsky.social Berlin 2025 talk, "Failing well". Enjoy! docs.google.com/presentation...

Here's my thing, anyone whose material on a subject seems focused on establishing their brand as representing a particular stance on that subject rather than actually engaging with its complexities or increasing understanding of it.. is not someone I'm inclined to trust on it lol

To my new followers: Hi! I'm a nerd and I generally only write about technical writing, documentation, and the impact of AI on humanist work in tech.