Skip to content

Conversation

@pejic
Copy link
Collaborator

@pejic pejic commented Mar 17, 2025

See #271


Preview | Diff

@pejic pejic force-pushed the main branch 2 times, most recently from c5e83b6 to aac5dad Compare March 21, 2025 19:30
Copy link
Collaborator

@stephenmcgruer stephenmcgruer left a comment

Choose a reason for hiding this comment

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

Tried to keep this first pass to meta-level commentary, and sorry again for the delay in reviewing!

@pejic pejic force-pushed the main branch 2 times, most recently from a9bdc90 to 7a9c1c3 Compare April 2, 2025 14:58
Copy link
Collaborator

@stephenmcgruer stephenmcgruer left a comment

Choose a reason for hiding this comment

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

High level this is looking good to me - almost all my comments are nits and bikeshed related things.

@pejic pejic force-pushed the main branch 3 times, most recently from 007c502 to f68533d Compare April 8, 2025 21:14
@stephenmcgruer stephenmcgruer removed the request for review from rsolomakhin April 9, 2025 02:26
Copy link
Collaborator

@stephenmcgruer stephenmcgruer left a comment

Choose a reason for hiding this comment

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

Some more minor nits, but overall this LGTM as a solid foundation for BBKs in the spec. There is still more to add, notably we need to add Security & Privacy Considerations for BBKs, but I think we can do that in a separate PR in the future.

Note that we should not land this yet. Firstly, I'm sure Dominic may have input as a spec mentor (thanks in advance Dominic!), as may Ian as a reviewer. However on top of that, we should give the Working Group the chance to review the content before this lands. @ianbjacobs - I would prefer not to wait until the 24th to do that, do you think it would suffice to send the preview to the Working Group mailing list and invite feedback that way?

(Even after this lands we can always come back and change it, of course!!)

Thank you Slobo for your work here!

Copy link
Collaborator Author

@pejic pejic left a comment

Choose a reason for hiding this comment

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

Thanks Dominic for the feedback!

Copy link
Member

@domfarolino domfarolino left a comment

Choose a reason for hiding this comment

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

Looking better. There are still lots of strange instances where you describe a step and then actually make it technical by running algorithms and passing arguments as an afterthought. Those need to be cleaned up to just read like natural spec code. See the last review comment in this review.

@pejic pejic force-pushed the main branch 2 times, most recently from 956b4e4 to 4d19ae6 Compare May 29, 2025 12:49
@pejic pejic force-pushed the main branch 2 times, most recently from 246c6e5 to 525ff98 Compare May 29, 2025 13:12
Copy link
Collaborator Author

@pejic pejic left a comment

Choose a reason for hiding this comment

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

Thanks for the feedback @domfarolino. Could you take another look?

This change adds browser bound keys to the secure payment confirmation
spec.

See issue 271,
w3c#271.
spec:i18n-glossary; type:dfn; text:bidi isolation
spec:i18n-glossary; type:dfn; text:language priority list
spec:infra; type:dfn; text:list
spec:infra; type:dfn; text:user agent
Copy link
Member

Choose a reason for hiding this comment

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

I believe both of these terms are "exported" publicly from infra, so they don't need to be manually referenced in this the anchors block. I suspect the same is true with other links in this PR too, please check them out.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Checked all definitions be removing them one by one, and seeing whether bikeshed gives errors or warnings. Some were removable. For the infra ones: bikeshed gives me a warning:

LINE 1760:24: Multiple possible 'list' dfn refs.
Arbitrarily chose https://tc39.es/ecma262/multipage/ecmascript-data-types-and-values.html#sec-list-and-record-specification-type
To auto-select one of the following refs, insert one of these lines into a <pre class=link-defaults> block:
spec:ecmascript; type:dfn; text:list
spec:infra; type:dfn; text:list
spec:url; type:dfn; text:list
[=list=]

Copy link
Member

Choose a reason for hiding this comment

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

You should follow the instructions and add a <pre class=link-defaults> block with spec:infra; type:dfn; text:list in it.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

The list and user agent are already in the link defaults block (starts on line 95 in the latest version), so I think this is good as it stands. However, I could be misunderstanding.

Copy link
Collaborator Author

@pejic pejic left a comment

Choose a reason for hiding this comment

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

Thanks again for the feedback, @domfarolino!

spec:i18n-glossary; type:dfn; text:bidi isolation
spec:i18n-glossary; type:dfn; text:language priority list
spec:infra; type:dfn; text:list
spec:infra; type:dfn; text:user agent
Copy link
Collaborator Author

Choose a reason for hiding this comment

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

Checked all definitions be removing them one by one, and seeing whether bikeshed gives errors or warnings. Some were removable. For the infra ones: bikeshed gives me a warning:

LINE 1760:24: Multiple possible 'list' dfn refs.
Arbitrarily chose https://tc39.es/ecma262/multipage/ecmascript-data-types-and-values.html#sec-list-and-record-specification-type
To auto-select one of the following refs, insert one of these lines into a <pre class=link-defaults> block:
spec:ecmascript; type:dfn; text:list
spec:infra; type:dfn; text:list
spec:url; type:dfn; text:list
[=list=]

@pejic
Copy link
Collaborator Author

pejic commented Jun 6, 2025

Thank you Dominic, Ian, and Stephen for the reviews on Browser Bound Keys!

@pejic pejic merged commit 5fdeabd into w3c:main Jun 6, 2025
3 checks passed
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.

4 participants