News for hackers. Stuff that matters.
Re:Total Annihilation, rebuilt for modern computers by lproven on Wednesday October 14, 2026 @11:04AM (#50088768)
An explanation that says

"thing_1 is like $other_thing_2 and $other_thing_3 and it resembles $other_thing_4" assumes that one knows things 1, 2, 3, & 4.

If you've never heard of 3/4 of them then this is not helpful. It is not an explanation at all.

That's what I mean about "every page is page 1."

We all need to examine our assumptions.

Any and every page about a project or a tool needs to set the authors' assumptions aside and actually explain what it is and what it does, to people outside of the creators' context.

Or, to quote The Big Bang Theory, "I know you're trying to help, sweetie, but you really aren't."

I've heard of Starcraft but never seen it. I know vaguely what "Command and Conquer" is, I think.

Nobody can effectively explain anything to an audience unfamiliar with the entire field using only referents from within that specific field.

I started playing computer games in 1981, and I own maybe approaching 1000 of them. I have bought at least 4 or 5 games for my kid this year alone.

None of these are among them, not a single one.

In order to learn how to explain, you need to examine your context. You need to know where you are to explain how to get there. Without understand what your context is, and learning to step outside, you cannot explain anything much.

Re:Total Annihilation, rebuilt for modern computers by cestith on Wednesday October 14, 2026 @11:10AM (#50088847)
You're asking a lot of a random HN commenter to explain RTS games from first principles.
Re:Total Annihilation, rebuilt for modern computers by lproven on Thursday October 15, 2026 @06:07AM (#50101535)
I'm not asking it of the commenter. I'm asking it of everyone writing a web page or README or something to announce their new project. It's the job of the person sharing the code to properly explain what it does.

Along with "every page is P1" there's another tech-docs saying:

"Docs or it never happened." No docs = no project. Docs, even a README, that fail to say what it is are not docs.