News for hackers. Stuff that matters.
Re:Total Annihilation, rebuilt for modern computers by lproven on Monday October 12, 2026 @12:57PM (#50059252)
Fails at the first step, for me. WTF is "Total Annihilation"?

There's a sort of motto in technical writing: every page is page 1.

https://everypageispageone.com/

Don't assume your readers know anything at all. Work out your assumptions and always state them.

I was curious, but not enough to do more than a cursory search. Apparently it's some game I've never heard of and am not curious enough about to read an entire article on it to learn what it can't run on and why porting it was worth it.

State your axioms. That means, step 1, work out what your axioms are, and specify them.

Re:Total Annihilation, rebuilt for modern computers by aeturnum on Monday October 12, 2026 @01:44PM (#50060001)
I am pretty sure their first axiom is "this is only interesting to people who know TA already" and, as you suggest, that's probably correct. There's no reason to annoy your primary audience in trying to make your hobby project accessible to people who are not interested in it.
Re:Total Annihilation, rebuilt for modern computers by matchstickman23 on Monday October 12, 2026 @01:02PM (#50059347)
"Everything you need to know should be on the first page"

"I didn't read the first page"

It states right there up front that it's a game and even shows a demo of it playing...

Re:Total Annihilation, rebuilt for modern computers by lproven on Wednesday October 14, 2026 @05:29AM (#50084771)
I know it's a game!

It has the word PLAY. You acidentally demonstrate my point.

I want to know what kind of game from what kind of system. Both to tell me if it's going to be an interesting story of reverse-engineering, and also whether it's something I might actually want to play.

Re:Total Annihilation, rebuilt for modern computers by cestith on Tuesday October 13, 2026 @09:07AM (#50071100)
These are all found on the project's main page.

> Nanolathe is an open-source engine for playing Total Annihilation on Windows, Mac and Linux. It loads the original maps, units and campaigns. You can try it right here with the three-mission browser demo.

> Nanolathe loads the original game data directly, including the scripts that turn turrets and open factory doors.

> It’s a new engine that runs the original game’s data.

Re:Total Annihilation, rebuilt for modern computers by lproven on Wednesday October 14, 2026 @05:28AM (#50084758)
No they aren't.

What did it run on before?

Is this from the '80s (fun 8-bit retrocomputing pixels fun), early '90s (DOS goodness), late '90s (Cthlulhu-esque Win9x VXD horrors), noughties (early hardware 3D, now looking better than ever), teens (just needed dusting), or what?

Is it local or networked?

What kind of game is it? So I know if I should keep reading or not?

Re:Total Annihilation, rebuilt for modern computers by cestith on Wednesday October 14, 2026 @09:22AM (#50087372)
The quotes I quoted are quotes, copied and pasted from the page linked in the HN submission. They are literally on the page.

I understand that you want more specificity, but it's simply untrue that the page doesn't make clear generally what sort of project it is.

Here's some more depth in my own words. It's a real-time strategy game from Cave Dog Games in 1997. It's a precursor to Total Annihilation: Kingdoms. It's a spiritual ancestor to Spring, Supreme Commander, Supreme Commander: Forged Alliance, Supreme Commander 2, the Forged Alliance Forever project, Planetary Alliance, and a few others. Zero-K and BAR are other updated reimplementations. It competes in the space with the original Starcraft, with Warcraft II, the earlier Command and Conquer series games, Dune 2000, and that sort. It has land, sea, and air units and dedicated construction vehicles of all three types. By default there's a commander to protect whose death causes a player to lose the game, but that can be configured to be off. There are stationary units like artillery and buildings including power generators, metal extractors, and factories that make the other units. The construction mobile units and the commander build the land units and buildings. The linked page shows the sort of graphics the original has and puts them side by side with the reimplemented version from the project.

It ran on Windows 95, 98, ME, and XP just fine. ISTM it would run on NT 4 and 2000. I think it runs on 7 from the CD and maybe 10. I don't use the discs much these days though because despite owning two or three disc copies I also got it on sale on two or three different digital storefronts.

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.

Re:Total Annihilation, rebuilt for modern computers by skotobaza on Wednesday October 14, 2026 @07:40AM (#50086094)
> Don't assume your readers know anything at all

But where do we stop? We can't assume everyone knows what an RTS is. We can't assume that everyone knows what a computer game is. We can't assume that everyone knows what a computer is (some people really don't know this).

You can see that this could quickly bloat the explanation.

I remember someone got frustrated on the article about ur-languages posted here on HN. He didn't know what ur-language is and didn't want to look it up by himself. I also didn't know the term, but I just went and googled it instead of berating the author of the article.