BigW Consortium Gitlab

Skip to content

G
gitlab-ce
Commit 97667b83 by Sean McGivern
Options

Merge branch 'docs-polling-query-params' into 'master'

Document how ETag caching middleware handles query parameters See merge request !10482
parents 32e9e24a 3bec6131
Showing with 6 additions and 0 deletions
doc/development/polling.md
......@@ -39,6 +39,12 @@ Instead you should use polling mechanism with ETag caching in Redis.
1. If the `If-None-Match` header does not match the current value in Redis
we have to generate a new response, because the resource changed.
Do not use query parameters (for example `?scope=all`) for endpoints where you
want to enable ETag caching. The middleware takes into account only the request
path and ignores query parameters. All parameters should be included in the
request path. By doing this we avoid query parameter ordering problems and make
route matching easier.
For more information see:
- [RFC 7232](https://tools.ietf.org/html/rfc7232)
- [ETag proposal](https://gitlab.com/gitlab-org/gitlab-ce/issues/26926)
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment