It seems to me that the descriptions of the pin numbering options
are almost designed to be confusing
To me "By Arduino pin" means that the pin numbers printed on the Arduino board should be used whereas "By GPIO number" means that the ESP32 chip pin numbers should be used
The confusion seems to be the use of the word "legacy". Which legacy is implied by this ? Is it the legacy of the classic Nano board or the legacy of the ESP32 chip ? It is not obvious
I would suggest that consideration should be given to changing the descriptions to make the meaning more explicit. Perhaps "As printed on the board" and "Native ESP32 chip"