[Edi]

As someone who has done extensive documentation for Dominions 3, here is my opinion:

The manual is quite okay as manuals go. Some information has been outdated by patch changes. Some information was slightly incorrect to begin with, but for the most part even the incorrectly explained mechanics worked more or less in the direction the manual explanations pointed to.

You won't learn to play the game by reading the manual alone. For the most part you learn to play the game by actually playing the game and every now and then checking some little detail in the manual or some other thing for some generics.

There is a Strategy Index thread on this forum for a good reason, to give a handy reference to many of the resources provided by this community. Together with the existing game manual, the documentation resources here on this forum and lch's wiki and playing and experimenting by trial and error it's quite possible to learn the game and arguably do it more quickly than when it had just come out and large swathes of this documentation did not exist.

Writing good, user-proof documentation takes a LOT of time. When you have only a two man team, that documentation is going to be hard to get done thoroughly partly precisely because the developers know the code and the mechanics inside out closely enough that they won't be able to anticipate certain basic questions from completely new users. Never mind necessarily putting together a 1-2-3-A-B-C level of manual.

Never mind also that the documentation is required to be written in a non-native language. Knowing how to speak a foreign language and read and write in it is nowhere near the same as being able to write good technical documentation in that language. Not a trivial task when you combine it with all the other resource constraints here.

I originally found the unit stat listings too incomplete for my own requirements. So I made my own. That then ballooned into documenting other kinds of things that were amenable to listing so I'd have it all in one place. Thus the Dom3 DB.

Later I found the modding manual and the mapmaking manual unwieldy for my purposes. So I took the original documentation and rewrote it to better match what I needed. Funnily enough, those rewritten manuals are now the official documentation that comes with the game when you patch it.

The whole point of this is that I didn't sit around twiddling my thumbs and looking perplexed but instead took action.

So, in conclusion, if people want a completely updated, fully accurate manual, then they should write it themselves. If they can't be arsed, they had better learn to do with what they've got, which at this point in time is a considerable amount.

Would it be hard work? Yes. Would it cut into your available playing time? Yes. Would it require actually learning the game in order to accomplish it? Yes, though for non-newbies here this question is irrelevant. If all the effort spent on demanding improved documentation for x, y and z in Dominions had been spent on actually making that documentation, we'd probably already have an improved manual.

Illwinter is currently involved with a new project, with Dominions 3 support more of a sideshow, since it works "well enough" by now. That and everything I said above establishes the baseline circumstances surrounding this issue. If anyone has a problem with that, well, it'll stay as their problem until they do something about it on their own.