Why different "handling" for platform specific options / build params / flags in iOS and Android?

For Android signing flags, at other places (CLI docs) referred to as "platform options", we have examples like this:

cordova run android --release -- --keystore=../my-release-key.keystore --storePassword=password --alias=alias_name --password=password

Source: https://cordova.apache.org/docs/en/latest/guide/platforms/android/#using-flags

Note the additional `--` that seperates
`--keystore` etc from the rest.

But for iOS we have this example:

cordova build --device --buildFlag="MYSETTING=myvalue" --buildFlag="MY_OTHER_SETTING=othervalue"

Source: https://cordova.apache.org/docs/en/latest/guide/platforms/ios/index.html#xcode-build-flags

`--buildFlag`is clearly a platform specific option as it is not listed on https://cordova.apache.org/docs/en/latest/reference/cordova-cli/index.html#cordova-build-command

Why does this not need an additional `--`?

Also, there are no examples (that I could find) for the iOS platform specific params in the CLI docs and general docs, they are only listed here: https://cordova.apache.org/docs/en/latest/guide/platforms/ios/index.html#using-flags
How would these have to be separated from the actual command?

No matter what the result, I think 2 things should happen in the docs:

1. Naming of these params should be unified and crosslinked so it is clear that this is the same thing. I wasn't really clear about this until now. Are there more?
2. There should also be examples for the iOS platform specific params / flags