-
Notifications
You must be signed in to change notification settings - Fork 10
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
Split doc into identity.html and actions.html #16
Comments
I've split into two separate directories, which will help us keep demos, README files and other things separate. (A shared README file that discusses things overall is possible, but when discussing the APIs themselves, it helps to keep separate files.) |
@eladalon1983 This is not what we agreed to in Monday's chairs meeting. The chairs agreed to rejigger #15 into This means all the other files should stay where they are. I like the I think we need to undo the directory changes, and merge #17 instead. |
But it should not auto-redirect. |
|
When a compromise is negotiated which straddles concerns, details matter:
The compromise reached was quite explicitly to split the document into
This assumes we split all the files, which was literally not the compromise struck. This wouldn't have been the case if the two APIs were in the same document, so there are two mindsets on whether this is desirable. My understanding of the compromise was that the same editors would be responsible for driving both APIs. PR #17 (which is mentioned explicitly in the stated chairs agreement), faithfully split the doc into two, duplicating the intro and use cases (maybe I should have taken out use cases 2-4), and updated the README.md to briefly mention Actions. Crucially, it kept all the following files shared:
As a representative of the side that wished this to be a single document in the first place, this matters, and is a big part of why I agreed to the compromise: The WG will pursue and standardize both APIs to solve the same use case 1, and readers will discover both APIs. (@dontcallmedom informs me Lastly, we have a process to follow that's supposed help in situations where there are different mindsets. As co-editor of both documents, I would expect to discuss changes in regular Editor's Meetings, intead of reacting to unilateral pushes. I propose we follow that process and do what we said we would do to get these documents adopted and into the w3c repo ASAP where we will have the benefit of this process to track and aid further changes. |
I did not consent to this.
Could I please know whom you are representing in this matter? Are there additional parties other than yourself?
This has not changed.
The explainer, security questionnaire and demos should remain distinct. At the moment, only one API is implemented, has demos, etc. Combining things would sow confusion over what is implemented and what is not. It would not serve readers well. When this changes - Actions is specified and prototyped - we can revisit the topic and see if merging the explainers yields a result that serves the readers. |
This was a chairs' agreement. |
Then it would be good to avoid the word "we" so as not to create the impression that I am going back on my word. I am not aware of a chairs' decision to NOT put identity.html and actions.html in their own directories, nor would I have supported such a decision. I have given you objective reasons for why I think this should be done. I suggest we discuss this objective matter. Why do you NOT want separate directories? |
This process will apply once the repo is adopted by the W3C. |
My interpretation of the discussion on the chairs' call was that the critical agreement was that there would be two documents. I must admit that I did not think about the files apart from the specs themselves while discussing the disposition; since the existing README and security-privacy-questionnaire have been written with identity in mind and do not have references to actions, it makes sense to keep them together with identity for now. I'm happy with the split being done on a directory level. |
AFAICT the README and demos cover use case 1 which can be covered by both APIs, so I see no reason to have separate conversations for them. |
The README and demos, as presently written, cover using identity to satisfy use case 1. The argument for using actions in this use case has been made verbally, but not in the README. |
@alvestrand #17 adds a single paragraph to the README: Capture Handle is a mechanism that allows a display-capturing web-application to
ergonomically and confidently identify the web-application it is display-capturing
(provided that the captured application has opted-in). Such identification allows
these two applications to collaborate in interesting ways.
+ Capture Actions is a mechanism that allows a display-capturing web-application to issue
+ predefined standard actions like "next" and "previous" to the web-application it is display-
+ capturing (provided that the captured application has opted-in).
For example, if a VC application is capturing a presentation, then the VC application can
expose user-controls for previous/next-slide directly in the VC application. This lets the user
navigate presentations without having to jump between the VC and presentation tabs. ...because this seemed the minimum needed to establish scope. That the rest of the The This repo doesn't currently have an For the security questionaire @dontcallmedom proposed For the Disclaimer: my statements here are based off the state of this repo Monday of this week, which is the last time I felt I had a good overview of the state of things. Specifically, there have been some duplication of files done this week that I think is unfortunate and should not have been made (like individual Is this something we could adopt? |
It is natural to have separate explainers for separate spec files. Insisting on a single shared explainer goes against the grain of separating the APIs into spec files - which was the compromise @jan-ivar has earlier agreed to. |
@eladalon1983 This repo doesn't have an In fact I said "...that's thankfully one less file we need to agree on ahead of adoption". Let's avoid characterizations as they do not seem productive. |
My message was posted shortly after we[*] held a video conference about this that lasted 60 minutes. I believed I had a firm grasp of what you want, albeit not why. If I misunderstood you, or if you've changed your mind, or if anything else has taken place, and you are in fact willing to have two separate explainers, one for Identity and one of Actions, then that would be very good news indeed. Is that the case? -- |
@eladalon1983 I'm proposing a way forward in #16 (comment). I would like someone to engage with that. My already stated view is we not block adoption on figuring out where a future I notice I keep saying For instance, I was explicit above about not wanting "individual To which it looks to me like your response was: "It is natural to have separate explainers for separate spec files." To me it sounds like you're conflating |
|
@eladalon1983 The issue is clarity not familiarity. I'm basing my statements off of Monday's state, to be unambiguous about what I describe. I'm not comfortable referencing the current repo for this due to how it's being handled right now (changes aren't going through PRs or review, making it an unstable reference unfortunately). I've looked at the structural changes made since Monday, and, based on what I've already written, disagree with most of them. But if it would help understanding, undoing them would include:
TL;DR: I'd like to remove any appearance of nested repos. The spirit of the chairs' compromise that appealed to me was that these documents could live side by side, with a common README.md. This should satisfy any w3c process concerns, according to @dontcallmedom, so I'm not sure what other concerns there are. |
I also noticed the actions document is just a bunch of WebIDL with algorithms now, which isn't readable. So add
It doesn't need to be perfect, but I see no reason to do less than the work I already did on this, so it'll look presentable out of the gate. |
We have agreed that we have two specification documents, accepting that these may move up the W3C process cycle at different speeds, and we have agreed that they should live in the same repo for now since the assertion has been made (strongly, by Jan-Ivar) that there are sufficient couplings between them that there needs to be the ability to file issues on them in the same bug tracker. I don't understand the insistence on appearing to increase the linkage between them by manipulating the shape of the repository to make it more difficult to handle ancillary documents that pertain to only one of the main documents. In short: I don't think the objections to separate directories makes sense. |
The sufficient couplings between them run deeper than that: they solve the same primary use case, which is why I preferred a single document. Either solution telling this user story in isolation seemed a disservice to readers looking for solutions. That's why there remains a shared story to tell about that use case in the top-level I agreed to split the documents for w3c process reasons. I rely on @dontcallmedom as the expert here, but I believe he's said most of the directory changes are unneeded for that, suggesting ancillary documents are easily handled either way.
I don't accept the characterization about who is "manipulating the shape of the repository". My PRs were comparatively minimal and never merged. My remaining comments are about the unilateral changes made after Monday's chairs agreement to adopt:
|
Let's just say that I don't find the argument that "they solve the same primary problem" convincing, and I don't hear anyone but Jan-Ivar making that argument. It is possible to solve one of the scenarios described using both components. It is possible to solve the same scenario using only one of the components + some other components using already existing standardized mechanisms, and it is possible (I think; I haven't yet started spitting PRs at it to point this out) to solve other interesting problems using only the other mechanism. Reminder: Nobody (including Jan-Ivar) has committed to implementing the -actions mechanism; Chrome has had the -identity mechanism implemented and in origin trials since July 2021. |
The chairs have resolved adoption, so some of this is water under the bridge, but I do want to respond.
Mozilla is committed to implementing the -actions mechanism, because it promises to provide the significant subset of the functionality that identity provides, but to a broader set of parties, which seems good for users. We hope other vendors join us in supporting this, to avoid users experiencing product lock-in.
I noticed that. Should this diagram perhaps be updated then? |
"Formal spec" is not identical to "accepted by WG", so no. I don't think it's accidental that this diagram does not mention the W3C at all - the kind of excessive delay that we've seen both here and with Breakout Box is one of the reasons why it's not reasonable to gate shipping on W3C adoption. (I hope you can link to Mozilla's commitment to shipping the -action mechanism. I'd like to see what you've committed to.) |
What about the -identity mechanism? |
Answered offline. |
There are other interested parties watching this repo. For their benefit, could you answer publicly? |
At the chairs meeting today, as a compromise to adopt working on APIs for both identification and actions, we agreed to merge #7 and #8, and then split this document into two documents to live in the same repo, then adopt both:
identity.html
to cover the existing identification API, andactions.html
to cover actions (as outlined in Add Actions section from January WebRTC interim #15).This should allow actions.html to mature independently from identity.html, hopefully assuaging concerns that one might hold up the other (even though there are issues with both). The WG can then consider merging them at a later stage, if that makes sense then.
I'll create a new PR to do so based on #15. In the interest of completing adoption, I suggest we open new issues for the remaining feedback discovered in #15 (hopefully in a w3c repo shortly!)
Appologies if this precedes an announcement in public-webrtc, as we want to get the PR ready. cc @alvestrand @aboba
The text was updated successfully, but these errors were encountered: