18:02:53 RRSAgent has joined #aria-at 18:02:53 logging to https://www.w3.org/2021/05/20-aria-at-irc 18:02:56 Rich_Noah has joined #aria-at 18:03:03 Zakim has joined #aria-at 18:03:12 zakim, clear agenda 18:03:12 agenda cleared 18:03:21 rrsagent, make log public 18:03:49 MEETING: ARIA and Assistive Technologies Community Group and AP Dev Sprint Review 18:04:07 CHAIRS: Seth/James 18:04:15 rrsagent, make minutes 18:04:15 I have made the request to generate https://www.w3.org/2021/05/20-aria-at-minutes.html Matt_King 18:04:48 present+ 18:04:55 present+ 18:05:00 scribe: Matt_King 18:05:16 TOPIC: Sprint 6 review 18:05:20 jesdaigle has joined #aria-at 18:05:33 +present 18:05:56 present+ 18:06:22 Seth: sprint 6 completes in a week on May 28 18:06:32 sprint 7 is may 31 to june 11 18:07:21 Added graphQL and started work on control layer 18:07:34 that will have more of the business logic than prev version 18:08:02 Data model has more flexible set of entities to accommodate working mode changes. 18:08:45 Working on test renderer to fix outstanding issues around command sequences and reset button behavior. 18:08:59 Z hasdraft PR open, not quite ready for review. 18:09:15 Cleans up the test harness and documents the methods iwth jsdoc 18:10:01 Should have sig progress by end of sprint 6, but may not be complete depending on our new task we discussed last week related to generated files. 18:10:23 Generated file work is higher pri and might push out the renderer. 18:10:48 James: when to talk about the generated file issue with merge conflicts. 18:11:27 Seth: Z has investigated, we can talk about it during this hour if you like. 18:12:04 mk: better for us to talk about the details of that in this meeting. 18:12:30 seth: just opened issue today related to roles in the app 18:12:54 james: we can put that first on the agenda in the cg meeting next hour 18:13:13 TOPIC: Sprint 7 plan 18:13:38 Seth: highest pri item will be automation work flow and removing generated tests. 18:13:47 close to 10 days of work. 18:14:01 so will start in sprint 6 and finish in sprint 7 18:14:18 hopefully can eleminate the biggest merge conflict issues sooner than end of sprint 7. 18:14:35 Plan to use netifly to provide test preview. 18:15:05 Next on the list is work around aria-at app roles. 18:15:31 Need some change to how we manage roles in github teams. 18:15:56 Adding everyone to w3c org in github adds alot of overhead. 18:16:06 Not sure we want that overhead or that it is appropriate. 18:16:31 Next is work to update the test queue page. 18:17:10 Allow test queue to be managed as individual items; add/remove individual rows. 18:17:36 Right now every plan in the queue needs o be on the same version, which doesn't scale. 18:17:54 New queue would decouple the queue from the github repo version/commit. 18:18:17 Might need to talk about having 2 version of same plan in queue at the same time. 18:19:36 mk: want to talk about how we render versions of tests. 18:19:45 seth: added a version field to the data model 18:20:45 James: could have it be free form field 18:20:57 rather than a number or semantic version. 18:22:30 mk: would be nice to have a number, date, and optional name/description for the version 18:24:05 james: semantic versioning could help with small changes like typo fixes. 18:25:27 seth: as soon as we rely on the version number being human generated, we need some checks to make sure the numbers are updated when they should be 18:26:52 seth: in wpt.fyi, any time a test is changed, it needs to be re-run to ensure it doesn't make material changes 18:27:16 If we use semantic versioning, should it be tied to when a test needs to be re-run 18:28:07 james: any change, even minor, needs to be signed off. We don't necessarily want to make it go all the way back to draft just for a typo fix. 18:36:51 james: right now we don't have a way to name a test plan 18:36:58 it comes from a directory 18:37:28 This should be a test plan level concern 18:37:40 We coudl treat a test plan like a package 18:38:39 seth: It would be good in the future if the app had more of a generica pproach to importing tests 18:38:47 almost like a webhook 18:39:12 So, we could support multiple sources and the changes in the repo could trigger the import. 18:39:25 james: there's iopportunity to do it bit by bit. 18:39:45 Coudl start with splitting up references.csv 18:40:27 We could also moving the naming of plans out of support.json. 18:42:29 seth: much of references.csv is apg specific. Can we make that more generic. 18:42:51 or, if we support multiple sources, could each source have its own metadata 18:43:32 james: I think it should be example driven 18:44:34 let's not try to be excessively generic 18:44:55 seth: there are 2 important links for APG, design pattern and example 18:46:05 seth: let's start an issue and come up with a package description that describes a test plan package with an eye on supporting sources beyond APG. 18:46:20 James: keep in mind all the shared resources 18:49:15 TOPIC: Plan for automated work flow and generated test files 18:49:35 Seth: We discussed how merge conflicts are acute issue. 18:49:52 One problem is that we have generated files in repo and CLI has verbose logging. 18:51:02 Proposal is to first put verbose logging behind a flag and have a more clear summary of errors at the end 18:51:23 james: as long as it is at the end, that is super helpful. 18:51:37 seth: that's quick fix to one problem. 18:52:30 Seth: next is to add a validate flag that doesn't generate any output 18:53:01 z: there is existing script that generate tests for a single direcory 18:53:16 james: there is no npm equivalent for that 18:54:03 seth: next is to turn on netifly deploy previews 18:54:27 Looked at other providers, but netifly is good balance of simplicity and fexibility 18:54:32 can work with branches 18:54:42 it is fast and keep the html files around. 18:54:59 they also partner with OS projects 18:55:23 Turning this on would give every PR a link that shows what the test would look like 18:56:52 seth: the app is loading files through github 18:57:17 In the new model, we would treat netlifly as a build bot 19:04:42 James: if netlify is short term solution, can we make sure the w3.org site is proxied to netlify somehow 19:04:55 michael_fairchild has joined #aria-at 19:05:15 z: think we can do that. today we use rawgit proxy so could change over 19:05:47 James: long term, we may not want to reply on outside source for rendered assets 19:06:27 seth: once weremove generated files from repo and serve from netlify, we could start building ability to render directly from the json 19:06:54 james: timeline? 19:07:01 jongund has joined #aria-at 19:07:24 z: Can get CLI work done quickly 19:08:06 Part of this is changing directory structure for some of the files 19:08:53 We need an account with netlify; free service is single user 19:09:17 Think that we can use their OS project support policy. 19:09:30 seth: I'll kick that aspect off with netlify 19:09:58 z: Netlify also has a cli tool that lets us give it a directory 19:10:23 present+ jongund 19:11:01 james: as long as pr is free of generated resources, we are good. 19:11:17 seth: Yap, and this is top priority due to impact on your work. 19:11:43 TOPIC: Transition to Community Group Agenda 19:11:45 alflennik has joined #aria-at 19:11:58 scribe: s3ththompson 19:12:01 present+ 19:12:31 TOPIC: How should we manage ARIA-AT roles? 19:12:48 https://github.com/w3c/aria-at/issues/436 19:13:27 rrsagent, make minutes 19:13:27 I have made the request to generate https://www.w3.org/2021/05/20-aria-at-minutes.html Matt_King 19:13:30 james: currently, ARIA-AT App manages roles via GitHub teams under w3c org 19:14:59 james: due to how GitHub teams work, ppl need to be added to w3c org. there is a high overhead to adding testers to the w3c org 19:15:48 james: a few options from seth: 1) create GitHub org for aria-at? 2) create allowlist somewhere else? 3) keep roles under w3c teams, but only for admins 19:25:54 present+ 19:35:48 matt: can we keep admins on github w3c team and then add an in-app admin button to authenticate testers? 19:36:23 matt: we don't want to have a free-for-all of anyone submitting results 19:37:00 seth: in terms of lowering barriers to entry, is it really that bad if someone submits results that we later have to delte 19:37:32 james: it's noise that contributes to admin overhead. results take training to record correctly. even pilot test had lots of issues to work through and those contributors were trained and engaged 19:39:04 jes: from a bocoup perspective, we really want to make it easier for people outside this org to get involved. these seems like a crucial question as we talk about wanting greater community support for aria-at 19:40:07 matt: we're really quite committed to training tests and keeping that a careful, skilled process for only certain people. if we need to we can even hire and pay people to submit test results 19:40:37 matt: for short term, let's keep admin roles under w3c teams and add allowlist to repo 19:41:36 james: admins can add people or people can open their own pull request 19:41:46 seth: long term, might still consider in-app, better ux version 19:41:55 matt and james: probably not the highest priority right now 19:42:12 TOPIC: Compositional Test Writing 19:42:36 https://github.com/w3c/aria-at/issues/388 19:48:22 matt: can we start with a simple toolbar example? 19:48:54 james: what is the value of asking the tester to toggle a toggle button inside a toolbar? 19:50:05 matt: we wouldn't test the functionality of everything in the toolbar, just navigating into and out of a toolbar and navigating between elements within in 19:50:07 *it 19:50:44 james: so we could create a boilerplate that we modify for each element 19:51:11 matt: we do need to check if you're on a radio button inside a toolbar that it still tells you you're within a toolbar 19:51:24 jongund: the code for this hasn't been updated 19:51:56 james: jongund, if you have another example other than toolbar, how much code do you reuse for something like a radio button inside 19:52:40 jongund: we certainly borrowed code from other places to bring into the toolbar. i don't think it's a ton of work, but it's rearranging code, etc. there are probably other efficiencies to look at. is that a priority? 19:53:00 matt: another part of your answer, james is that we don't create dependencies between directories? 19:53:08 james: but for something like grid, there are shared resources 19:53:27 matt: oh yeah, there's an import from util in there. but we don't link between examples 19:56:16 matt: the things that we would *not* put in the apg b/c they're too basic, would be e.g. a toolbar with three buttons 19:57:05 matt: another example would be an oversimplified grid if we needed to test a 2x2 or 3x3 grid... or maybe that's not a great example since the apg already has some simple grids 19:58:43 james: for test plan, can we import the tests for grouping? so we would almost have checkbox and grouping separated... so that you could reuse some aspects of them 19:59:55 rrsagent, make minutes 19:59:55 I have made the request to generate https://www.w3.org/2021/05/20-aria-at-minutes.html Matt_King