Accessibility 2020

[foxdavidj]

Part II Chapter 8: Accessibility

Content team

Authors	Reviewers	Analysts	Draft	Queries	Results
@oluoluoxenfree @alextait1	@aardrian @ericwbailey @OBTo	@OBTo	Doc	*.sql	Sheet

Content team lead: @oluoluoxenfree

Welcome chapter contributors! You'll be using this issue throughout the chapter lifecycle to coordinate on the content planning, analysis, and writing stages.

The content team is made up of the following contributors:

• Authors
• Reviewers
• Analysts

New contributors: If you're interested in joining the content team for this chapter, just leave a comment below and the content team lead will loop you in.

Note: To ensure that you get notifications when tagged, you must be "watching" this repository.

Milestones

0. Form the content team

• Jul 6th: Project owners have selected an author to be the content team lead
• Jul 13th: The content team has at least one author, reviewer, and analyst (minimally viable team formed)

1. Plan content

• Jul 20th: The content team has completed the chapter outline in the draft doc
• Jul 27th: Analysts have triaged the feasibility of all proposed metrics

2. Gather data

• Jul 27th: Analysts have added all necessary custom metrics and drafted a PR to track query progress

• Aug 1 - 31: August crawl

• Sep 7th: Analysts have queried all metrics and saved the output to the results sheet

3. Validate results

• Sep 14th: The content team has reviewed the results sheet

4. Draft content

• Nov 12th: Authors have completed the first draft in the doc
• Nov 26th: The content team has prototyped all data visualizations

5. Publication

• Nov 26th: The content team has reviewed the final draft, converted to markdown, and filed a PR to add it to the 2020 content directory

• Dec 9th: Target launch date

[foxdavidj]

Would love to hear from and nominate @WilcoFiers.

We make extensive use of axe in our data collection and I'd be excited to read from an author who is not just an expert in A11Y, but one who has an intense understanding of all the data we're collecting.

[rviscomi]

@oluoluoxenfree thank you for agreeing to be the lead author for the Accessibility chapter! As the lead, you'll be responsible for driving the content planning and writing phases in collaboration with your content team, which will consist of yourself as lead, any coauthors you choose as needed, peer reviewers, and data analysts.

The immediate next steps for this chapter are:

1. Establish the rest of your content team. Several other people were interested or nominated (see below), so that's a great place to start. The larger the scope of the chapter, the more people you'll want to have on board.
2. Start sketching out ideas in your draft doc.
3. Catch up on last year's chapter and the project methodology to get a sense for what's possible.

There's a ton of info in the top comment, so check that out and feel free to ping myself or @OBTo with any questions!

To everyone else who has been nominated:

@aardrian
@ericwbailey
@scottaohara
@segunolalive
@bamadesigner
@rianrietveld
@SaraSoueidan
@stevefaulkner
@WilcoFiers
@scroniser

we'd still love to have you contribute as a peer reviewer or coauthor as needed. Let us know if you're still interested!

[aardrian]

Happy to take a look if you need on the technical bits, but again, as an annoying white guy I will defer to people who would bring more lived experience outside my own.

[ericwbailey]

Similar sentiments to @aardrian. Happy to pitch in on reviewing if needed, but I want to make sure people self-identified as Disabled are represented.

[rviscomi]

Thanks @aardrian @ericwbailey. I'll put you both down as reviewers for now and we can adjust as needed.

[foxdavidj]

Happy to be a reviewer and analyst this year. Was the author and analyst for last year's chapter, so if you have any questions at all I'd be more than happy to help :)

[foxdavidj]

Hey @oluoluoxenfree, just checking in:

1. How is the the chapter coming along? We're tying to have the outline and metrics settled on by the end of the week so we have time to configure the Web Crawler to track everything you need.
2. Can you remind your team to properly add and credit themselves in your chapter's Google Doc?
3. Anything you need from me to keep things moving forward?

[tunetheweb]

Hello @oluoluoxenfree | @aardrian @ericwbailey @OBTo ! Could I ask for some of your accessibility expertise on #892 ? We're wondering if the focus ring is needed on our site when the focus state changes the colour anyway? This is in particular for the header items and buttons - and in particular for the language and year selector where the focus ring shows even on mouse usage. Have a read of the issue if you don't mind and let us know your thoughts on it in there.

[foxdavidj]

@oluoluoxenfree How is the outline coming along? We want to have that wrapped up by the end of the week so we have time to set up our Web Crawler :)

[oluoluoxenfree]

I'm going to hopefully have a draft for you tonight; sorry I didn't keep better track of it!

…

On Thu, 16 Jul 2020, 4:48 pm David Fox, ***@***.***> wrote: @oluoluoxenfree <https://github.com/oluoluoxenfree> How is the outline coming along? We want to have that wrapped up by the end of the week so we have time to set up our Web Crawler :) — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#907 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAXPKQYVA3MOG7LTEM7B4J3R34OMDANCNFSM4OJ2CRJA> .

[rockeynebhwani]

@oluoluoxenfree / @rviscomi - I think it will be interesting to look at adoption of solutions like EqualWeb and few others (UserWay, Silktide, browsealoud, Recite me, Essential Accessibility. Enable, uRemediate, Adally.). These solutions provide a lazy solution for sites to become accessible and get compliance level.

Example of EqualWeb on https://www.hobbs.com/

I don't see any category in Wappalyzer to detect this but detection for technologies like these should be straightfoward.

[rockeynebhwani]

Create an issue for Wappalyzer to detect this. https://github.com/AliasIO/wappalyzer/issues/3228

[rviscomi]

Interesting idea! Hope we can get the detections in place for August.

[rockeynebhwani]

@rviscomi - I have completed pattern detection for all major providers in https://github.com/AliasIO/wappalyzer/issues/3228 but I think I have too many Wappalyzer feature requests now and I can't do all these PRs alone. Anybody who can help?

[rviscomi]

Before we invest in the detections we should wait for @oluoluoxenfree to write the outline and set the scope of the chapter. If this is out of scope we don't need to hurry to get the detections in. Also, many of the detections are based on the presence of a specific URL, which we could easily check by looking at the network log if needed.

[ericwbailey]

Chiming in to say that if those overlay services are quantified that there should be a heavily editorial presence accompanying them, in that most of these services actually negatively affect a page's accessibility. In fact, a few of the more popular ones are currently getting sued because of this act.

My perspective is it'd be irresponsible to make readers of the report aware of these services without providing this information. I'd also say it should be presented alongside the findings, and not as a footnote or an aside.

[alextait1]

@OBTo thanks for the update and the very much appreciated extension, I myself have been swamped! @oluoluoxenfree and I will get moving on this :)

[oluoluoxenfree]

@OBTo @rviscomi would it be possible to get an extension till Monday and a quick walkthrough of the data?

thanks for your patience!

[rviscomi]

@oluoluoxenfree sure, moving the first draft due date to Monday won't be an issue. Thanks for checking in and hope all is well.

I'll defer to @OBTo to help get you up to speed on the results.

[foxdavidj]

@oluoluoxenfree Sure can. I'm available 1130a to 1230p (CT) tomorrow, and 11a to 1230p (CT) Friday

[alextait1]

@OBTo & @oluoluoxenfree I can do either of those times tomorrow, Friday would be harder but maybe possible

[foxdavidj]

@alextait1 @oluoluoxenfree Sent a calendar invite for tomorrow :)

[rviscomi]

@aardrian I don't have your email address, so can you request edit access in the doc so you can review and leave your feedback? We're hoping to get the draft finalized this week.

[aardrian]

@rviscomi Spent the week mostly offline for the holiday. Got your email, have opened doc to review.

[rviscomi]

@aardrian great, thanks! Hope you don't mind me snooping around for your email address :)
And hope you had a nice holiday.

[aardrian]

@rviscomi Do not mind at all; glad you did, in fact, since it was the Docs notification that I saw (not GH).

Anyway, I left comments. I hope I did what you needed/expected.

[rviscomi]

Yes, thanks for the thorough review it looks great! Between all of the reviewers it looks really solid.

[rviscomi]

@oluoluoxenfree @alextait1 please have your markdown submitted by EOD today to be included in Wednesday's launch.

[oluoluoxenfree]

@rviscomi where do I submit the markdown?

[rviscomi]

We have a markdown file stubbed out for you with TODOs at src/content/en/2020/accessibility.md.

In addition to the contents of the chapter, please also update the lists of authors, reviewers, and analysts to reflect all of the actual contributors and roughly in order of most contributions first as a courtesy. There are also TODOs for authors' bios (shown at the end of the chapter) and featured quote/stats, which are shown randomly on the home page to attract new readers.

You can also refer to the 2019/accessibility.md file and Author's Guide wiki if needed.

[oluoluoxenfree]

thanks so much!

…

On Mon, 7 Dec 2020, 7:35 pm Rick Viscomi, ***@***.***> wrote: We have a markdown file stubbed out for you with TODOs at src/content/en/2020/accessibility.md <https://github.com/HTTPArchive/almanac.httparchive.org/blob/main/src/content/en/2020/accessibility.md> . In addition to the contents of the chapter, please also update the lists of authors, reviewers, and analysts to reflect all of the actual contributors and roughly in order of most contributions first as a courtesy. There are also TODOs for authors' bios (shown at the end of the chapter) and featured quote/stats, which are shown randomly on the home page to attract new readers. You can also refer to the 2019/accessibility.md <https://raw.githubusercontent.com/HTTPArchive/almanac.httparchive.org/main/src/content/en/2019/accessibility.md> file and Author's Guide wiki <https://github.com/HTTPArchive/almanac.httparchive.org/wiki/Authors'-Guide#metadata-to-add-at-the-top-of-your-chapters> if needed. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#907 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAXPKQ5MILLV6I2BHMNGWY3STUU67ANCNFSM4OJ2CRJA> .

[oluoluoxenfree]

@rviscomi what timezone are you in? Trying to work out if I have enough time to finish

[rviscomi]

@oluoluoxenfree I'm in New York but any time tonight would be best, I'll be working late anyway. Thank you for your help getting this published. 🙏

[oluoluoxenfree]

@rviscomi I'm flagging as it's 1am here, very sorry I haven't completely finished, was hoping to but it's a lot of graphs!! I will finish putting graphs in tomorrow, sorry again

[rviscomi]

No problem, if we can get this finished tomorrow there will still be time before launch. I really appreciate your hard work on this!