That's specifically why I said documentation gives the context. Why the API uses a hash table instead of an array is something for the documentation of said AP

That's specifically why I said documentation gives the context. Why the API uses a hash table instead of an array is something for the documentation of said API, not code comments.