For the nitty-gritty of the API, the draft W3C specification is authoritative. For implementers and developers who seek a more stable version, Service Workers 1 is a right document with which the contributors only focus on fixing bugs and resolving compatibility issues.
Spec development happens via issues in this repository. For general discussion, please use the public-webapps@w3.org mailing list with a Subject: prefix of [service-workers].
Updates to the spec must reference resolved issues marked needs spec.
To make edits to the design, please send pull requests against the Nightly spec on the master branch. We use bikeshed. So, change and submit docs/index.bs. When your pull request is merged, Travis CI will automatically build the spec.
For normative changes, a corresponding web-platform-tests PR is highly appreciated. Typically, both PRs will be merged at the same time. Note that a test change that contradicts the spec should not be merged before the corresponding spec change. If testing is not practical, please explain why and if appropriate file an issue to follow up later. Add the type:untestable or type:missing-coverage label as appropriate.
Contributions to this repository are intended to become part of Recommendation-track documents governed by the W3C Patent Policy and Software and Document License. To contribute, you must either participate in the relevant W3C Working Group or make a non-member patent licensing commitment.
If you are not the sole contributor to a contribution (pull request), please identify all contributors in the pull request's body or in subsequent comments.
To add a contributor (other than yourself, that's automatic), mark them one per line as follows:
+@github_username
If you added a contributor by mistake, you can remove them in a comment with:
-@github_username
If you are making a pull request on behalf of someone else but you had no part in designing the feature, you can remove yourself with the above syntax.