Permission Revocation - English language clarification

Aperta
#361 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

  • #363 di @karlcow — chiusa senza merge

Valutazione

Difficoltà
1/5
Tempo stimato
1-3 ore
Idoneità per principianti
35/100
Tipo di issue
Documentazione
Chiarezza
Specificata chiaramente
Stato di attività
Ferma
Stack tecnologico
html
Ambito
documentation

Direzione di ricerca

Read the revocation text in the security and privacy considerations and compare it with the pushsubscriptionchange event section referenced in the issue. Clarify the nested wording while preserving the stated event fields and deactivation requirement; done means the revocation text is easier to understand without changing its meaning.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

editorial

In the security and privacy considerations, there is this section about revocation. To note that this is the only section of the specification where revocation is explained.

When a permission is revoked, the user agent MAY fire the "pushsubscriptionchange" event for subscriptions created with that permission, with the service worker registration associated with the push subscription as registration, a PushSubscription instance representing the push subscription as oldSubscription, and null as newSubscription. The user agent MUST deactivate the affected subscriptions in parallel.

It has too many with in a row to make it clear (at least for ESL like me).
Would there be a way to rephrase this to make it clear? I put the red dots where it starts to be confusing in the level of English nesting.

When a permission is revoked,

Other mentions of revocation.

Then in 10.5 The pushsubscriptionchange Event

The pushsubscriptionchange event indicates a change in a push subscription that was triggered outside of the application's control, for example because it has been refreshed, revoked or lost.

And in the security and privacy section with

Permissions that are preserved beyond the current browsing session MUST be revocable.

Lingua principale
HTML
Stelle
158
Fork
43
Merge medio
2g 6h
PR unite (30g)
2

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di w3c/push-api

Tutte le issue di w3c/push-api

Issue simili

Altre issue su Documentation

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.