search

WICG / local-peer-to-peer

↔️ Proposal for local communication between browsers without the aid of a server.
https://wicg.github.io/local-peer-to-peer/
Other
107 stars 7 forks source link

TAG review prep #40

Closed backkem closed 9 months ago

backkem commented 10 months ago

This PR is in preparation for an early TAG review. I altered the explainer to more directly answer the questions of the survey.

anssiko commented 9 months ago

@ibelem can you check the overall flow of the updated explainer so we get more eyes on it? No need to dig deep into security-privacy-questionnaire.md at this time.

Please flag anything that jumps at you or is unclear in the explainer. No need to review all the minute details, more the overall story. You can refer to the explainer template to get an idea what the TAG is expecting. You've thought a lot about the UX around this proposal so your expert comments on that area are also much appreciated.

This is a substantive update (thanks @backkem!) with suggested changes we believe will help the explainer be even more helpful resource for TAG reviewers. Thanks!

ibelem commented 9 months ago

Thanks @anssiko and thanks @backkem for the great and substantive revision of the explainer, much better categories for use cases, and a more structured flow!

Since we initialized the explainer, one aspect I regret not unify more clearly in the explainer is the network environment for the Local Peer-to-Peer API, we use different wordings in different chapters. Providing an explicit unified LP2P network environment would have eliminated any potential confusion, even though the overall meaning can still be inferred from context. This does not affect the integrity of the entire explainer, it is just my rough thoughts.

Explainer:

Spec:

backkem commented 9 months ago

I ticketed out the LAN Terminology issue. I'll try to find some time (maybe next weekend) to pick that up. I agree it would be good to get that sorted before submitting for review.