People who previously wouldn't touch a README.md with a ten foot pole are now writing entire novels in Markdown for their AI tooling.

[confuseacat@mastodon.social]

@jhauge @frederic That's a very good point!
Why would someone who will never read anything bother to write something? Especially when they overgeneralise and cannot imagine that any other human would ever read anything.

[mitsunee@mk.absturztau.be]

@frederic@chaos.social and then there's a group of users who say they don't know markdown until you call it "discord formatting" ​​

[atax1a@infosec.exchange]

@mmeier @frederic and then these people don't even actually write the documentation. they go "claude, document it" and the documentation is slop

[mmeier@social.mei-home.net]

@rabbit @frederic Oh yeah, that's another whole bag of weird I might just be too "left behind" to fully grasp.

[kirakira@furry.engineer]

@frederic i can't believe this is what it took for people to write readable high level docs

[wonka@chaos.social]

"WebMCP"... Does anyone else think https://en.wikipedia.org/wiki/Master_Control_Program_%28Tron%29 there, or is it just me?

@patrick_h_lauke @frederic

[staticrocket@defcon.social]

@frederic same people who refused to install a linter

[elduvelle@neuromatch.social]

@mmu_man @frederic
to be fair the regedit editing happens about once per year in windows while command-line stuff happens about once every 3 days in Linux (or more)...

[aslmx@chaos.social]

@elduvelle @mmu_man @frederic

In recent years I had seen an increasing amount of "Open powershell and paste these commands" instructions on the internet.

[jcolag@mastodon.social]

@mmeier @frederic Yes! I accidentally read one of those agent-files in a project, and was ALMOST impressed by how comprehensive it all was (at least there) in terms of architecture, style, and even comment tone, because that's obviously useful. And then I realized that they'd probably scream if an actual prospective contributor read it for advice...

[julianoe@mastodon.xyz]

@frederic often times it is not even a good documentation or README.md for humans still.

[jwalzer@infosec.exchange]

@frederic

Yes, And people who celebrated the freedom of "just talking to the computer in human language" and "getting rid of formal programming languages" are now definiing specifications how a good AGENT.md or RULES.md or SKILLS.md has to be written ... to formalize the language to talk to the computers

[orange_lux@eldritch.cafe]

@rabbit @mmeier @frederic I can confirm that.

[holdenweb@freeradical.zone]

@rabbit @mmeier @frederic With (uninformed) vibe coding it’s worms all the way down.

[kasperd@westergaard.social]

I guess I am guilty of not writing sufficient documentation for some of the code I have written. But I have definitely taken the time to explain to new colleagues how it works. And I have also done many pair programming sessions with colleagues to improve the code. And they have now written documentation of the code for AI to read.

But the documentation they wrote actually looks good, so that can probably be helpful for new hires as well. We haven’t stopped hiring, we have hired a couple of new people this year.