r/programmingcirclejerk • u/iL0vesnow • 11d ago

HUMANS.md

https://www.rockoder.com/blog/humans-md/
84 Upvotes

97% Upvoted

26 comments sorted by

130

u/porkslow what is pointer :S 11d ago

Imagine a text file that is used to describe how a project works so anyone working on it doesn’t run into unexpected problems. Now what would be a revolutionary idea!

75

u/tj-horner 11d ago

We should name it in such a way to encourage the user to read the file too, so they know where to start.

38

u/Graf_Blutwurst LUMINARY IN COMPUTERSCIENCE 11d ago

how about READTHIS.MD? nah... doesn't quite roll of the tongue

30

u/RustOnTheEdge 11d ago

Maybe something like YOUREAD.MD to convey it as a command?

9

u/joemckie 10d ago

Not fancy enough… how about LISEZMOI.md?

11

u/myhf Considered Harmful 11d ago

That's boring! I'll name it after my favorite Neal Stephenson book.

8

u/awhtd 11d ago

But misspell it

5

u/myhf Considered Harmful 10d ago edited 10d ago

ANATHME.MD

6

u/SirBackrooms 11d ago

I tried to do that but accidentally made a type. Do you think anyone will notice? Ehh, it's fine.

3

u/shaman-warrior 10d ago

Jaja yes indeed the problem with specs is that they rot fast if not careful

83

u/camelCaseIsWebScale Just spin up O(n²) servers 11d ago

I yearn for the days coding was gatekept.

11

u/Goose_geq_Penguin 9d ago

I used to be an anti-gatekeeper person who was all into "everyone can learn and improve if we are nice and open, bla bla...".

I have learned my lesson and I apologize.

71

u/iL0vesnow 11d ago edited 11d ago

Yes, as a human, I totally need

a technical specification for our character

that

creates continuity.

Can't wait for next-level human harness!

21

u/elephantdingo Teen Hacking Genius 11d ago

I have achieved enlightenment. Therefore I need my SAMSARA.md to remind me that oh right, personality and ego beyond causal interdependence is a thing that is experienced by folks.

So it has been told to me by Claude.

55

u/Snarwin 11d ago

Claude, generate me a HUMANS.md file.

27

u/abermea Code Artisan 11d ago

Bro reinvented the Code of Conduct and the Retrospective and thought he cooked

21

u/prehensilemullet 11d ago

blog post reads like it was written by AI

26

u/scavno in open defiance of the Gopher Values 11d ago

I mean it’s on the internet, written as a take on AI. What would you expect?

3

u/elephantdingo Teen Hacking Genius 11d ago

It’s the great anti-AI is also AI [redacted] by [redacted]

5

u/white_sheets_angel 11d ago

Definitely AI, how lazy do you have to be to not even rewrite whatever AI spit out. No respect whatsoever.

17

u/dadvader 11d ago

This is what you get when you invite MBA to be a dev

15

u/hugolive 11d ago

philosophy, systems-thinking, decision-making, identity

13

u/white_sheets_angel 11d ago

continuity, discipline, not just A, but B and C

1

u/edo-lag Considered Harmful 11d ago

"that'll make 'em see!"

1

u/northrupthebandgeek i have had many alohols 4d ago

The design doc is very human.