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

Define "joint deliverables" #754

Closed
frivoal opened this issue May 1, 2023 · 16 comments · Fixed by w3c/Guide#182
Closed

Define "joint deliverables" #754

frivoal opened this issue May 1, 2023 · 16 comments · Fixed by w3c/Guide#182
Assignees
Labels
AC-review Raised during the AC review phase, or otherwise intended to be treated then. Closed: Out of Scope

Comments

@frivoal
Copy link
Collaborator

frivoal commented May 1, 2023

In his AC review of Process 2023, @ericsiow made the following comment (not blocking adoption of P2023):

[We] would like to see the joint deliverable concept formally defined in a future version of the W3C Process Document.

(Reproduced with permission)

@frivoal frivoal added the AC-review Raised during the AC review phase, or otherwise intended to be treated then. label May 1, 2023
@frivoal frivoal added this to the Deferred milestone May 1, 2023
@plehegar
Copy link
Member

plehegar commented May 1, 2023

The context here are the joint deliverables between the Web Applications Working Group and the Devices and Sensors Working Group. While I don't mind formally defining the concept, I'm not aware of any actual problem created by having joint deliverables between the 2 groups.

See w3c/webappswg#90 w3c/das-charter#123

cc @marcoscaceres @LJWatson @anssiko @reillyeon

cc

@marcoscaceres
Copy link
Member

marcoscaceres commented May 3, 2023

Right, can't do any harm to define the concept. but shouldn't block us from doing joint deliverables.

Joint deliverables have been a feature of the W3C has since at least 1998 (e.g., XML Linking Language (XLink) Design Principles was a joint deliverable between the XML Core Working Group and the XML Linking Working Group). And there are a ton of examples at https://www.w3.org/TR/

Additionally, WebApps has a joint deliverable already with DAS (Contact Picker) and the collaboration works great.

Here's a shot at defining joint deliverable as a starting point:

A "joint deliverable" is a technical specification or document collaboratively produced by two or more working groups within the W3C. These groups work together to address a specific technical challenge or achieve a shared goal, abiding by the W3C Patent Policy to protect contributions and enable royalty-free implementation. Joint deliverables arise from the combined expertise and resources of involved working groups, reflecting their shared interests in resolving overlapping issues.

@frivoal
Copy link
Collaborator Author

frivoal commented May 3, 2023

If it's purely descriptive, I think it might belong in /Guide rather than in the Process (which people are complaining it is already too long). An addition to the Process is most justified if we do want to add some rules about what someone must do to charter such work, or what happens when each working group working on a joint deliverable has internal consensus but that there isn't consensus between the two groups, or anything that RFC2119 language of some kind.

@marcoscaceres
Copy link
Member

I guess it’s up to @ericsiow as OP to clarify what “concept formally defined” means to them exactly. I’ve never encountered any issues doing a joint deliverable, so unsure what the ask is aside from the definition I gave above.

@anssiko
Copy link
Member

anssiko commented May 4, 2023

Thanks @frivoal. It has been brought to my attention this issue has been discussed in #2 earlier. That historical context suggests this is not a purely descriptive issue as you alluded. There are many facets to this issue.

Drawing from my experiences as the chair of multiple WGs with diverse participation, two WGs that aspire to take on a joint deliverable are likely to have been chartered with different:

  • Scope
  • Out of Scope

And may have been chartered with different:

  • Success Criteria
  • Decision Policy

What follows is that it is undefined what happens if the two WGs, for example:

  • disagree on whether a proposed new feature is in scope (or out of scope) of a joint deliverable,
  • disagree on whether the joint deliverable meets (or not) the success criteria for advancement on the Rec Track,
  • disagree on which decision policy is used for the joint deliverable

It seems like a partial solution here would be to say that in case of disagreement, the W3C Process Document (or other authoritative document referenced by it) prevails. For example, the Rec Track transition requirements are well-defined in the W3C Process Document. Some other aspects may require additional RFC2119 language.

Based on #2 it also looks like some PP interactions in this context are undefined (IANAL).

(Btw. Thanks to the entire Process CG for your heroic effort that was the latest update!)

@dwsinger
Copy link
Contributor

dwsinger commented May 4, 2023

I think we felt that the PP applies to every deliverable of a working group, joint or not. Is there something unclear?

@dwsinger
Copy link
Contributor

dwsinger commented May 4, 2023

I suspect that we should say that the joint deliverable must remain in scope for both working groups, and that to advance both groups must decide and it must meet the success criteria of both groups.

@nigelmegitt
Copy link
Contributor

I think we felt that the PP applies to every deliverable of a working group, joint or not. Is there something unclear?

Presumably every member of the union of the set of members of each of the joint WGs is covered by the IPR requirements. In a hypothetical pair of WGs, let's say a subset of members of each group want to contribute to a Rec track report. There may be other members of either group who are brought in to the IPR requirements if it is made jointly by both groups. That could be a reason in favour or against doing that, but it would be good to make sure that everyone is aware.

@dwsinger
Copy link
Contributor

dwsinger commented May 4, 2023

@nigelmegitt I think that's why it has to be in the charter (and scope), listed as a deliverable, of both WGs

@plehegar
Copy link
Member

There is an intent to refine joint deliverables in the upcoming DAS charter.

@anssiko
Copy link
Member

anssiko commented Jun 26, 2023

To: AB and Process CG experts watching:

We've been made aware of #2 and ISSUE-93 -- any other discussions either in public or Member-only space we should be informed of? Thanks for letting us peek into your institutional memory.

I'm tagging @chaals who was part of the discussions in 2014 and has sticked around long enough to have accumulated knowledge in this space that is second to none.

@chaals
Copy link
Contributor

chaals commented Jun 26, 2023

I can't think of other discussion that's generically public, but it is worth looking for the groups who have produced or worked on joint deliverables.

In practice I think you've identified the potential pain points already.

@plehegar
Copy link
Member

As a general principle, each Working Group must follow its charter, including in the case of joint deliverables.

  1. If one of the Working Groups decides to drop a joint deliverable from its charter, only the charters of the remaining Working Groups involved in that joint deliverable are applicable.
  2. A Working Group cannot publish features on the W3C standard track that are outside of its scope. The scope of the narrower Working Group prevails in joint deliverables. So any feature which is out of scope for one of the Working Groups involved cannot appear in the joint deliverable.
  3. Each Working Group is obligated to follow its Success criteria requirements. So the success criteria of the joint deliverable is the combination of the success criteria of all of the Working Groups involved. Any conflict between the success criteria section ought to be resolved before the charters are approved.
  4. Each Working Group must follow its decision policy. If conflicting decisions are recorded, the Working Groups need to resolved their differences. So, for example, all of the Working Groups must agree to publish any revision in order for the publication to happen.

@plehegar plehegar self-assigned this Sep 14, 2023
@plehegar
Copy link
Member

The current thinking is that this is purely an update of the Guide. There is no need to update the Process for this.

@plehegar
Copy link
Member

See PR w3c/Guide#182

I also added the handling of:

  • the patent policy. Since we did have different patent polices in our past (during the transition from PP2004 and PP2020), I clarified that the PP section of the 2 charters need to match.
  • licensing. We do have 2 licenses for documents. Again, those need to match.

@frivoal also mentions that we'll need to handle additional cases of group coordination:

  • what happens if one of the Groups is the TAG?
  • what happens if one of the Groups is a CG?

Finally, we should consider moving this issue to the Guide repo.

@frivoal
Copy link
Collaborator Author

frivoal commented Sep 15, 2023

@frivoal also mentions that we'll need to handle additional cases of group coordination:

  • what happens if one of the Groups is the TAG?
  • what happens if one of the Groups is a CG?

I think that the answer is if/when we do such things, we're bound by the charter of the WG, since that's the only Group that's actually allowed to publish things on the REC track. Participants beyond the WG (TAG members, CG members, what have you) will need to abide by https://www.w3.org/2023/Process-20230612/#contributor-license to make contributions

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
AC-review Raised during the AC review phase, or otherwise intended to be treated then. Closed: Out of Scope
Projects
None yet
Development

Successfully merging a pull request may close this issue.

7 participants