Docs: Allocation query cache

[markmandel]

What type of PR is this?

Uncomment only one /kind <> line, press enter to put that in a new line, and remove leading whitespace from that line:

/kind breaking
/kind bug
/kind cleanup

/kind documentation

/kind feature
/kind hotfix

What this PR does / Why we need it:

Been having several conversations around the allocation query cache lately.

People assume that it is strongly consistent, when in fact it is not.

So wanted to write some docs to manage expectations appropriately.

Which issue(s) this PR fixes:

Closes #2788

Special notes for your reviewer:

N/A

[agones-bot]

Build Succeeded 👏

Build Id: 75fc4b43-35e4-4d62-a34b-8ef0bc648a5f

The following development artifacts have been built, and will exist for the next 30 days:

• image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.28.0-1ad7285-amd64
• image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.28.0-1ad7285-linux-amd64
• image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.28.0-1ad7285-amd64
• image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.28.0-1ad7285-amd64
• Linux C++ SDK (build): agonessdk-1.28.0-1ad7285-amd64-linux-arch_64.tar.gz
• SDK Server: agonessdk-server-1.28.0-1ad7285-amd64.zip

A preview of the website (the last 30 builds are retained):

• https://1ad7285-dot-preview-dot-agones-images.appspot.com/

To install this version:

• git fetch https://github.com/googleforgames/agones.git pull/2825/head:pr_2825 && git checkout pr_2825
• helm install agones ./install/helm/agones --namespace agones-system --set agones.image.tag=1.28.0-1ad7285-amd64

[google-oss-prow]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: gongmax, markmandel, roberthbailey

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [markmandel,roberthbailey]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[google-oss-prow]

New changes are detected. LGTM label has been removed.

[google-oss-prow]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: gongmax, markmandel, roberthbailey

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [markmandel,roberthbailey]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[agones-bot]

Build Succeeded 👏

Build Id: e1bb9660-613e-4761-b54c-5e66ce4af143

The following development artifacts have been built, and will exist for the next 30 days:

• image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.28.0-4409ec3-amd64
• image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.28.0-4409ec3-linux-amd64
• image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.28.0-4409ec3-amd64
• image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.28.0-4409ec3-amd64
• Linux C++ SDK (build): agonessdk-1.28.0-4409ec3-amd64-linux-arch_64.tar.gz
• SDK Server: agonessdk-server-1.28.0-4409ec3-amd64.zip

A preview of the website (the last 30 builds are retained):

• https://4409ec3-dot-preview-dot-agones-images.appspot.com/

To install this version:

• git fetch https://github.com/googleforgames/agones.git pull/2825/head:pr_2825 && git checkout pr_2825
• helm install agones ./install/helm/agones --namespace agones-system --set agones.image.tag=1.28.0-4409ec3-amd64