Standardizing Terminology Around Keys and Collections

[salilgupta1]

The documentation seems to go back and forth between using key and collection for the same concept. For example, the syntax for WITHIN is the following:

WITHIN key [CURSOR start]

but then the description states:

WITHIN searches a collection for objects

Another place where this is confusing is in the prometheus metrics where it uses collection e.g. tile38_collection_(points|objects|strings|weight_bytes)

My preference is to use collection in place of key because a collection is plural and represents a group of objects.

[iwpnd]

Hey 👋 I think this is due to many people working on the docs over a longer period of time. I see your point though and agree. If you're up for the task, then draft a PR fixing the documentation. I doubt @tidwall would reject the help if he agrees too. 😄

[tidwall]

The key vs collection naming is a little confusing, I agree. Any added clarity to the docs would be appreciated.

[salilgupta1]

If we move to using collection what would you want to do about the KEYS command? I think that should be renamed to COLLECTIONS but that would be a breaking change.

[tidwall]

I would rather prefer to not change the functionality of Tile38. I'm mainly concerned that if the docs are confusing, is there anything we can do to address that specifically?