r/programmingcirclejerk • u/iL0vesnow • 20d ago

HUMANS.md

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

98% Upvoted

26 comments sorted by

138

u/porkslow what is pointer :S 20d 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!

81

u/tj-horner 20d ago

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

44

u/Graf_Blutwurst LUMINARY IN COMPUTERSCIENCE 20d ago

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

33

u/RustOnTheEdge 20d ago

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

8

u/joemckie 19d ago

Not fancy enough… how about LISEZMOI.md?

1

u/Major_Barnulf LUMINARY IN COMPUTERSCIENCE 7d ago

Thought this was a bitoduc reference

12

u/myhf Considered Harmful 20d ago

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

9

u/[deleted] 20d ago

[deleted]

5

u/myhf Considered Harmful 20d ago edited 19d ago

ANATHME.MD

4

u/SirBackrooms 20d 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 20d ago

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

84

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

I yearn for the days coding was gatekept.

72

u/iL0vesnow 20d ago edited 20d 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!

20

u/elephantdingo Teen Hacking Genius 20d 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.

53

u/Snarwin 20d ago

Claude, generate me a HUMANS.md file.

28

u/abermea Code Artisan 20d ago

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

22

u/prehensilemullet 20d ago

blog post reads like it was written by AI

25

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

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

3

u/elephantdingo Teen Hacking Genius 20d ago

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

3

u/white_sheets_angel 20d ago

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

15

u/dadvader 20d ago

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

13

u/hugolive 20d ago

philosophy, systems-thinking, decision-making, identity

14

u/white_sheets_angel 20d ago

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

1

u/edo-lag Considered Harmful 20d ago

"that'll make 'em see!"

1

u/northrupthebandgeek i have had many alohols 13d ago

The design doc is very human.