Deborah Barnard

Stumbled across a smart documentation approach in an open source repo today: issues that are deliberately left open.

Next step would be to set up some sort of single sourcing so the issues and docs are maintained together.

Stumbled across a smart documentation approach in an open source repo today: issues that are deliberately left open.

1/ This seems like a good accessible intro to AI psychosis: youtu.be/MW6FMgOzklw?... (caution: the guy has had controversies in the past) This is the paper he's referring to in the video: arxiv.org/pdf/2509.10970 Key takeaway: it can affect anyone, not just people with pre-existing conditions.

1/ This article by @naomialderman.bsky.social is very very good: www.theguardian.com/books/2025/n... Loads of excellent stuff in it, I'm just highlighting a couple of things that stood out to me.

3/ "If it feels too perfectly tailored to me, if it presses my buttons, if it precisely tickles me where I like to be tickled or hurts me where I am vulnerable to being hurt, that’s a sign to check the facts." - this is a really useful tip, however hard it may be to practice.

1/ This article by @naomialderman.bsky.social is very very good: www.theguardian.com/books/2025/n... Loads of excellent stuff in it, I'm just highlighting a couple of things that stood out to me.

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.

1/ Could we all solemnly swear not to be too judgemental of each other about AI? Because I've got a horrible feeling I know what the next impossible hiring trend is going to be: you'll need enough AI on your CV to get past the pro-AI people, but not so much that you deter the anti-AI people.

1/ A surprising amount of government admin. My last passport renewal was quick and easy. So is setting up as a sole trader. Tax returns are probably as painless as they realistically can be. And the fact most people don't even have to do tax returns is nice.

6/ Most of the time, things mostly work. Post. Bins. Buses. Not everywhere all the time, but mostly we're functional.

1/ A surprising amount of government admin. My last passport renewal was quick and easy. So is setting up as a sole trader. Tax returns are probably as painless as they realistically can be. And the fact most people don't even have to do tax returns is nice.

4/ The sense of humour really is a thing, and perhaps helps cross political borders in a way some countries just don't seem able to. I've yet to encounter anyone, even online, who doesn't laugh about the lettuce. And the fact Yes Minister is still funny and applicable to any government is something.

1/ A surprising amount of government admin. My last passport renewal was quick and easy. So is setting up as a sole trader. Tax returns are probably as painless as they realistically can be. And the fact most people don't even have to do tax returns is nice.

2/ Tax advantaged saving and investing: pension and ISA allowances are pretty generous. And the workplace pension was a good move.

1/ 'How to write for AI' is a question that comes up repeatedly. TL;DR and resources 🧵 #ai #documentation #technicalwriting

5/ API the Docs run an 'AI the Docs' virtual conference: apithedocs.org Last year's packed in a huge amount of information.

1/ 'How to write for AI' is a question that comes up repeatedly. TL;DR and resources 🧵 #ai #documentation #technicalwriting

3/ Kapa AI have just published a good quick guide with a lot of usable tips: docs.kapa.ai/improving/wr...

1/ 'How to write for AI' is a question that comes up repeatedly. TL;DR and resources 🧵 #ai #documentation #technicalwriting