frontpage.
newsnewestaskshowjobs

Made with ♥ by @iamnishanth

Open Source @Github

fp.

Open in hackernews

Nobody Reads Your Setup Docs

https://hanzilla.co/blog/mcp-onboarding-ten-agents-one-command/
18•donutshop•3d ago

Comments

Brajeshwar•3d ago
Isn’t that the first one reads, when one wants to Setup? What changed?
loloquwowndueo•2h ago
The first one i read is README
regus•1h ago
“ And I realized my setup instructions weren’t documentation. They were a wall between my product and the people who wanted to use it.”

Assuming this was written by a human, I think it is time to retire saying “this is not x it is y”.

The moment I see that I think the text is AI generated and I lose interest.

loloquwowndueo•1h ago
It feels ai-written, for sure. The sentence structure and idioms are very typical of ai writing these days.
cryzinger•43m ago
Agreed; I don't think "Not X, but Y" is a reliable tell on its own, but taken as a whole TFA set off my AI writing spidey-sense big time. The intro takes three paragraphs of fluff (ironically) to say "My product used to have long docs, but after using a product with much shorter docs it made me reconsider my approach."
dijksterhuis•37m ago
i've noticed recently i actually do that fairly often. so i'm consciously trying to edit after the fact to remove it for that exact reason.

is annoying.

Forge36•1h ago
On a recent project we joked "developers can't read". Occasionally we'd ask for help and be pointed to the docs "I can't read".

I suspect there's two big parts to this:

1. Users expect batteries included and that everything "just works" the first time.

2. The language you used differs match your audience. E.g they search "gray" and find no results, however you've spelt it "grey"

Eisenstein•1h ago
So, how do your users uninstall it when they don't want it any more?
Titled86•1h ago
lol too true, learned this the hard way
quangtrn•1h ago
The framing shift that helps: instead of "how do I get users to read setup docs," ask "what would it take to have no setup docs at all." Usually ends up being a better product anyway.
truetraveller•1h ago
saved this comment!
axus•1h ago
I'm going to ask a lazy question, don't you need a good setup document in order to write the installer that executes setup?
finthehuman•26m ago
Claude reads them.
assimpleaspossi•16m ago
>The wizard opens your browser to sign in, scans your machine for installed agents, and writes the config to each one. It supports over 30 agents. The user never sees a config file.

In this day and age, I find it interesting that no one is screaming about security and privacy concerns about this which is so prevalent on any social media platform including this one.

flexagoon•5m ago
If a "developer" can't manage to read one paragraph in a readme, maybe the "developer tool" is not for them. As much as I usually hate gatekeeping, basic reading comprehension is a skill I'd happily gatekeep at.
NamlchakKhandro•4m ago
Why do people keep creating MCP servers.

All you need is bash

Founder of GitLab battles cancer by founding companies

https://sytse.com/cancer/
444•bob_theslob646•4h ago•90 comments

Further human + AI + proof assistant work on Knuth's "Claude Cycles" problem

https://twitter.com/BoWang87/status/2037648937453232504
94•mean_mistreater•3h ago•50 comments

CSS is DOOMed

https://nielsleenheer.com/articles/2026/css-is-doomed-rendering-doom-in-3d-with-css/
46•msephton•1h ago•16 comments

Linux is an interpreter

https://astrid.tech/2026/03/28/0/linux-is-an-interpreter/
128•frizlab•4h ago•19 comments

AI overly affirms users asking for personal advice

https://news.stanford.edu/stories/2026/03/ai-advice-sycophantic-models-research
456•oldfrenchfries•7h ago•354 comments

InpharmD (YC W21) Is Hiring – Senior Ruby on Rails Developer

https://inpharmd.com/jobs/senior-ruby-on-rails-engineer
1•tulasichintha•7m ago

I decompiled the White House's new app

https://thereallo.dev/blog/decompiling-the-white-house-app
284•amarcheschi•6h ago•101 comments

Detecting file changes on macOS with kqueue

https://www.vegardstikbakke.com/kqueue/
48•benhoyt•4d ago•6 comments

The first 40 months of the AI era

https://lzon.ca/posts/other/thoughts-ai-era/
48•jpmitchell•3h ago•0 comments

I Built an Open-World Engine for the N64 [video]

https://www.youtube.com/watch?v=lXxmIw9axWw
296•msephton•9h ago•40 comments

Undroidwish – a single-file, batteries-included Tcl/Tk binary for many platforms

https://androwish.org/home/wiki?name=undroidwish
46•smartmic•4h ago•2 comments

Cocoa-Way – Native macOS Wayland compositor for running Linux apps seamlessly

https://github.com/J-x-Z/cocoa-way
271•OJFord•11h ago•88 comments

Spanish legislation as a Git repo

https://github.com/EnriqueLop/legalize-es
659•enriquelop•9h ago•197 comments

Meta Partners with Arm to Develop New Class of Data Center Silicon

https://about.fb.com/news/2026/03/meta-partners-with-arm-to-develop-new-class-of-data-center-sili...
5•eatonphil•4d ago•1 comments

OpenCiv1 – open-source rewrite of Civ1

https://github.com/rajko-horvat/OpenCiv1
26•caminanteblanco•3h ago•1 comments

1929: Inside the Greatest Crash in Wall Street History

https://www.nybooks.com/articles/2026/03/26/tick-tick-boom-1929-andrew-ross-sorkin/
12•mitchbob•3d ago•11 comments

CERN uses ultra-compact AI models on FPGAs for real-time LHC data filtering

https://theopenreader.org/Journalism:CERN_Uses_Tiny_AI_Models_Burned_into_Silicon_for_Real-Time_L...
279•TORcicada•13h ago•125 comments

Circuit-level PDP-11/34 emulator

https://github.com/dbrll/ll-34
38•elvis70•5h ago•1 comments

C++26: A User-Friednly assert() macro

https://www.sandordargo.com/blog/2026/03/25/cpp26-user-friendly-assert
54•jandeboevrie•3d ago•39 comments

rpg.actor Game Jam

https://rpg.actor/jam
49•Kye•5h ago•5 comments

Go hard on agents, not on your filesystem

https://jai.scs.stanford.edu/
562•mazieres•21h ago•303 comments

ICAO issued new power bank restriction on flight

https://www.icao.int/news/new-power-bank-restrictions-will-safeguard-international-aviation
45•phantomathkg•7h ago•59 comments

Improved Git Diffs with Delta, Fzf and a Little Shell Scripting

https://nickjanetakis.com/blog/awesome-git-diffs-with-delta-fzf-and-a-little-shell-scripting
97•nickjj•4d ago•33 comments

Google just gave Android power users a sideloading win

https://www.androidauthority.com/android-sideload-carry-over-3652845/
23•croemer•1h ago•13 comments

Nobody Reads Your Setup Docs

https://hanzilla.co/blog/mcp-onboarding-ten-agents-one-command/
18•donutshop•3d ago•16 comments

StationeryObject

https://stationeryobject.com/archive/
33•NaOH•3d ago•1 comments

AMD's Ryzen 9 9950X3D2 Dual Edition crams 208MB of cache into a single chip

https://arstechnica.com/gadgets/2026/03/amds-ryzen-9-9950x3d2-dual-edition-crams-208mb-of-cache-i...
286•zdw•19h ago•156 comments

Hacking old hardware by renaming to .zip [video]

https://www.youtube.com/watch?v=P1kfuCkWo24
85•abadar•3d ago•67 comments

Paper Tape Is All You Need – Training a Transformer on a 1976 Minicomputer

https://github.com/dbrll/ATTN-11
118•rahen•3d ago•21 comments

The bee that everyone wants to save

https://naturalist.bearblog.dev/the-bee-that-everyone-wants-to-save/
252•nivethan•3d ago•81 comments