Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Separate out the steps for creating a subscription #254

Merged
merged 1 commit into from Apr 27, 2017

Conversation

beverloo
Copy link
Member

@beverloo beverloo commented Apr 21, 2017

Fixes #235. This builds on #253, the actual changes are included in the following commit:

56fa7fc

index.html Outdated
<li>Set the <code>options</code> attribute of <var>subscription</var> to be a copy of
<var>options</var>.
</li>
<li>Generate a new P-256 <a>ECDH</a> key pair. Store the private key in an internal slot
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cite X9.62 on the first sentence.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure how to phrase this. "as described in [[!X9.62]]"?

The actual curve parameters are defined in Section 10.2, should we refer that too?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Went with just [[!X9.62]] since "as described in" doesn't add much either.

index.html Outdated
<li>Generate a new P-256 <a>ECDH</a> key pair. Store the private key in an internal slot
on <var>subscription</var>; this value MUST NOT be made available to applications. The
public key is also stored in an internal slot and can be retrieved by calling the <code>
getKey</code> method of the <a>PushSubscription</a> with an argument of
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is this indent what tidy produces? Strange.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, presumably because the <code> block is open?

index.html Outdated
</li>
<li>Make a request to the <a>push service</a> to create a new <a>push subscription</a>.
Include the <a data-link-for="PushSubscriptionOptions">applicationServerKey</a> attribute
of <var>options</var> when it contains a valid point on the P-256 curve.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We reject the call if applicationServerKey is invalid, so you can remove the "when it contains a valid point" bit.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"when it contains a valid point on the P-256 curve" -> "when it has been set"

index.html Outdated
@@ -868,9 +885,14 @@
is one, or <code>null</code> otherwise.
</p>
<p>
When getting the <dfn>options</dfn> attribute, the <a>user agent</a> MUST return a
<code><a>PushSubscriptionOptions</a></code> object representing the options associated with
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/object/dictionary ?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No, because PSO is the object, PSOInit is the dictionary. We return PSO.

index.html Outdated
@@ -930,7 +953,7 @@
</li>
</ol>
<p>
The serializer for a <a>PushSubscription</a> invokes the following steps:
The <dfn>serializer</dfn> for a <a>PushSubscription</a> invokes the following steps:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no data-dfn-for here?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The owning <section> has been annotated with the data-dfn-for attribute, making that redundant. That doesn't work when a section contains multiple identically named attributes, as is the case with the Init dictionaries.

@beverloo beverloo force-pushed the subscribe-algorithm branch 2 times, most recently from 880b92e to 183b6d6 Compare April 27, 2017 16:05
@beverloo beverloo merged commit fa270fc into w3c:gh-pages Apr 27, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants