– DRAFT –
ARIA Authoring Practices Task Force

<Rich_Noah> Alex Flenniken present+

Q3 milestones

<Jem> https://github.com/w3c/aria-practices/milestone/16

<Jem> two repo: content repo and build repo with jerkil library

<Jem> mck: the build is from WAI template repo, content is from APG repo

<Jem> "Work this quarter is primarily focused on resolving lingering issues related to the new WAI site launch and restructuring the repository content to match the new information architecture, retire respec, sunset the editor's draft, and streamline the build scripts."

<Jem> https://github.com/w3c/aria-practices/milestone/16

<Jem> mck: separate milestones for ARIA 1.3

<Jem> https://github.com/w3c/aria-practices/milestone/12

<Jem> only 5 issues for aria 1.3

<Jem> mck: I would like to figure out the alignment between aria 1.3 and new apg contents

<Jem> another topic is site design and build work

<Jem> https://github.com/w3c/wai-aria-practices/milestone/3

<Jem> https://github.com/w3c/wai-aria-practices/projects/3

<Jem> /github.com/w3c/wai-aria-practices/projects/3 / //github.com/w3c/wai-aria-practices/projects/3

<Jem> rich: working on resturcting the repo as main project

Netlify Previews of Pull Requests

<Jem> https://github.com/w3c/aria-practices/issues/2416

<Jem> rich:this is a product of the PR Preview Bot running. It overrides the Deploy Preview. We are not sure of the source but it does not run for all users. We have identified that the PR Preview Bot tends to run on PRs that you and Jon Gunderson create. Will have to investigate the source of the PR Preview Bot before determining a resolution.

Project to restructure repository and Sunset editors draft

<Jem> mck: The gola of restructuring repo is

<Jem> This project will sunset the respec document. It will create a content directory tree that reflects the web site structure and contains files with the content currently in the respec document. This will simplify content management and simplify maintenance of the build process.

<Jem> mck: gh branch will be deleted.

<Jem> https://github.com/w3c/aria-practices/projects/42

<Jem> Part 1: Reorganize patterns and examples to reflect site architecture · Issue #2418 · w3c/aria-practices

<Jem> Draft PR for Part 1: Create a patterns directory tree with a separate file for each pattern and move all examples inside the patterns directory tree by mcking65 · Pull Request #2417 · w3c/aria-practices

<Jem> https://github.com/w3c/aria-practices/projects/42

<Matt_King> https://github.com/w3c/aria-practices/projects/42

<Jem> Mck: I would like to discuss impact and how to divide up the work.

<Jem> jemma: this is important work so that even new comer in WG can under what is going on as well as it can be easily maintainable.

<Jem> https://github.com/w3c/aria-practices/pull/2417

<Jem> mck:Directory Structure

<Jem> "content" directory at root level: This will hold all content in a tree that matches the IA of the web site. It has subdirectories for:

<Jem> patterns

<Jem> index

<Jem> shared (for js, css, scripts that need to be referenced by multiple resources. Did not name "common" because we have not yet eliminated aria-common)

<Jem> howard: it sounds good to me.

<Jem> https://www.irccloud.com/pastebin/QsDIFIsu/

<Jem> There will be a directory for each pattern that contains:

<Jem> A file for the pattern, e.g., "Pattern-accordion.html". Originally considered naming "index.html" but decided a more specific file name could avoid confusion with some file operations. Also, this is how the jekyl files are named, so hoping that simplifies the build script.

<Jem> An examples directory for the examples.

<Jem> howard: descriptive file name is preferred.

<Jem> jemma: pattern-accordion.html under pattern folder may be a bit verbose.

<Jem> mck: do we want to script to do update #5: Edit example html files to fix references?

<Jem> howard: I would recommend not to use the script.

<Jem> mck: I will write the instruction how to update reference.

<Jem> Jemma: I will do the work.

<Jem> #5

<Jem> mck: #6 will be for Alex -Reconfigure regression tests to run test against examples in new location (regression-tests.sh)

<Jem> mck: #7 trivial script can be reviewed by Alex.

<Jem> mck: #7 would invovle updating coverage report

<Jem> #6-#11 will be done by Alex.

<Jem> the group continued to dicuss issue 2418.

<Jem> The group will meet again and discuss the project sizing and time frame.

<Jem> s/Topic: https://github.com/w3c/wai-aria-practices/projects/3 / APG content work/