Missing documentation for facts and actions about aoe2-ai-module HOT 3 OPEN

There already exists an excellent documentation source here: https://airef.github.io/index.html which could probably be used instead.

from aoe2-ai-module.

That is indeed an excellent source of information and would be a waste of resources to duplicate. Although having to do some cross-referencing it should work fairly well for coding with this API. It could use some contributions regarding DE commands.

A few cases that I think should still be documented here:

1. Any custom actions and facts that are added by AI Module. Currently there's just "Goals", but in the future I can see "StrategicNumbers" and a few more being added.
2. The AI Module might support AoC at some point. The user looking at the API should assume that unless explicitly stated, a function will work on both DE and AoC. A notice should be added to facts and actions that are available only on one or the other.

As for the rest of the facts and actions, documenting them is certainly a very low priority task. Also no more than 1 sentence per message or parameter. Reasons for doing it at all might be for the completeness of the API (seems odd to have only some RPC messages documented) and to eliminate any guesswork regarding return values and parameters (the module modifies how some facts return values, plus there are parameter naming discrepancies compared to airef, it should be fairly obvious though). To alleviate the latter issue, there's also the option to standardize parameter names to airef as much as possible.

from aoe2-ai-module.

In commit 8c54ee7 fact and action parameters were renamed to be more consistent and similar to airef.

from aoe2-ai-module.