First of all, I want to confirm whether v2 is the main version of ahk.
If it is, then users of v1 should be gradually switched to v2.
AutoHotkey is a niche language. If it is divided in this way, it is indeed not conducive to the development of the language.
I have been in contact with the v1 version of ahk for 6 years, and it has been two years since I switched to v2-a102(mainly because of the conversion of syntax , which is not difficult.)
A103 has started drastic reforms, many of which are bottom-level changes, without concise sample code, many errors will make people unable to start.
Now the v2_beta version is out, the syntax should be relatively stable, I also want to follow the steps.
As mentioned above, the workload and difficulty of converting the code are too great, and I think the structure of the help document is a bit confusing.
For example, I found
map related changes at
https://lexikos.github.io/v2/docs/v2-changes.htm#map
Then I entered
https://wyagd001.github.io/v2/docs/objects/Map.htm to see the detailed introduction,
But there is no sample code, and then I have to know, and finally found the sample code with difficulty in
Usage and Syntax→Objects→Basic Usage.
https://lexikos.github.io/v2/docs/Objects.htm#Usage_Associative_Arrays
Just such a single knowledge point requires so many search steps, how can users have the motivation to upgrade to v2.
So I have always advocated a dedicated post or a forum area to guide users to upgrade their existing code as painlessly as possible.
It is best to gradually upgrade the commonly used libraries of v1 to v2. This kind of code comparison is also a more intuitive way for users to learn grammatical differences.
Upgrading to v2 is a big project, I hope it can be taken seriously, this is what I want to say, thank you! ! !
Finally, I hope that the functions of array map can be enhanced, such as
ToString,
array join and other common functions are built into the script.
If there is an official library, I hope it can be written in the help file.