14:45:01 RRSAgent has joined #horizontal 14:45:05 logging to https://www.w3.org/2024/09/25-horizontal-irc 14:45:05 RRSAgent, do not leave 14:45:06 RRSAgent, make logs public 14:45:07 Meeting: Horizontal reviews at W3C and beyond 14:45:07 Chair: Philippe Le Hegaret 14:45:07 Agenda: https://github.com/w3c/tpac2024-breakouts/issues/65 14:45:07 Zakim has joined #horizontal 14:45:08 Zakim, clear agenda 14:45:08 agenda cleared 14:45:08 Zakim, agenda+ Pick a scribe 14:45:09 agendum 1 added 14:45:09 Zakim, agenda+ Reminders: code of conduct, health policies, recorded session policy 14:45:09 agendum 2 added 14:45:09 Zakim, agenda+ Goal of this session 14:45:10 agendum 3 added 14:45:10 Zakim, agenda+ Discussion 14:45:10 agendum 4 added 14:45:10 Zakim, agenda+ Next steps / where discussion continues 14:45:11 agendum 5 added 14:45:11 tpac-breakout-bot has left #horizontal 14:45:15 tidoust has joined #horizontal 14:57:19 tpac-breakout-bot has joined #horizontal 14:57:21 RRSAgent, do not leave 14:57:21 RRSAgent, make logs public 14:57:23 Meeting: Horizontal reviews at W3C and beyond 14:57:23 Chair: Philippe Le Hegaret 14:57:23 Agenda: https://github.com/w3c/tpac2024-breakouts/issues/65 14:57:23 Zakim, clear agenda 14:57:23 agenda cleared 14:57:23 Zakim, agenda+ Pick a scribe 14:57:25 agendum 1 added 14:57:25 Zakim, agenda+ Reminders: code of conduct, health policies, recorded session policy 14:57:25 agendum 2 added 14:57:25 Zakim, agenda+ Goal of this session 14:57:26 agendum 3 added 14:57:26 Zakim, agenda+ Discussion 14:57:26 agendum 4 added 14:57:26 Zakim, agenda+ Next steps / where discussion continues 14:57:27 agendum 5 added 14:57:28 tpac-breakout-bot has left #horizontal 17:02:14 giacomo-petri has joined #horizontal 17:02:46 giacomo-petri has left #horizontal 21:42:57 Jennie_Delisi has joined #horizontal 22:46:08 addison has joined #horizontal 22:46:25 addison has joined #horizontal 22:54:56 plh has joined #horizontal 22:55:45 Slides: https://www.w3.org/2024/Talks/TPAC/horizontal-reviews/ 22:56:12 addison has joined #horizontal 22:56:16 present+ 22:59:23 present+ 23:00:12 xfq has joined #horizontal 23:00:55 dschuff has joined #horizontal 23:02:10 present+ 23:03:19 simone has joined #horizontal 23:03:28 reillyg has joined #horizontal 23:03:30 present+ 23:03:32 present+ 23:03:35 Bert has joined #horizontal 23:03:36 Slides: https://www.w3.org/2024/Talks/TPAC/horizontal-reviews/ 23:03:38 matatk has joined #horizontal 23:03:40 present+ 23:03:44 present+ 23:03:48 Roy has joined #horizontal 23:03:50 present+ 23:04:13 tnitot has joined #horizontal 23:04:18 atsushi has joined #horizontal 23:04:35 chaals has joined #horizontal 23:04:42 scribe: chaals 23:04:59 Chuck has joined #horizontal 23:05:03 PLH: We try to sit down with chairs of horizontal groups at TPAC. Didn't manage last year :( 23:05:09 present+ 23:05:14 ... I have some slides, and lets chat. 23:06:02 present+ chaals 23:06:07 PLH: why do we care? We have a vision, of the web being good for everyone, safe, and one thing. 23:06:24 ... that drives horizontal review to try and make those things true 23:06:54 slideset: https://www.w3.org/2024/Talks/TPAC/horizontal-reviews/ 23:07:38 ... we have two documents talking about horizontal review. The Process says "wide review", but it is understaood that our specific ideas of Horizontal review are a required part of that, as described in the /Guide 23:07:53 ... We have been tracking a lot of issues to try and ensure we don't forget them 23:08:05 jyasskin has joined #horizontal 23:08:08 present+ 23:08:22 ... Each group manages issues internally according to their processes, but it is all visible and trackable. 23:08:27 q? 23:08:40 -> https://www.w3.org/Guide/documentreview/ How to do Wide Review 23:08:45 present+ 23:08:55 PLH: This also works on top of whatwg repos, and is based on standard labels. 23:09:33 present+ 23:09:51 ... We have different views, to see what the status is for any given spec, across different types of horizontal review. 23:10:22 https://www.w3.org/PM/horizontal/ 23:10:32 ... Different groups can mark some issue as relevant to horizontal review. 23:10:43 -> https://www.w3.org/PM/horizontal/ Horizontal dashboard 23:10:56 [Slide: discussion] 23:11:19 PLH: Are we missing anything that we need to make this work well? What are the pain points, are there ways to smooth them? 23:12:21 ... We have principles and increasing expectations for them to be followed. We don't expect all groups to start as experts in all areas, but we do try to help them learn. 23:12:59 PLH: We review W3C specifications, some groups look beyond W3C specs (e.g. TAG, i18n, ...) 23:13:32 ... Should we provide more effort for specifications that are produced outside W3C, despite the resource constraints we already suffer from? 23:13:39 q? 23:13:40 q+ 23:13:44 ... You are also welcome to bring up any other topics. 23:14:01 q+ jyasskin to cover 1) Reviewing at FPWD or charter source docs, not just CR? 2) Distinguishing individual reviews from group-consensus reviews? 23:14:43 matatk: (TAG member, co-chair of Accessible Platform Architectures group). Speaking for APA we really love the github process, and documentation from i18n. 23:15:14 ... We're using and developing a CLI front-end for this, and I want to thank Bert for helping with some programming. 23:16:07 ... Historically we use a wiki to track all the reviews we have done of a spec, that in some cases goes back decades of history. Now the spec labels are super-helpful, so we shouldn't need to do the extra admin in the wiki 23:16:33 ... except when a spec changes its name, we lose that history, and the spec labels don't handle that. 23:17:18 PLH: We don't do that, but the information needed exists. Note I cannot track review requests yet. We can track issues, but I would like to track requests. 23:17:50 matatk: couldn't we search issues with the relevant label? Can we just stick with the initial label? 23:17:57 jyasskin: You can rename the label 23:18:08 PLH: You have specs that merge, or split, as well as just re-naming 23:18:29 ... that will be harder but we will see how we can build on the information, because at least we have it. 23:18:29 q? 23:18:33 ack matatk 23:19:09 Roy: We have an annual report on how much we review, so making it easier to track that, and include times, would help 23:19:12 PLH: Issues have timestamps. 23:19:46 Roy: We don't have a principle to provide annual report. Some documents have review that go over more than one year. 23:19:57 q+ to talk about spec renaming 23:20:29 ... Would be nice to have more statistical reporting available. Wondering also if other groups want to be able to do that. 23:20:31 q? 23:21:11 addison: Sometimes we do that but we don't have it as a formal procedure. We have tooling in our own review radar that we can use to get that. It can be interesting to look backwards, e.g. fnding out a spec hasn't been reviewed for years. 23:21:26 ... There is also a pre-github history, and we have less insight into that. 23:21:37 ack jyasskin 23:21:37 jyasskin, you wanted to cover 1) Reviewing at FPWD or charter source docs, not just CR? 2) Distinguishing individual reviews from group-consensus reviews? 23:22:05 jyasskin: painpoints: If you file an issue on a repo, as a random community person you need an authorised person to add a tracker label. 23:22:13 ... Would be nice if we can change that. 23:22:45 PLH: got a request to create a triage team, giving a wider group access to manage that. I will punish your good deed by invovling you in the work of improving it. 23:22:53 * There is a person asking to be in queue who is not on IRC: Christine Runnegar 23:23:04 jyasskin: In TAG and PING, we need somewhere that a review can be written down before the group has consensus on the content. 23:23:21 ... would be good for someone to write a review from that perspective that won't be confused with the group's formal review. 23:23:28 q+ Christine 23:23:44 q+ to respond to jyasskin about 'pending' and timing 23:23:48 jyasskin: Officially wide review is required before candidate rec. If you do them around that point they might be shipped, and it is hard to change by then. 23:23:52 qq+ 23:24:11 ack chaals 23:24:12 chaals, you wanted to react to jyasskin 23:24:26 qq+ 23:24:26 chaals: You have to have wide review to get to cnadidate rec, but you are encouraged to go through wide review for changes. 23:24:33 q+ Janina 23:24:59 chaals: We want to know when you've made some substantial change, we'd like to look at it when you have shaken it into the spec but before it gets into business process. 23:25:15 chaals: This is ... chairs apply process that is laid out before them. 23:25:19 q+ to ask about change log best practices 23:25:27 scribe+ Chuck 23:25:34 rrsagent, make minutes 23:25:35 I have made the request to generate https://www.w3.org/2024/09/25-horizontal-minutes.html xfq 23:25:45 ack simone 23:25:45 simone, you wanted to react to chaals 23:25:49 s/by then/by then. SHould we be getting wide review earlier? 23:26:39 ack xfq 23:26:39 xfq, you wanted to talk about spec renaming 23:26:40 simone: We have in the FedID charter that we will call for horizontal review at FPWD, and we publish Working Drafts and look for horizontal review. So it is managed in theory... 23:27:35 -> https://www.w3.org/2024/03/wg-fedid-charter.html -> FedID charter [[Invitation for review must be issued during each major standards-track document transition, including FPWD]] 23:27:37 xfq: (Working on i18n). Regarding spec renaming, if the repo changes, we use a "moved" label to help carry the info across (with some manual extra work) 23:27:52 ack christine 23:28:21 christine: (Ping cochair) Thank you to all of the work done by Team to facilitate horizontal reviews. It can be painful, but it helps a lot. 23:28:23 +1000 23:29:04 ... Horiontal review is key to W3C standards' quality, and there are not a lot of us. Think we should be focusing on getting more commitment across the community, to help do the work. 23:29:32 ... As well as documenting reviews each year, would be nice to document the improvements that are due to responses to horizontal review 23:29:35 s/Horiontal/Horizontal 23:29:50 +1 thank you Team :-) 23:29:55 ... Yes, we should have a robust discussion about reviewing all standards, not just the new ones that are coming through. 23:29:55 ack addison 23:29:55 addison, you wanted to respond to jyasskin about 'pending' and timing 23:30:44 addison: (i18n chair). In our group we use a pending label to allow people to record comments, and keep them to the WG before we put them into the relevant spec group's repo. That way we can track what we do internally and keep a record. That is an approach to consider. 23:31:40 addison: Totatlly agree that early review is better. For years the challenge has been to get the review requests, but I would love to have more proactive calls for review from as soon as people have sketched a design, rather than assuming it's fine and waiting until the spec is baked before asking us when they can't realistically respond 23:31:40 effectively. 23:32:03 ... So far, the issue has been just getting review calls, and getting responses that we think are reasonable. 23:32:04 ack janina 23:32:24 Some docs from i18n on wide review: https://www.w3.org/Guide/documentreview/ (not sure if this is the specific one that covers raising 'draft/pre-consensus' issues before the group posts them (which addison mentioned) but they do have specific docs on that. 23:33:32 janina: (APA co-chair). I am happy we have CGs, but I am starting to be concerned that there is no real review on their reports. If they move to WG we can pick up the work there. We don't review Notes or drafts, in general. But I was terrified when I learned a government was going to point to a CG report in a regulation - for me that is a bad 23:33:32 precedent, and I don't know if we should be more strict about what we say about a CG report without horizontal review. 23:33:45 PLH: Short answer is "we don't want to have that happen, at all". 23:33:52 how i18n do reviews: https://www.w3.org/International/i18n-activity/guidelines/review-instructions 23:34:32 q+ the friendly horizontal, also 'close?' 23:34:32 ... We had a session on CG processes, we have people working on this question in W3C. We don't encourage CGs to ask for horizontal review - we could encourage more of it if you are ready to receive more review requests... 23:34:44 Janina: I understand the problem there... 23:34:46 ack matatk 23:34:46 matatk, you wanted to ask about change log best practices 23:34:47 thanks xfq, that's the doc I was referring to - may go some way to answer jyasskin's query 23:34:51 q+ 23:35:05 Chuck has joined #horizontal 23:35:28 matatk: One thing we find helpful is when a spec, especially a long-running one, has a human-written curated changelog (not just a pointer to github commits). 23:35:29 s/effectively./... effectively. 23:35:32 ... These are so helpful. 23:35:46 [chaals: +1000 to matatk] 23:35:51 s/precedent,/... precedent, 23:36:06 yeah, CSS does a good job of recording changes 23:36:24 matatk: This isn't a coding/tooling issue, we really want some proper information that is curated. Maybe we should have some best practices about clarifying changes and writing useful changelogs. 23:36:31 https://github.com/w3c/w3c.github.io/pull/107 23:36:47 PLH: Issue 107 talks about promoting commit messaging conventions. That can start to help. 23:37:03 Vlad has joined #horizontal 23:37:36 q? 23:37:38 ... There is educating editors, which is challenging, people can use github labels to help. We don't require good changelogs, some groups do it. We could do more to encourage that to simplify the life of horizontal groups. 23:37:39 ack addison 23:37:46 q+ 23:37:50 q+ to ask about issue names/linking for tracker issues 23:38:22 addison: no horizontal meeting in Seville, but you and I talked there. We made some changes to transition request behaviour then, which I think are important to all horizontals. 23:38:46 ... Things would go through CR with open horizontal issues, inreturn for a commitment to closing issues effectively. I thikn that is a good hygiene step. 23:38:52 s/inreturn/in return/ 23:39:03 ... This also makes PLH's job easier too. 23:39:28 q+ 23:39:47 addison: How do we get earlier review requests and have friendly relationships to WGs, insterad of being seen as a drag on productivity. We can be seen as being a blocker to get through, rather than a support to get better. 23:39:56 ack vlad 23:40:16 s/I talked there/I talked to PLH there 23:40:34 vlad: Want to reiterate how useful the reviews were for us on @@ spec. We started them when we produced FPWD, and the comments motivated us to redesign substantially 23:40:46 s/@@/Incremental Font Transfer/ 23:41:45 ... and submitted that again, to positive review comments. The reviews uncovered issues that none of the group members had recognised, which led to substantial changes, that made the technology we produced much more web-friendly. If we had waited to the end of the process, the changes would not have happened and we would just have ublished 23:41:45 something that wasn't nearly as good. 23:41:54 s/ublished/published 23:41:56 ack mat 23:41:56 matatk, you wanted to ask about issue names/linking for tracker issues 23:43:03 matatk: Minor quality of life thing, for issues where there are issues across trackers, called something like accessibility review - makes great sense to the source repository, but since that's most of what we do it is not a helpul naming in our group. 23:43:14 ... Do issue titles have to be the same, or can we rename them? 23:43:30 PLH: Rename away - the link between the two issues is the key, not the name. 23:43:39 matatk: Oh, Hooray! 23:44:10 PLH: Credit to i18n for getting that right. It will re-use the title automatically, but so long as you don't change the first link in the comment, you can change the title happily. 23:44:22 ack plh 23:44:35 matatk: We are now out of excuses to be slow and will become more productive and efficient with fewer resources and more work to do. 23:44:59 q+ 23:45:13 PLH: Early review is always good. There are always groups we forget, until late. The fact is, when the groups release FPWD, that is a signal to know that something new is coming up. 23:45:15 q+ Janina 23:45:15 q+ 23:45:17 qq+ 23:45:27 ... That can be a way to catch things early. 23:45:49 ... We send those signals through tools, and can tailor them to send a singing telegram if that's what you need. 23:46:12 ... Same thing with charters, and when you should look at a charter that is being developed. 23:46:49 ... Getting a lot fo signals brings up a new set of issues about triage... 23:46:49 ack chaals 23:46:49 chaals, you wanted to react to plh 23:47:07 chaals: It's good to be sending those signals. It's important the chairs and editors understand the process. 23:47:42 chaals: fpwd's vary in maturity across working groups. It's not the horizontal review groups that drive that. 23:47:58 ack reilly 23:48:30 reillyg: (device sensor co-chair). I don't know if there is a process or expectation change, but I like the idea of a review before a group adopts something new as a deliverable in a charter. 23:48:43 zakim, close the queue 23:48:43 ok, plh, the speaker queue is closed 23:48:51 ... It's better than getting the review in form of an formal objection to a charter proposal. 23:49:01 ... And less adversarial. 23:49:09 [+100] 23:49:10 ack janina 23:50:34 Janina: Tooling issue, we have task forces, one joint with Accessible Guidelines WG which is COGA - people with neurodiversity. They REALLY struggle with github and how to make it work, and they are heavily reliant on google docs at the moment. They like the information you can get from github, but find it incredibly challenging and expensive to 23:50:35 work with github. 23:50:58 s/work/... work 23:51:07 matatk: With our dashboards we can give clear overviews, but there are real accessibility problems for people trying to deal with some of the interfaces we expect people to use. 23:51:16 ack simone 23:51:17 -> https://github.com/w3c-fedid/Administration/blob/main/proposals-CG-WG.md CG/WG process 23:51:31 s/something that wasn't/... something that wasn't 23:52:39 simone: When we are going to adopt a CG deliverable, there was an experimental process. We are trying to do that with FedID. We got an objection against adopting CG work. We had internal discussion about asking for review before adoption, but would be helpful to get more discussion earlier, in a somewhat systematic way. 23:52:48 reillyg has left #horizontal 23:52:58 PLH: Thank you all, I would still like feedback on going beyond W3C specifications. 23:53:17 +1 to go beyond 23:53:27 ... I will never be thankful enough for all the work that Horizontal review produces and the value it gives us. Now we are late, so... 23:53:30 [Adjourned] 23:53:33 rrsagent, make minutes 23:53:34 I have made the request to generate https://www.w3.org/2024/09/25-horizontal-minutes.html xfq 23:53:46 [Chaals: Thanks Bert for scribe help]