[officialasishkumar]

The Ds\Map::get(), Ds\Map::put() and Ds\Map::remove() pages had a caution saying that, with array syntax, scalar keys are coerced to integers, so $map["1"] would access int(1). That is not true. Ds\Map implements the dimension handlers natively and receives the offset unchanged. The engine doesn't cast numeric string offsets for objects either, so the userland polyfill (ArrayAccess) behaves the same way.

I checked this against ext-ds built from master on PHP 8.5:

$map = new \Ds\Map();
$map->put("1", "string-one");
$map->put(1, "int-one");
var_dump($map->count());        // int(2)
var_dump($map["1"], $map[1]);   // "string-one", "int-one"
$map["2"] = "s2";
var_dump($map->hasKey("2"), $map->hasKey(2)); // true, false
unset($map["1"]);
var_dump($map->hasKey("1"), $map->hasKey(1)); // false, true

ext-ds requires PHP 8.2+, so the caution doesn't apply to any supported version.

Changes:

• Replace the caution with a note describing the real behaviour. It differs from arrays, where such keys are cast to integers, so it's worth stating.
• Fix the array syntax note on the remove() page. It showed reading a value ($map["key"]) instead of removing it (unset($map["key"])).

Validation: php doc-base/configure.php --disable-libxml-check --enable-xml-details --redirect-stderr-to-stdout --with-base-lang=extensions; docbook-cs on the diff; rendered the three pages with PhD and checked the output.

Fixes #22