frontpage.
newsnewestaskshowjobs

Open Source @Github

fp.

Open in hackernews

I paid people to try and follow my README

https://shkspr.mobi/blog/2026/10/i-paid-people-to-try-and-follow-my-readme/
36•edent•45m ago

Comments

commandersaki•29m ago
I hate READMEs with a gazillion emojis, too much noise.
layer8•23m ago
Indeed, these make me back out of a project immediately if I don’t have a strong need to use it, and it takes extra cognitive effort to ignore the emojis and focus on the actually meaningful text.
ThePinion•2m ago
This one wasn't as bad as the majority that have the emoji in each header too. At least these emoji did seem to properly represent the item they're next to, not an immediate rocket ship emoji in the header following by irrelevant ones of various sizes littered throughout the text.
chanux•20m ago
Cannot agree more. Looks kinda childish too.

It was nice when emoji were used sparingly and with purpose and intention.

As my childhood English teacher said - too much of anything, good for nothing.

edent•15m ago
That's interesting. In my testing, about half the participants liked them, one didn't, and the rest didn't express a strong preference.

I kept them because they make me smile.

layer8•5m ago
To me it’s similar to what you wrote about the jokes you removed: the emojis are distracting and not actually fun. This use of emojis comes across as a tired meme.
TheSkyHasEyes•11m ago
I needed to read your sentence a few times to figure out you don't hate README files. I too dislike emojis overuse in README files.
cowlevel•7m ago
To me an emoji-filled README is a good sign both the README and the project were generated by an LLM.
coo1estguy•28m ago
This used to be called "I hired QA people to identify gaps in my project", but hey now it has become paying people to follow readme
nkrisc•23m ago
This sounds exactly like UX usability testing. Sit down with someone and watch them work through whatever process you’ve created.

It’s normal to compensate them for their time.

Normally though you don’t modify it after each participant. But for something very niche like following a README (as opposed to an e-commerce flow targeted to the general population) it might be fine, if less rigorous.

WhyNotHugo•21m ago
There's a zeroth step missing from both the Quickstart and Full Set Up: install php-fpm, configure it, and configure your http server to serve using it as a backend.

It seems to be taken for granted — that's something you'd already have in place if you're already serving applications in PHP, but would have to figure out on your own if you haven't served anything in PHP so far in your life.

edent•9m ago
It's a tricky problem. How far back in the stack do you go? The README assumes that you know how to use git to check out the files - or that you can easily save them from the repository. Should it include that as a step in the tutorial?

As I say in the linked article, it depends on what sort of user you have. For a "getting started with Raspberry Pi" document, you might well want to include how to insert an SD card etc.

I'll have a think about the best way to help people figure out if they're running PHP. Thanks for the feedback!

lionkor•5m ago
It can't hurt to make a sentence or two about assumptions.

Like "This manual assumes that you have a Linux/BSD, a C compiler, GNU Make, and a text editor".

layer8•2m ago
Installation instructions usually (should) have a “prerequisites” section. You don’t have to explain how to install the prerequisites, but they should be listed.
edent•1m ago
They are - https://gitlab.com/edent/activity-bot/-/blob/main/README.md?...
chanux•16m ago
> My jokes aren't funny and are actively confusing.

I used to write technical documents in prose style, sometimes with meandering stories. I guess I picked it up from my early blogging days. I realized I hated reading some of them back. So I tried to keep it cut and dried. I do sometimes sprinkle a bit of colorful wording just to add a bit of humanity but only if it doesn't get in the way of the main message.

ozlikethewizard•13m ago
"They were the ones who caught the mistakes that no spell chequer could."

Nice, good article lol. I appreciate a joke or two in a readme but totally understand the annoyance, I think forgetting to actually say what the software does is super common as well though. Often trying to figure out if something found on github will actually solve a problem only to be met with a list of install commands.

Neywiny•7m ago
Yes. The amount of projects that don't just run is outstanding. Luckily docker container projects are inherently better at this is in terms of dependencies, but there are still often weird assumptions or medical incantations to get them during.
scriptsmith•5m ago
Somewhat related question: what is it about READMEs that AI agents love to dump the most useless, hard to contextualise & comprehend, irrelevant rubbish into them that makes understanding a project and onboarding so hard?

It feels like like the AI agents can't help themselves sometimes, and the judgement exercised around what's included and omitted is baffling.

But maybe READMEs have always been this bad, and AI agents have raised the baseline?

sudorm-rf--no-p•4m ago
Even as someone working with PHP I would prefer if the project provides we with some guidelines for setup. Especially if it requires some specific version or extension. Ideally the whole dev environment should be containerized. Then you would again require people to understand and use that layer, but depending on the projects complexity definitely something to consider to make it easier to work with

Trama: See your agent's changes as state machines before any code

https://github.com/nicchia-code/trama
1•nicchia•39s ago•0 comments

Show HN: Termphin – Open-source SSH client whose sessions survive disconnects

https://github.com/Termphin/Termphin
1•mbadyl•4m ago•0 comments

You Can See the Results

https://docs.google.com/document/d/e/2PACX-1vQmQ6YjfD2BKWfhW8iKJJCqPygQfQpNMhF5qSwHkoJSt8d1GLPU4z...
1•GovNikoMLLee•8m ago•0 comments

Show HN: Gradually Loading Web Fonts

https://www.npmjs.com/package/invisible-ink
1•snshn•10m ago•0 comments

Can Switching Hands While I Masturbate Affect My Brain?

https://sex.cosmopolitan.com/pleasure/a73946773/masturbating-non-dominant-hand-good-for-brain/
2•snarky-comments•13m ago•0 comments

What a US purchase costs delivered to 16 countries

https://www.refurb.me/import-costs
2•simoelalj•16m ago•0 comments

Fetching AMD SEV Reports (With Zig)

https://github.com/bschaatsbergen/zig-sev-guest
3•bschaatsbergen•17m ago•1 comments

Don't Put Tilde In Your Path

https://disconnect3d.pl//2026/10/02/dont-put-tilde-in-your-path/
2•arusekk•20m ago•0 comments

Twelve killed and 300 injured in attack on airport in Saudi capital Riyadh

https://www.bbc.com/news/articles/cw33x4y8k82no
4•Betelbuddy•20m ago•0 comments

Electron minus Chromium, powered by Bun and WebKit

https://bunmaska.org/
1•GutenYe•21m ago•1 comments

Show HN: Tack – Type-safe HTTP APIs for Go that reach the TypeScript front end

https://github.com/raven-clown/tack
2•ravenclown•21m ago•0 comments

Scandinavia's first farmers slaughtered hunter-gatherer population, DNA suggests

https://phys.org/news/2024-02-scandinavia-farmers-slaughtered-hunter-population.html
4•optimalsolver•26m ago•0 comments

Valen's Memory Safety: A New Kind of Borrow Checking

https://verdagon.dev/blog/valen-group-borrowing
2•verdagon•27m ago•1 comments

Show HN: A newsletter powered by Jev

https://stashletter.dev/
1•flexdinesh•29m ago•0 comments

Show HN: BetterWispr – Free, open-source dictation for Mac

https://betterwispr.com/
1•kartik017•32m ago•0 comments

AI Engineering Maturity Model: 5 Stages for Teams

https://www.augmentcode.com/guides/ai-engineering-maturity-model
2•Gigacore•37m ago•0 comments

Grok Bot has its own email now. How to put it on your own domain

https://shipmail.to/blog/grok-bot-email-on-your-own-domain
1•jcoulaud•42m ago•0 comments

Show HN: I'm a 14-year-old building my first startup, Titan

https://titan-ai.co/
5•Vidigoat•43m ago•0 comments

I paid people to try and follow my README

https://shkspr.mobi/blog/2026/10/i-paid-people-to-try-and-follow-my-readme/
37•edent•45m ago•20 comments

Show HN: A Mac app to focus on your actions instead of distractions

https://now.korture.com/go/mac
1•skprasad•46m ago•2 comments

Creative Forces in the Global Village (1993)

https://reason.com/1993/05/01/creative-forces/
1•rwmj•47m ago•0 comments

Why Ketamine Immobilizes Some Users

https://www.nytimes.com/2026/10/10/science/ketamine-cornell-anesthesia.html
2•bookofjoe•49m ago•2 comments

Why Your $400 Rain Jacket Fails in Heavy Rain (and What to Do Instead)

https://thetrek.co/why-your-400-rain-jacket-fails-in-heavy-rain-and-what-to-do-instead/
2•bryanrasmussen•50m ago•0 comments

Show HN: Guard hooks for Claude Code, tested against a public corpus

https://github.com/skillkeel/skillkeel-starter
1•northbridgedev•51m ago•0 comments

App Talk back and track on a Mac

https://sixcolors.com/post/2026/08/app-report-talk-back-and-track-on-a-mac/
1•skprasad•52m ago•0 comments

First detection of variable water clouds outside of our solar system

https://news.arizona.edu/news/discovery-marks-first-detection-variable-water-clouds-outside-our-s...
1•geox•53m ago•0 comments

Everything Is a Ralph Loop

https://ghuntley.com/loop/
1•maayank•53m ago•0 comments

What driving across Europe costs in tolls, vignettes, bridges and fuel

https://copilot.travel/tolls/europe-2026
6•heikkikalliokos•54m ago•1 comments

Textual (IRC Client) has a new home, and it is us

https://www.textualapp.com/news/a-new-chapter
2•mococa•58m ago•0 comments

AI is creating a 'human premium' for art created by people

https://www.bbc.com/news/articles/c5vgjm3gk7rzo
32•colinprince•59m ago•22 comments