You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: guide-for-tag-members.md
+19-19Lines changed: 19 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,26 +20,26 @@ This document defines the mission of the TAG as follows:
20
20
To achieve that, the TAG produce several kinds of work, as outlined below:
21
21
22
22
*[Design reviews](#design-reviews) are mainly addressing points 2 and 3.
23
-
*[Findings](#findings) and [Guides](#guides-and-other-documents) are helpful for specifications authors and are addressing point 1 and 2.
23
+
*[Findings](#findings) and [Guides](#guides-and-other-documents) are helpful for specifications authors and are addressing point 1 and 2.
24
24
*[Blog posts, notes and other publications](#blog-posts-notes-and-other-publications) are more diverse and can apply to everything.
25
25
26
-
As the TAG have an overview of all the technologies produced at W3C, through its design reviews(#design-reviews), it is in a perfect position to identify possible mismatches and deeper architectural issues.
26
+
As the TAG have an overview of all the technologies produced at W3C, through its design reviews(#design-reviews), it is in a perfect position to identify possible mismatches and deeper architectural issues.
27
27
The TAG is also reviewing specifications coming from other organisations, like IETF, TC39 or WhatWG when requested.
28
28
29
29
Members of the TAG are part of [W3C Councils](https://www.w3.org/policies/process/#w3c-council) handling [Submission Appeals](https://www.w3.org/policies/process/#SubmissionNo) and [Formal Objections](https://www.w3.org/policies/process/#FormalObjection); see [Councils Guide](https://www.w3.org/guide/council/council.html).
30
30
31
31
As member of an [elected group](https://www.w3.org/policies/process/#elected-groups), TAG participants are expected to follow a set of [communication guidelines](https://www.w3.org/guide/other/elected-body-communication-guidelines.html).
32
32
33
-
## What we produce
33
+
## What we produce
34
34
35
35
### Design reviews
36
36
37
37
We help developers of web features and specifications by providing feedback and reviews. We have more info on this process [here](https://tag.w3.org/workmode/design-reviews/).
38
38
39
-
We like to see these ideas an an early stage (while they’re being designed).
39
+
We like to see these ideas an an early stage (while they’re being designed).
40
40
Spec authors who want our help open issues in our design review repo on GitHub.
41
41
42
-
We ask spec authors to create an [explainer](https://tag.w3.org/explainers/), to help us understand what they want to accomplish and what other solutions they have considered.
42
+
We ask spec authors to create an [explainer](https://tag.w3.org/explainers/), to help us understand what they want to accomplish and what other solutions they have considered.
43
43
44
44
We tend to look for issues like:
45
45
@@ -50,19 +50,19 @@ We tend to look for issues like:
50
50
51
51
#### Lifecycle of a Design Review
52
52
53
-
Design reviews are generally requested by spec authors, spec editors or group chairs. The goal of a design review is to provide useful review feedback that aids the deisgn of the spec in question and to close the review issue once that feedback has been received and ideally acted upon. Requestors fill in one of the templates (early design review, design review, or dispute resolution). These are initially marked as untriaged. TAG will triage these untriaged issues at least once a week during the regular plenary calls. Requestors will also be asked to create an explainer, fill in answers to the privacy & security questionnaire, and indicate that they have read the Design Principles document. The triage process involves assigning ideally 2+ people to work on the issue going forward, assigning labels as appropriate and assigning a **milestone**. In the design review repo we use milestones to indicate which week in the future we will discuss (and ideally try to resolve) this issue. Once assigned to a milestone (week), that issue will become part of the agenda for that week and will be assigned to a breakout based on who is assigned to the issue. During the breakout call, the issue will be discussed and progressed towards resolution. TAG members will write feedback on the issue and review comments and feedback that have been left on the issue, leave feedback on the issues for the spec in question, etc... We also have a "private repo" for draft comments that allows us to collaborate asynchronously on more substantive feedback when needed. We will look for signals that the feedback has been received and understood and ideally acted upon. When the members of a breakout group decide the issue can be closed, the issue is marked as "propose closed" (with a label). We will then review during the read-outs section of the plenary call for that week and take a decision to close and what resolution label to mark it with (e.g. resolution: satisfied). One of the owners of the issue will generally write a closing comment and close the issue. During this process it may sometimes be necessary to have more detailed discussions with the requestors of the review - e.g. by inviting them to a breakout.
53
+
Design reviews are generally requested by spec authors, spec editors or group chairs. The goal of a design review is to provide useful review feedback that aids the deisgn of the spec in question and to close the review issue once that feedback has been received and ideally acted upon. Requestors fill in one of the templates (early design review, design review, or dispute resolution). These are initially marked as untriaged. TAG will triage these untriaged issues at least once a week during the regular plenary calls. Requestors will also be asked to create an explainer, fill in answers to the privacy & security questionnaire, and indicate that they have read the Design Principles document. The triage process involves assigning ideally 2+ people to work on the issue going forward, assigning labels as appropriate and assigning a **milestone**. In the design review repo we use milestones to indicate which week in the future we will discuss (and ideally try to resolve) this issue. Once assigned to a milestone (week), that issue will become part of the agenda for that week and will be assigned to a breakout based on who is assigned to the issue. During the breakout call, the issue will be discussed and progressed towards resolution. TAG members will write feedback on the issue and review comments and feedback that have been left on the issue, leave feedback on the issues for the spec in question, etc... We also have a "private repo" for draft comments that allows us to collaborate asynchronously on more substantive feedback when needed. We will look for signals that the feedback has been received and understood and ideally acted upon. When the members of a breakout group decide the issue can be closed, the issue is marked as "propose closed" (with a label). We will then review during the read-outs section of the plenary call for that week and take a decision to close and what resolution label to mark it with (e.g. resolution: satisfied). One of the owners of the issue will generally write a closing comment and close the issue. During this process it may sometimes be necessary to have more detailed discussions with the requestors of the review - e.g. by inviting them to a breakout.
54
54
55
55
### Findings
56
56
57
-
When we want to make a statement on a particular topical issue, or a trend that we see, we produce a finding.
57
+
When we want to make a statement on a particular topical issue, or a trend that we see, we produce a finding.
58
58
Usually a TAG member proposes a new finding, and if the group agrees, one or more members are the editors and they managing the drafting with the entire TAG.
59
59
60
60
We keep a [list of findings](https://tag.w3.org/findings/) on our website.
61
61
62
62
### Guides and other documents
63
63
64
-
When we decide that it would be helpful for spec authors or implementors to have additional information on something tricky, we write a guide.
65
-
These often come from trends we identify through our design reviews.
64
+
When we decide that it would be helpful for spec authors or implementors to have additional information on something tricky, we write a guide.
65
+
These often come from trends we identify through our design reviews.
66
66
67
67
Our core guidlines document is the [Web Platform Design Principles](https://www.w3.org/TR/design-principles).
68
68
@@ -72,7 +72,7 @@ We havs also recently produced an [Ethical Web Principles](https://www.w3.org/TR
72
72
73
73
### Blog posts
74
74
75
-
We have these additional methods of publishing our work, which we use from time to time.
75
+
We have these additional methods of publishing our work, which we use from time to time.
76
76
We occasionally describe findings in plain language with a blog post, like [this one explaining the Ethical Web Principles](https://www.w3.org/blog/2024/ethical-web-principles-building-a-better-web/).
77
77
78
78
## How we work
@@ -85,18 +85,18 @@ As of our December 2024 Face-to-face, we are trying to capture and organize our
85
85
86
86
Most of our interaction with the web community happens on Github, either in our repos or in the repos of features we are helping.
87
87
88
-
Each of us also engages directly with the community through social media, blogging, and giving talks about our work.
88
+
Each of us also engages directly with the community through social media, blogging, and giving talks about our work.
89
89
90
-
We work in the open.
91
-
All of our meetings are minuted, and [the minutes are publicly available](https://github.com/w3ctag/meetings).
92
-
We also try to provide links to relevant meeting minutes in our Github issues, so that the spec authors and other community members can find our discussions.
90
+
We work in the open.
91
+
All of our meetings are minuted, and [the minutes are publicly available](https://github.com/w3ctag/meetings).
92
+
We also try to provide links to relevant meeting minutes in our Github issues, so that the spec authors and other community members can find our discussions.
93
93
94
94
### Weekly participation
95
95
96
-
We have three kinds of weeks: design-review weeks (three out of every four weeks) and bigger picture weeks (one out of every four weeks).
97
-
We also have face-to-face weeks, which interrupt the cycle — and are in the next section.
96
+
We have three kinds of weeks: design-review weeks (three out of every four weeks) and bigger picture weeks (one out of every four weeks).
97
+
We also have face-to-face weeks, which interrupt the cycle — and are in the next section.
98
98
99
-
### Each TAG member attends 2 breakouts
99
+
### Each TAG member attends 2 breakouts
100
100
101
101
We currently have 3 breakout sessions each week to accomodate different time zones. These breakouts happen over video call and are organized via the W3C calendar system. TAG members should try to attend 2 out of the 3.
102
102
@@ -119,7 +119,7 @@ Each of us should allocate some time (at least three hours beyond the meeting ti
119
119
120
120
### Face-to-face (F2F) meetings
121
121
122
-
Occationally we will meet face-to-face for three days to work together.
122
+
Occationally we will meet face-to-face for three days to work together.
123
123
124
124
We create the agenda for that time at the beginning of the meeting.
125
125
@@ -133,7 +133,7 @@ We will make every effort at face-to-face meetings to accomodate remote particip
133
133
134
134
We all tey to attend TPAC, so that we directly spend time with working groups and interest groups, to learn what they are up to and to provide more immediate feedback and support.
135
135
136
-
We normally have brief TAG meetings, usually at the beginning and the end of the week, so that we can coordinate what we will attend and try to cover as many groups as possible.
136
+
We normally have brief TAG meetings, usually at the beginning and the end of the week, so that we can coordinate what we will attend and try to cover as many groups as possible.
0 commit comments