frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

fp.

Open in hackernews

Tech Writers Are About to Become Obsolete

https://kibbler.dev/blog/turn-your-codebase-into-a-knowledge-base
9•kewun•3w ago

Comments

Uptrenda•3w ago
already are
damian2000•3w ago
If we can also apply this to network engineers, that would be awesome. No more waiting 2 weeks for a firewall rule. But how many places actually have tech writers these days.. mostly devs will be asked to write documenation.
aorth•3w ago
You guys had tech writers? I write everything myself—from the code to the reports to the policies to the deployment scripts. Well at least I also get to write the firewall rules myself! Sigh...
OccamsMirror•3w ago
That emdash in your response. Chefs kiss
stingraycharles•3w ago
The problem is that AI generated content always has the same structure and grammatical style, and you absolutely still need to guide it in order to make good content.

Tech writers will become more productive, not obsolete.

kewun•3w ago
But why not have the developer that wrote the code guide the AI to generate the content? They know the code best.

Actually at this rate, developers won't be writing code anyways but they're still in a better position to guide the AI.

pletsch•3w ago
Knowing the source code doesn't mean someone is a skilled communicator and expecting people who are bad at <any area> to pick out problems with LLM output in that space is a losing battle
kewun•3w ago
Developers of tomorrow must be skilled communicators to get the most out of AI
sublinear•3w ago
You do realize the developers only "know the code best" because they're busy writing code all day, right?

Nobody wants to be held more accountable with less control over the result.

The moment you tell the devs to focus on working with AI is the moment their guess is as good as anyone else's what the hell is going on. You're not going to squeeze more productivity this way.

inejge•3w ago
> But why not have the developer that wrote the code guide the AI to generate the content? They know the code best.

Knowing the code and knowing how to make the code, or the interface to the code, comprehensible to another user, are different things. Just like with UIs, and the fact that an expert is not necessarily the best teacher.

Anyhow, the age of monumental feats of technical writing is past. Too expensive, and the subject is too volatile for the most part. Economics dictate that we'll have to deal with the cheapest possible docs. We already do.

EagnaIonat•3w ago
> They know the code best.

Two major issues occur unless they have experience.

1. The developer will often have what is called "Acquired knowledge". That is information that is relevant but isn't in any of the files and the developer assumes other developers know what they know.

2. Often is the case that there is more information required that doesn't sit inside the code and is not evident to get the program to work. Quickest way to find that is to get a newbie on a clean machine to follow only the instructions.

userbinator•3w ago
MS started aggressively using AI to generate their documentation a year or two ago. It did not make things better at all, and in fact quite the contrary. Awkwardly verbose wording, contradictory sentences in different paragraphs of the same article, etc. That said, they were already on a trajectory of decline.
kewun•3w ago
You should see the way Claude Code generates documentation. It's pretty good.
politelemon•3w ago
I have and it isn't. The YMMV with LLMs isn't a great place to be.
yellow_lead•3w ago
AI marketing slop.

> This isn't a minor efficiency gain. It's a fundamental shift

> This isn't theoretical. It works today.

> The documentation stays accurate because it's generated from real code, not someone's memory of how things used to work.

Yes, because Claude never hallucinates.

Madmallard•3w ago
Doubt it.

People want to interact with other humans.

Hotel doorman problem etc.

damian2000•3w ago
Devs really don't want to work with tech writers to document their code though
esafak•3w ago
I've only worked with one tech writer; they have been a dying breed for a long time. Gone are the days when software shipped with doorstopper manuals. Only a big company can justify them now. For the rest, LLMs are good enough.
EagnaIonat•3w ago
This is such a shortsighted and dangerous view. The LLM can only work on what it sees.
flax•3w ago
Oh good. Now the documentation will be written by The Machine That Lies to You. Wonderful. What could possibly go wrong?
jaggederest•3w ago
Now we need The Machine That Never Lies to You and some doors...
rich_sasha•3w ago
I spent half a day writing tests against MS SQL where tests would create a separate schema, do their business, then the schema dropped via "DROP SCHEMA ... CASCADE". In the end, thanks to Meat Intelligence on the web I found out there is no CASCADE for MS SQL. But only because blogs and documentation etc were written by people who kinda mostly checked what they wrote.
returnInfinity•3w ago
If the role is eliminated, then the responsibility of the verifying and managing the docs will fall on somebody else.

AI does not take responsibility

zapperdulchen•3w ago
Sure, manually written API docs are a thing of the past. But this has been true even before the era of LLMs. But I'm not that sure that this argument stands for all kinds of software. Depending on the abstraction between your source code and the things your users want to achieve, the expert view of a technical communicator might be necessary in order to come up with instructions (how-to) that meet the needs of the person seeking help instead of just summarizing the software code in natural language.
TYPE_FASTER•3w ago
I asked Claude to summarize a legacy codebase yesterday.

Some of it was accurate.

Some of it was not.

theletterf•3w ago
No they're not. My response: https://passo.uno/letter-those-who-fired-tech-writers-ai/
dkuntz2•3w ago
lol, lmao, author clearly does not understand what a tech writer (or any writer) actually does and how they're important.

Effective Nihilism

https://www.effectivenihilism.org/
1•abetusk•1m ago•1 comments

The UK government didn't want you to see this report on ecosystem collapse

https://www.theguardian.com/commentisfree/2026/jan/27/uk-government-report-ecosystem-collapse-foi...
1•pabs3•3m ago•0 comments

No 10 blocks report on impact of rainforest collapse on food prices

https://www.thetimes.com/uk/environment/article/no-10-blocks-report-on-impact-of-rainforest-colla...
1•pabs3•3m ago•0 comments

Seedance 2.0 Is Coming

https://seedance-2.app/
1•Jenny249•5m ago•0 comments

Show HN: Fitspire – a simple 5-minute workout app for busy people (iOS)

https://apps.apple.com/us/app/fitspire-5-minute-workout/id6758784938
1•devavinoth12•5m ago•0 comments

Dexterous robotic hands: 2009 – 2014 – 2025

https://old.reddit.com/r/robotics/comments/1qp7z15/dexterous_robotic_hands_2009_2014_2025/
1•gmays•9m ago•0 comments

Interop 2025: A Year of Convergence

https://webkit.org/blog/17808/interop-2025-review/
1•ksec•19m ago•1 comments

JobArena – Human Intuition vs. Artificial Intelligence

https://www.jobarena.ai/
1•84634E1A607A•23m ago•0 comments

Concept Artists Say Generative AI References Only Make Their Jobs Harder

https://thisweekinvideogames.com/feature/concept-artists-in-games-say-generative-ai-references-on...
1•KittenInABox•26m ago•0 comments

Show HN: PaySentry – Open-source control plane for AI agent payments

https://github.com/mkmkkkkk/paysentry
1•mkyang•28m ago•0 comments

Show HN: Moli P2P – An ephemeral, serverless image gallery (Rust and WebRTC)

https://moli-green.is/
1•ShinyaKoyano•38m ago•0 comments

The Crumbling Workflow Moat: Aggregation Theory's Final Chapter

https://twitter.com/nicbstme/status/2019149771706102022
1•SubiculumCode•42m ago•0 comments

Pax Historia – User and AI powered gaming platform

https://www.ycombinator.com/launches/PMu-pax-historia-user-ai-powered-gaming-platform
2•Osiris30•43m ago•0 comments

Show HN: I built a RAG engine to search Singaporean laws

https://github.com/adityaprasad-sudo/Explore-Singapore
1•ambitious_potat•49m ago•0 comments

Scams, Fraud, and Fake Apps: How to Protect Your Money in a Mobile-First Economy

https://blog.afrowallet.co/en_GB/tiers-app/scams-fraud-and-fake-apps-in-africa
1•jonatask•49m ago•0 comments

Porting Doom to My WebAssembly VM

https://irreducible.io/blog/porting-doom-to-wasm/
2•irreducible•50m ago•0 comments

Cognitive Style and Visual Attention in Multimodal Museum Exhibitions

https://www.mdpi.com/2075-5309/15/16/2968
1•rbanffy•51m ago•0 comments

Full-Blown Cross-Assembler in a Bash Script

https://hackaday.com/2026/02/06/full-blown-cross-assembler-in-a-bash-script/
1•grajmanu•56m ago•0 comments

Logic Puzzles: Why the Liar Is the Helpful One

https://blog.szczepan.org/blog/knights-and-knaves/
1•wasabi991011•1h ago•0 comments

Optical Combs Help Radio Telescopes Work Together

https://hackaday.com/2026/02/03/optical-combs-help-radio-telescopes-work-together/
2•toomuchtodo•1h ago•1 comments

Show HN: Myanon – fast, deterministic MySQL dump anonymizer

https://github.com/ppomes/myanon
1•pierrepomes•1h ago•0 comments

The Tao of Programming

http://www.canonical.org/~kragen/tao-of-programming.html
2•alexjplant•1h ago•0 comments

Forcing Rust: How Big Tech Lobbied the Government into a Language Mandate

https://medium.com/@ognian.milanov/forcing-rust-how-big-tech-lobbied-the-government-into-a-langua...
4•akagusu•1h ago•1 comments

PanelBench: We evaluated Cursor's Visual Editor on 89 test cases. 43 fail

https://www.tryinspector.com/blog/code-first-design-tools
2•quentinrl•1h ago•2 comments

Can You Draw Every Flag in PowerPoint? (Part 2) [video]

https://www.youtube.com/watch?v=BztF7MODsKI
1•fgclue•1h ago•0 comments

Show HN: MCP-baepsae – MCP server for iOS Simulator automation

https://github.com/oozoofrog/mcp-baepsae
1•oozoofrog•1h ago•0 comments

Make Trust Irrelevant: A Gamer's Take on Agentic AI Safety

https://github.com/Deso-PK/make-trust-irrelevant
8•DesoPK•1h ago•4 comments

Show HN: Sem – Semantic diffs and patches for Git

https://ataraxy-labs.github.io/sem/
1•rs545837•1h ago•1 comments

Hello world does not compile

https://github.com/anthropics/claudes-c-compiler/issues/1
35•mfiguiere•1h ago•20 comments

Show HN: ZigZag – A Bubble Tea-Inspired TUI Framework for Zig

https://github.com/meszmate/zigzag
3•meszmate•1h ago•0 comments