Skip to content
This repository has been archived by the owner on Dec 4, 2017. It is now read-only.

docs(cb-a11y): add accessibility (a11y) cookbook #1625

Open
wants to merge 6 commits into
base: master
Choose a base branch
from

Conversation

AlmeroSteyn
Copy link
Contributor

READY FOR REVIEW

Current and up to date PR for the a11y cookbook.

Also contains copy-edits from @naomiblack from #1181 .

Both #1049 and #1181 are now outdated in terms of content and should be closed, but conserved for comments therein.

Similarly, we need to provide quick in-page links to help users who rely on assistive
technology to navigate our page.

These are called `skiplinks` and remain completely hidden until focused through `keyboard navigation`.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm noting this here but it's more of a general question - are the code backticks appropriate for calling out technical terms or should some of these really be ems?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These do provide a particular emphasis highlight that is used a lot inside the docs.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Right, but typically the code backticks are for actual snippets of code or commands - variable names, hex values, CLI commands, that sort of thing. Whereas technical terms get the em treatment.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed. However that is more an A2 doc wide discussion so will align this one to the styles of the other docs for now.

@Foxandxss Foxandxss changed the title docs(cb-a11y): add accessibility (a11y) cookbook [Ready for review] docs(cb-a11y): add accessibility (a11y) cookbook Jun 9, 2016
@AlmeroSteyn AlmeroSteyn force-pushed the cb-a11y-dt branch 3 times, most recently from 99d1ced to 8b74462 Compare July 1, 2016 07:55
@AlmeroSteyn AlmeroSteyn force-pushed the cb-a11y-dt branch 2 times, most recently from f484de2 to 603a407 Compare July 18, 2016 14:28
@chalin
Copy link
Contributor

chalin commented Oct 26, 2016

@AlmeroSteyn - e2e tests are failing because the ts compiler is reporting errors. Can you investigate and fix the issues?

cc @naomiblack @wardbell

@chalin
Copy link
Contributor

chalin commented Oct 26, 2016

All: @AlmeroSteyn isn't currently available. As agreed discussed with @wardbell via slack: @Foxandxss or @filipesilva could you look into upgrading the code from use of ng beta/rc to 2.1.x?

@googlebot
Copy link

We found a Contributor License Agreement for you (the sender of this pull request) and all commit authors, but as best as we can tell these commits were authored by someone else. If that's the case, please add them to this pull request and have them confirm that they're okay with these commits being contributed to Google. If we're mistaken and you did author these commits, just reply here to confirm.

@googlebot
Copy link

We found a Contributor License Agreement for you (the sender of this pull request) and all commit authors, but as best as we can tell these commits were authored by someone else. If that's the case, please add them to this pull request and have them confirm that they're okay with these commits being contributed to Google. If we're mistaken and you did author these commits, just reply here to confirm.

1 similar comment
@googlebot
Copy link

We found a Contributor License Agreement for you (the sender of this pull request) and all commit authors, but as best as we can tell these commits were authored by someone else. If that's the case, please add them to this pull request and have them confirm that they're okay with these commits being contributed to Google. If we're mistaken and you did author these commits, just reply here to confirm.

@niceredfrog
Copy link

I authored the most recent commit. I'm replying to confirm.

@marcysutton
Copy link

What do we need to do to get this up to date and merged?

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

7 participants