19:02:52 RRSAgent has joined #aria-apg 19:02:52 logging to https://www.w3.org/2021/12/07-aria-apg-irc 19:02:54 RRSAgent, make logs Public 19:02:55 please title this meeting ("meeting: ..."), Jemma 19:03:06 title:ARIA-APG 19:03:09 Rich_Noah has joined #aria-apg 19:03:32 rrsagent, make minutes 19:03:33 I have made the request to generate https://www.w3.org/2021/12/07-aria-apg-minutes.html Jemma 19:03:37 present+ 19:04:13 agenda+ setup and review agenda 19:04:15 present+ erika 19:04:24 agenda+ apg redesign project 19:04:28 present+ alex 19:05:36 introduction to new members 19:09:18 scribe: Mark 19:09:23 agenda? 19:09:31 Matt_King has joined #aria-apg 19:09:35 zakim, clear agenda 19:09:35 agenda cleared 19:09:38 howard_edwards has joined #aria-apg 19:09:39 agenda? 19:09:40 present+ 19:09:41 MarkMcCarthy has joined #aria-apg 19:09:44 present+ 19:09:47 scribe: MarkMcCarthy 19:09:55 agenda+ new apg home page design 19:10:04 zakim, next item 19:10:04 agendum 1 -- new apg home page design -- taken up [from Jemma] 19:10:07 http://wai-aria-practices.s3-website-us-east-1.amazonaws.com/ 19:10:42 CurtBellew has joined #aria-apg 19:10:50 Matt_King: [describing the layout of the redesign wireframe] 19:10:53 agenda+ Content strategy and Content Planning 19:11:00 Matt_King: we haven't spent a lot of time discussing what'll be on the homepage yet 19:11:02 agenda+ Repo Migration - technical discussion 19:11:31 Matt_King: current homepage has the intro and readme sections right now, back matter is on an about page right now 19:11:38 present+ 19:12:22 Matt_King: i expect jongunderson MarkMcCarthy and Jemma to have some opinions about what that page should look like 19:12:31 Rich_Noah: we should have some more news in early january 19:12:50 Matt_King: let's just talk about what we think the goals of the homepage should be for now 19:13:35 http://wai-aria-practices.s3-website-us-east-1.amazonaws.com/ 19:14:08 jamesn: on a developer-sized screen, I'd like no more than one page of text and all the things you need available 19:14:13 jamesn: in other words, no wall of text 19:14:14 Matt_King: +1 19:14:28 MarkMcCarthy: +1 19:15:07 jongunderson: maybe we could make the principles like disclosures - everything could be there but hidden if need be 19:15:40 Matt_King: i was wondering that, if the goal is closer to what james is saying - it points you to info but the homepage doesn't convey mucuh 19:15:55 Matt_King: maybe if it should guide someone unfamiliar with the APG rather than someone who IS familiar 19:16:38 MarkMcCarthy: I think that's a good idea 19:17:13 Jemma: a comment on github says the current homepage is a little heavy; it might be nice to have some history and/or promote other relevant content 19:17:19 Jemma: some feedback from the study 19:17:47 Matt_King: i'm not sure background info _has_ to be on the homepage 19:18:37 Matt_King: maybe we take what's currently in the readme and turn it into a fundamentals page 19:19:28 Jemma: when i mentioned "history" earlier - I think to clarify I meant they were explaining how APG is related to ARIA 19:19:41 Jemma: in other words, providing more orienteering context 19:20:42 Matt_King: primary purpose is how to orient new users, then? 19:20:44 Jemma: yes 19:20:45 jamesn: yep 19:20:48 MarkMcCarthy: right 19:21:19 jamesn: those who know what they're looking for will probably come from Google results etc., so they'll end up where they need and have no need for the homepage 19:21:43 jamesn: we also need to make sure that there's nothing that exists ONLY on the homepage (besides friendly fluff) 19:22:36 jamesn: fluff might be, what does ReactJS, Ember, etc. etc. have on their homepage to entice people to dig deeper? like basics "why do you want to read this?" stuff 19:22:48 jongunderson: i agree! less is more, and help people find what they need 19:23:40 agenda? 19:24:14 Matt_King: this should be enough so once Issac comes back to it, he should have enough to go on and some simple objectives 19:24:55 Matt_King: I really likes jamesn's statement - make it something simple, welcoming, and pushing people to what they need 19:25:17 Matt_King: editorially, we'll need to make some decisions. but I don't think Issac will need much other support 19:26:07 Matt_King: maybe a most visited card or page would be good? 19:26:16 Jemma: a rotating set of popular articles/pages might be helpful 19:26:58 jongunderson: making sure it's welcoming and useful for those new or practicing, with easy-to-use and easy-to-find information and indicies, is best I think 19:27:24 jongunderson: if anything, maybe a "Help Wanted" - things where we need hands, annoucnements for new examples that need comments, tc. 19:27:33 s/annoucnements /announcements 19:27:36 s/tc./etc. 19:28:07 Matt_King: that makes me wonder too... for the new person, it seems we don't have a "Getting Started" page or content anywhere. would that have value? 19:28:59 jamesn: we used to have the ARIA Primer, but that's been largely absorbed and punted. it'd need lots of TLC 19:29:25 jamesn: honestly though, lots of 3rd-party stuff is better 19:29:58 Matt_King: reminds me of how it was in 2014 - APG pointed everywhere! [laughs] 19:30:14 https://developers.google.com/web/fundamentals/accessibility/semantics-aria/ 19:30:42 Matt_King: i think that if we believe someone's content is important and useful, let's get their permission to cite/reuse it, or maybe change things a bit to fit editorial tone. or even invite them to write a page/article for APG 19:31:42 jamesn: That Google link I like, it explains in ways people can understand, isn't TOO overwhelming, gives people a gentle on-ramp, etc. 19:32:11 Matt_King: I'm not sure if anyone's seen the trailer we made for ARIA-AT, but I'm really proud of it. Maybe we could make something similar for APG? 19:32:33 jamesn: Sounds like an awesome project for someone to take - has upsides and downsides, but sounds awesome 19:33:05 I would also strongly support promotional/informational video like that of aria-at 19:33:43 +1 - that'd be hugely engaging for presentations too, rather than SMEs droning on about specs 19:33:57 s/presentations/presentations, seminars, etc. 19:34:07 zakim, next item 19:34:07 agendum 2 -- Content strategy and Content Planning -- taken up [from Jemma] 19:35:01 Jemma: where are we with content inventory? 19:35:53 content priority discussion 19:36:22 Matt_King: we have a whole bunch related to content quality, new patterns that have been suggested or needing to be done... one other major priority I'm forgetting. 19:36:52 Matt_King: we talked recently about how we're making decisions related to content and planning, and prioritizing resources -- do we want to change how we're doing that? 19:37:11 Matt_King: to many of us, it probably feels a little reactive and chaotic sometimes. is that fair to say? 19:37:19 [general agreement] 19:37:55 jongunderson: if we could get more organized and better plans for upgrades or future work, that'd be good. i basically just started upgrading things I Worked on and care about, but many others that probably need it 19:38:02 jongunderson: such as our Tabs example 19:39:20 Matt_King: i think we have a project board where we made a card for every example. wondering if it'd be good to do an audit where we moved examples around priority buckets of some kind, for quality checks 19:40:01 jongunderson: the coverage report would tell us things like JS prototype or keycode implementations; also could tell us examples that don' thave a11y sections or HCM documentation 19:40:26 jongunderson: so coding practices, a11y features, HCM support -- those are at least 3 areas we'd want to make sure are included in every example 19:40:40 jongunderson: and dubious practices [laughs] 19:41:14 s/and dubious/and lack of dubious 19:41:24 Matt_King: like the Tab example 19:41:28 jongunderson: --tab example, right 19:42:14 Jemma: hearing we're talking about coverage of content, such as HCM documentation coverage; also hearing that we'll need to work on prioritizing content. right? 19:42:35 Jemma: what should our action for this be? 19:43:48 Matt_King: it seems to me that we need an approach that respects people's passions, and also a process to plan as a group (maybe Jemma and I can do that as editors, but that doesn't feel great to me). 19:44:27 Matt_King: if people have input for Jemma and I please send it! I'll think about this a lot more over the break, I want to grow the group, its capabilities, and people's passions. Especially since we'll have a new platform soon. 19:44:39 zakim, next item 19:44:39 agendum 3 -- Repo Migration - technical discussion -- taken up [from Jemma] 19:45:06 Jemma: so basically, what do we need to do? 19:45:39 Matt_King: we have some high-level repo decisions to make, Rich, Alex? Over the next couple weeks, we want to have the ability to land something in main and end up on an editor/preview site 19:45:58 Rich_Noah: seth can share some more, but work is underway to figure out the best way to set us up for success 19:46:35 Seth: the first thing I Wanted to share is that the site redesign been oriented towards putting the examples under the broader WAI website 19:46:54 Seth: so we're drawing on E&O's template for the WAI website 19:47:31 https://github.com/w3c/apg-redesign 19:47:51 Seth: Basically, that looks like one website with the content of the project (so the aria-practices repo of today), and a separate repo that handles the presentation of all that content and how it's formatted for this particular output 19:48:53 Seth: we're proposing that these two repos would be codified and connected, so when a PR is made on the aria-practices repo, it'd generate a preview on the APG website via Netlify or something similar 19:49:01 Jemma: we don't have a URL in the repo yet, right? 19:49:10 https://github.com/bocoup/wai-aria-practices 19:50:09 Seth: if you go to the above link, this is what we're proposing to be the secondary repo controlling the presentation of content (and follows other sites on WAI's site) 19:50:39 Seth: Idea is to move FROM the Bocoup repo TO the W3C umbrella 19:51:30 Seth: This would be accompanied by revising contributing guidelines, since that'll change, and it'll supercede what already exists on the editor's note 19:52:30 Matt_King: currently out main doc is aria-practices.html in the root of the repo. what's the roadmap for changing that document into this new thing? directories etc? What do we have to do to restructure the current repo to support the new presentation/contribution/build process? 19:52:59 Seth: first - everything I said is incremental. we're connecting the pipeline so all new contributions automatically generate a new preview and all 19:53:35 Seth: Once we freeze the current editor's note, we can make changes on the aria-practices side which would otherwise break the editor's note. 19:53:50 Seth: that'd be working in tandem with the TF to sort out the best way to do that 19:54:40 Matt_King: we don't want to freeze the gh-pages branch prematurely, so it'd be good to have a full roadmap of all the non-breaking changes we can make before we get to the break point 19:55:02 Matt_King: the Editor's Draft looks pretty good right now, truthfully, but if we could add anything else that'd be good. 19:55:26 > Content: 19:55:37 https://wai-website-theme.netlify.app/technical/files/#source-file-structure 19:55:53 Seth: the new redesign was built in a way that doesn't require breaking changes. we did that with custom transforms which would translate the respec docs, but that's not ideal for long-term. 19:56:22 Seth: There's not a need to make a breaking change in the upstream repo to faciliatate anything _right now_ 19:57:17 Jemma: Why do we have to transform the structure again? I lost the thread somewhere 19:57:35 Seth: the current document is one long respec file -- 19:57:36 Jemma: gotcha 19:58:17 Seth: -- that _could_ work, but it's easier to track changes, associate styles, etc. if we break things out a bit. and an easier format for a contributor to add things 19:58:22 Jemma: that makes sense 19:59:06 Matt_King: we have some constraints imposed by respec, like linking from the example page to the keyboard section, or back to roles/states/properties etc. 19:59:42 Seth: I think that we're still working on getting the pipeline connected such that it'll build the new site but not break APG in the short term 20:00:33 Seth: considering what the best way forward is, Matt_King, we'd like to make some technical recommendations. there's probably some contributing and editorial considerations too; what you'd like to express, what alternate formats may or may not allow. et 20:00:36 s/et 20:00:53 Seth: maybe the TF can start thinking about those latter things for now 20:01:20 Matt_King: respec _does_ have some things that make writing things pretty easy, some features are good! the contraints are particular problematic though 20:01:59 jamesn: some of those are the ARIA implementation on top of respec, the scripting could be changed to alleviate some of the current constraints too. we just need someone who knows the code (which unfortunately isn't too many people) 20:02:22 jamesn: it's very much an oral tradition for folks that know how to use it 20:02:32 Matt_King: I'm hopeful Erika and Alex could help 20:03:13 Matt_King: maybe we should create an issue or something for our wishlist, then you can take that, Seth, into your technical recommendations 20:03:18 Seth: Sounds good to me 20:03:21 erika: +1 20:03:35 Matt_King: [rattling off most wanted wish list items] 20:04:23 Matt_King: Next steps - Seth, would we be in a position a week from today to hear some technical proposals? 20:04:41 Seth: we'd be in a better place but I can't speak for the team. certainly we could pick up from here at _least_ 20:04:48 Matt_King: let's plan on that. i'll ping you Seth 20:04:54 zakim, who is here? 20:04:54 Present: Matt_King, MarkMcCarthy, jemma, siri, sarah, curt, CurtBellew, Rich_Noah, erika, alex, howard_edwards 20:04:56 On IRC I see CurtBellew, MarkMcCarthy, howard_edwards, Matt_King, Rich_Noah, RRSAgent, jongunderson, erika, Jemma, MichaelC, jamesn, github-bot, Zakim, ZoeBijl, trackbot 20:05:11 present- curt 20:05:16 RRSAgent, make minutes 20:05:16 I have made the request to generate https://www.w3.org/2021/12/07-aria-apg-minutes.html MarkMcCarthy 20:05:57 Thanks Mark for scribing 21:07:37 Matt_King has left #aria-apg