w3c / w3c/ServiceWorker

Cache API Vary header processing should be clarified

Open
#1,609 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

cache
Dominant language
Bikeshed
Stars
3.6k
Forks
324
Avg merge
14d 22h
Merged PRs (30d)
1

Description

Let fieldValues be the list containing the elements corresponding to the field-values of the Vary header for the value of the header with name Vary.

This needs to be rewritten on top of https://fetch.spec.whatwg.org/#concept-header-list-get (or perhaps the algorithm below "get, decode, and split") as this sentence makes little sense.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the quoted Vary-header algorithm and compare it with Fetch's "concept-header-list-get" and the nearby "get, decode, and split" algorithm. Clarify the sentence so it precisely describes how field values are obtained, with wording consistent with the referenced Fetch specification.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.