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

Proposal for WoT WG and IG liaison #93

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
88 changes: 87 additions & 1 deletion liaisons.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,89 @@
## Liaisons to the W3C WoT Community Group

To be decided
The liaisons of the W3C WoT CG are not explicitly outlined in the CG charter; however, they are documented in this document.
This markdown document details each liaison and explains the extent of its scope.

Current liaisons:

- [Web of Things Interest and Working Group](#web-of-things-interest-and-working-group)

> [!NOTE]
> The key words MAY, MUST, MUST NOT, RECOMMENDED, SHOULD, and SHOULD NOT in this document are to be interpreted as described in [BCP 14](https://www.rfc-editor.org/info/bcp14) [RFC2119](https://www.rfc-editor.org/rfc/rfc2119) [RFC8174](https://www.rfc-editor.org/rfc/rfc8174) when, and only when, they appear in all capitals, as shown here.

### Web of Things Interest and Working Group

> [!NOTE]
> This is only a draft until a resolution is reached in both WG/IG and CG. These will be documented via email.
> The CG Charter MAY need changes to satisfy the liaison. Agreeing on this document implies agreeing on the corresponding CG Charter changes.

> The content below, until the horizontal line, is composed by the CG based on inputs from the TPAC Joint Meeting, CG Internal Meeting, and Office Hours inputs. Please refer to [Original Input](#original-input) for the discussion results form W3C TPAC 2023.

The WoT IG/WG liaison is categorized based on the nature of collaboration.
The categories below explain the scope of collaboration.

Note: WG/IG collectively refers to both WoT Interest and Working Group, while CG pertains to the WoT CG.

#### Documents

If the CG intends to produce a document, it MUST adhere to the [W3C CLA](https://www.w3.org/community/about/process/cla/).
This mandates that the CG participants don't directly edit or open Pull Requests to change WG/IG documents.
Relevant WG/IG documents MAY incorporate content from CG reports following Section 9 of the [W3C CLA](https://www.w3.org/community/about/process/cla/).
Any CG document related to a WG/IG document type (e.g. use cases, bindings), MUST comply with the format and content requirements established by the WG/IG.
Deviating from these requirements requires explicit authorization from the WG/IG.
CG reports, as explained by the CG charter, MAY take the form of Markdown, HTML, or similar formats

Examples of document types pertinent to WG/IG, eligible as CG reports:

- Use cases
- Requirements
- Feature Proposals
- Bindings

#### Role of WoT CG

The role of the CG in this collaboration is categorized into two: facilitating a low entry barrier and engaging in outreach.

##### Ensuring a Low Entry for WoT Involvement

Considering the existence of membership fees for WG/IG participation, fostering more participants to exchange ideas on WoT-related topics becomes relevant.

CG participants CAN actively and openly exchange ideas on WoT-related topics within the CG, collaborate on non-normative CG reports, and experiment with the implementations of the WG/IG reports.

##### Outreach

The CG utilizes various channels under the CG administration to reach a broad audience interested in WoT, aligning with the low-entry barrier principle.

#### Events

The WG/IG collaborates on Plugfest events with the CG, thereby leveraging the community to garner a wider audience.
WG/IG MAY also engage in collaboration with other CGs and liaisons.
Joint meetings, such as Face to Face (F2F) and TPAC meetings, may be convened between WG/IG and the CG.

#### Test Cases

CG participants are permitted to contribute to the testing activity of the WG/IG Task Forces.
Contributions MUST adhere to WG requirements regarding quality, folder structure, file naming conventions, and other specifications.
The CG participants MUST contribute test cases to the CG GitHub repository.

---

#### Original Input

The part below is written together with IG/WG in the TPAC 2023 Joint Meeting.

Collaboration on the following topics:

- Bindings
- Use Cases
- Requirements
- Feedback on Draft Specifications
- Outreach of WG Activities
- Joint Activities such as Plugfests
- Contribution to WG test cases from CG Participants
- Feature Proposals

Further clarifications on the following points are being worked on:

- How the collaboration will work, what is the process
- Detailing what those topics mean
- Roles of the CG and WG participants per point/topic